Class Source

valdi/vscode_debugger/src/adapter/sources.ts:105–369

//    source1._compiledToSourceUrl.get(compiled1) === sourceUrl
//
export class Source {
  private readonly _sourceReference: number;
  private readonly _name: string;
  private readonly _fqname: string;

  /**
   * Function to retrieve the content of the source.
   */
  private readonly _contentGetter: ContentGetter;

  private readonly _container: SourceContainer;

  // Url has been mapped to some absolute path.
  private readonly _absolutePath: string;

  public sourceMap?: ISourceWithMap['sourceMap'];

  // This is the same as |_absolutePath|, but additionally checks that file exists to
  // avoid errors when page refers to non-existing paths/urls.
  private readonly _existingAbsolutePath: Promise<string | undefined>;
  private readonly _scriptIds: Cdp.Runtime.ScriptId[] = [];

  /**
   * @param inlineScriptOffset Offset of the start location of the script in
   * its source file. This is used on scripts in HTML pages, where the script
   * is nested in the content.
   * @param contentHash Optional hash of the file contents. This is used to
   * check whether the script we get is the same one as what's on disk. This
   * can be used to detect in-place transpilation.
   */
  constructor(
    container: SourceContainer,
    public readonly url: string,
    absolutePath: string | undefined,
    contentGetter: ContentGetter,
    sourceMapUrl?: string,
    public readonly inlineScriptOffset?: InlineScriptOffset,
    contentHash?: string,
  ) {
    this._sourceReference = container.getSourceReference(url);
    this._contentGetter = once(contentGetter);
    this._container = container;
    this._absolutePath = absolutePath || '';
    this._fqname = this._fullyQualifiedName();
    this._name = this._humanName();
    this.setSourceMapUrl(sourceMapUrl);

    this._existingAbsolutePath = sourceUtils.checkContentHash(
      this._absolutePath,
      // Inline scripts will never match content of the html file. We skip the content check.
      inlineScriptOffset ? undefined : contentHash,
      container._fileContentOverridesForTest.get(this._absolutePath),
    );
  }

  private setSourceMapUrl(sourceMapUrl?: string) {
    if (!sourceMapUrl) {
      this.sourceMap = undefined;