RPP: More comments around url/sourceURL

Bug: none
Change-Id: I57aaba5299fa2a24cd64d17d9fadb8a96d74873e
Reviewed-on: https://chromium-review.googlesource.com/c/devtools/devtools-frontend/+/6920465
Commit-Queue: Paul Irish <[email protected]>
Reviewed-by: Connor Clark <[email protected]>
Auto-Submit: Paul Irish <[email protected]>

Author: paulirish

front_end/core/sdk/RehydratingObject.ts

@@ -9,6 +9,7 @@ import type {SourceMapV3} from './SourceMap.js';
 export interface RehydratingScript {
   scriptId: Protocol.Runtime.ScriptId;
   isolate: string;
+  /** The script's `src` */
   url: string;
   executionContextId: Protocol.Runtime.ExecutionContextId;
   startLine: number;
@@ -19,6 +20,7 @@ export interface RehydratingScript {
   isModule?: boolean;
   hasSourceURL?: boolean;
   sourceMapURL?: string;
+  /** The manually provided string via the `//# sourceURL` directive */
   sourceURL?: string;
   length?: number;
   sourceText?: string;

front_end/core/sdk/Script.ts

@@ -68,6 +68,10 @@ let scriptCacheInstance: {
 export class Script implements TextUtils.ContentProvider.ContentProvider, FrameAssociated {
   debuggerModel: DebuggerModel;
   scriptId: Protocol.Runtime.ScriptId;
+  /**
+   * The URL of the script. When `hasSourceURL` is true, this value comes from a `//# sourceURL=` directive. Otherwise,
+   * it's the original `src` URL from which the script was loaded.
+   */
   sourceURL: Platform.DevToolsPath.UrlString;
   lineOffset: number;
   columnOffset: number;