Interface ITarget

src/targets/targets.ts:22–87

 * actually get a debug adapter API.
 */
export interface ITarget {
  /**
   * Launch configuration for the target. This is used to inject into the IOC
   * in cases where a target's configuration is different than its parent's
   * (e.g. webview debugging in the extension host).
   */
  readonly launchConfig: AnyLaunchConfiguration;

  /**
   * Launcher's target info.
   */
  readonly targetInfo: Readonly<Cdp.Target.TargetInfo>;

  /**
   * Additional launch config information that should be passed into the
   * child debug session's configuration.
   */
  readonly supplementalConfig?: Record<string, unknown>;

  /**
   * Whether the lifecycle for this target can be stopped, restarted, etc.
   * independently of its parents.
   */
  readonly independentLifeycle?: boolean;

  /**
   * Source path resolver, if a custom one should be used for this target.
   */
  readonly sourcePathResolver?: ISourcePathResolver;

  id(): string;
  name(): string;
  onNameChanged: IEvent<void>;
  fileName(): string | undefined;
  type(): string;
  parent(): ITarget | undefined;
  canStop(): boolean;
  stop(): void;
  canRestart(): boolean;
  restart(): void;
  canAttach(): boolean;
  attach(): Promise<Cdp.Api | undefined>;
  canDetach(): boolean;
  detach(): Promise<void>;
  targetOrigin(): ITargetOrigin;
  /**
   * Lifecycle callback invoked after attaching and the target's events are
   * wired into the debug adapter.
   */
  afterBind(): Promise<void>;

  /**
   * Called after the launchBlocker resolves. Signals that we're all set up
   * and ready to start debugging the target.
   */
  runIfWaitingForDebugger(): Promise<void>;

  initialize(): Promise<void>;