Method getStepInTargets

src/adapter/threads.ts:823–915

* Implements DAP `stepInTargets` request. * * @todo location information is patched in until ratification of * https://github.com/microsoft/debug-adapter-protocol/issues/274

(frameId: number)

   * https://github.com/microsoft/debug-adapter-protocol/issues/274
   */
  public async getStepInTargets(frameId: number): Promise<
    (Dap.StepInTarget & {
      line?: number;
      column?: number;
      endLine?: number;
      endColumn?: number;
    })[]
  > {
    const pausedDetails = this._pausedDetails;
    if (!pausedDetails) {
      return [];
    }

    const frame = pausedDetails.stackTrace.frames.find(f => f.frameId === frameId);
    if (!(frame instanceof StackFrame)) {
      return [];
    }

    const pausedLocation = await frame.uiLocation();
    if (!pausedLocation) {
      return [];
    }

    const rawPausedLocation = pausedDetails.event.callFrames[0].location;
    const [locations, content] = await Promise.all([
      this._breakpointManager
        .getBreakpointLocations(
          this,
          pausedLocation.source,
          new Base1Position(pausedLocation.lineNumber, 1),
          new Base1Position(pausedLocation.lineNumber + 1, 1),
        )
        .then(l =>
          // remove the currently-paused location
          l.filter(
            l =>
              l.breakLocation.lineNumber !== rawPausedLocation.lineNumber
              || l.breakLocation.columnNumber !== rawPausedLocation.columnNumber,
          )
        ),
      pausedLocation.source.content(),
    ]);

    // V8's breakpoint locations are placed directly before the function to
    // be called, which is perfect, e.g `this.*greet()`. However, once mapped,
    // many tools will make the entire `this.greet(` a single range, which
    // means default behavior of reading the next word will not give a good
    // location. Instead, look over the source content manually to build ranges.

    const idStart = pausedDetails.stepInTargets?.length || 0;
    pausedDetails.stepInTargets = pausedDetails.stepInTargets?.concat(locations) || locations;

    const lines = content && new PositionToOffset(content);

    return locations
      .map((location, i) => {
        const preferred = location.uiLocations.find(l => l.source === pausedLocation.source);
        if (!preferred) {