Method getOrLaunchSession

src/sessionManager.ts:211–253

* Creates a debug session for the given target.

(target: ITarget)

   * Creates a debug session for the given target.
   */
  public getOrLaunchSession(target: ITarget): Promise<Session<TSessionImpl>> {
    const existingSession = this._sessionForTarget.get(target);
    if (existingSession) {
      return existingSession;
    }

    const newSession = new Promise<Session<TSessionImpl>>(async (fulfill, reject) => {
      let parentSession: Session<TSessionImpl> | undefined;
      const parentTarget = target.parent();
      if (parentTarget) {
        parentSession = await this.getOrLaunchSession(parentTarget);
      } else {
        parentSession = this._sessions.get(target.targetOrigin().id);
      }

      if (!parentSession) {
        throw new Error('Expected to get a parent debug session for target');
      }

      this._pendingTarget.set(target.id(), { target, parent: parentSession });
      this._sessionForTargetCallbacks.set(target, { fulfill, reject });

      const parentConfig = parentSession.debugSession.configuration as IMandatedConfiguration;
      const config: IPseudoAttachConfiguration = {
        // see https://github.com/microsoft/vscode/issues/98993
        type: parentConfig.type === DebugType.ExtensionHost
          ? DebugType.Chrome
          : (parentConfig.type as DebugType),
        name: target.name(),
        request: parentSession.debugSession.configuration.request as 'attach' | 'launch',
        __pendingTargetId: target.id(),
        internalConsoleOptions: parentConfig.internalConsoleOptions,
        // fix for https://github.com/microsoft/vscode/issues/102296
        preRestartTask: parentConfig.preRestartTask ?? parentConfig.postDebugTask,
        postRestartTask: parentConfig.postRestartTask ?? parentConfig.preLaunchTask,
      };

      this.sessionLauncher.launch(parentSession, target, config);
    });

    this._sessionForTarget.set(target, newSession);
    return newSession;
  }

  /**
   * @inheritdoc