@browserbasehq/orca 3.1.0-patch.3 → 3.2.0-preview.1

package/dist/cjs/lib/v3/understudy/initScripts.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeInitScriptSource = normalizeInitScriptSource;
+const fs_1 = require("fs");
+const sdkErrors_js_1 = require("../types/public/sdkErrors.js");
+const DEFAULT_CALLER = "context.addInitScript";
+function appendSourceURL(source, filePath) {
+    const sanitized = filePath.replace(/\n/g, "");
+    return `${source}\n//# sourceURL=${sanitized}`;
+}
+async function normalizeInitScriptSource(script, arg, caller = DEFAULT_CALLER) {
+    if (typeof script === "function") {
+        const argString = Object.is(arg, undefined)
+            ? "undefined"
+            : JSON.stringify(arg);
+        return `(${script.toString()})(${argString})`;
+    }
+    if (!Object.is(arg, undefined)) {
+        throw new sdkErrors_js_1.StagehandInvalidArgumentError(`${caller}: 'arg' is only supported when passing a function.`);
+    }
+    if (typeof script === "string") {
+        return script;
+    }
+    if (!script || typeof script !== "object") {
+        throw new sdkErrors_js_1.StagehandInvalidArgumentError(`${caller}: provide a string, function, or an object with path/content.`);
+    }
+    if (typeof script.content === "string") {
+        return script.content;
+    }
+    if (typeof script.path === "string" && script.path.trim()) {
+        const raw = await fs_1.promises.readFile(script.path, "utf8");
+        return appendSourceURL(raw, script.path);
+    }
+    throw new sdkErrors_js_1.StagehandInvalidArgumentError(`${caller}: provide a string, function, or an object with path/content.`);
+}
+//# sourceMappingURL=initScripts.js.map

package/dist/cjs/lib/v3/understudy/initScripts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initScripts.js","sourceRoot":"","sources":["../../../../../lib/v3/understudy/initScripts.ts"],"names":[],"mappings":";;AAWA,8DAwCC;AAnDD,2BAAoC;AAEpC,+DAA6E;AAE7E,MAAM,cAAc,GAAG,uBAAuB,CAAC;AAE/C,SAAS,eAAe,CAAC,MAAc,EAAE,QAAgB;IACvD,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC9C,OAAO,GAAG,MAAM,mBAAmB,SAAS,EAAE,CAAC;AACjD,CAAC;AAEM,KAAK,UAAU,yBAAyB,CAC7C,MAA6B,EAC7B,GAAS,EACT,SAAiB,cAAc;IAE/B,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,CAAC;YACzC,CAAC,CAAC,WAAW;YACb,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACxB,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,KAAK,SAAS,GAAG,CAAC;IAChD,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,4CAA6B,CACrC,GAAG,MAAM,oDAAoD,CAC9D,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,MAAM,IAAI,4CAA6B,CACrC,GAAG,MAAM,+DAA+D,CACzE,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACvC,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QAC1D,MAAM,GAAG,GAAG,MAAM,aAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACnD,OAAO,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,IAAI,4CAA6B,CACrC,GAAG,MAAM,+DAA+D,CACzE,CAAC;AACJ,CAAC","sourcesContent":["import { promises as fs } from \"fs\";\nimport { InitScriptSource } from \"../types/private/index.js\";\nimport { StagehandInvalidArgumentError } from \"../types/public/sdkErrors.js\";\n\nconst DEFAULT_CALLER = \"context.addInitScript\";\n\nfunction appendSourceURL(source: string, filePath: string): string {\n  const sanitized = filePath.replace(/\\n/g, \"\");\n  return `${source}\\n//# sourceURL=${sanitized}`;\n}\n\nexport async function normalizeInitScriptSource<Arg>(\n  script: InitScriptSource<Arg>,\n  arg?: Arg,\n  caller: string = DEFAULT_CALLER,\n): Promise<string> {\n  if (typeof script === \"function\") {\n    const argString = Object.is(arg, undefined)\n      ? \"undefined\"\n      : JSON.stringify(arg);\n    return `(${script.toString()})(${argString})`;\n  }\n\n  if (!Object.is(arg, undefined)) {\n    throw new StagehandInvalidArgumentError(\n      `${caller}: 'arg' is only supported when passing a function.`,\n    );\n  }\n\n  if (typeof script === \"string\") {\n    return script;\n  }\n\n  if (!script || typeof script !== \"object\") {\n    throw new StagehandInvalidArgumentError(\n      `${caller}: provide a string, function, or an object with path/content.`,\n    );\n  }\n\n  if (typeof script.content === \"string\") {\n    return script.content;\n  }\n\n  if (typeof script.path === \"string\" && script.path.trim()) {\n    const raw = await fs.readFile(script.path, \"utf8\");\n    return appendSourceURL(raw, script.path);\n  }\n\n  throw new StagehandInvalidArgumentError(\n    `${caller}: provide a string, function, or an object with path/content.`,\n  );\n}\n"]}

package/dist/cjs/lib/v3/understudy/lifecycleWatcher.js

@@ -0,0 +1,249 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LifecycleWatcher = void 0;
+const sdkErrors_js_1 = require("../types/public/sdkErrors.js");
+const network_js_1 = require("../types/private/network.js");
+/**
+ * Coordinates page lifecycle waits (load/domcontentloaded/networkidle) while
+ * following main-frame swaps and navigation aborts. Each navigation spawns a
+ * one-off watcher that listens for relevant CDP events and resolves or rejects
+ * depending on the requested `waitUntil` state.
+ */
+/**
+ * Small utility that mirrors Playwright's lifecycle watcher semantics. Bridges
+ * main-frame lifecycle events with the NetworkManager's idle signal so callers
+ * can await `load`, `domcontentloaded`, or `networkidle` with a single promise.
+ */
+class LifecycleWatcher {
+    page;
+    mainSession;
+    networkManager;
+    waitUntil;
+    timeoutMs;
+    startTime;
+    navigationCommandId;
+    currentLoaderId;
+    idleStartTime;
+    cleanupCallbacks = [];
+    idleHandle = null;
+    abortReject = null;
+    abortPromise;
+    abortError = null;
+    disposed = false;
+    expectedLoaderId;
+    initialLoaderId;
+    pendingFollowupNavigation = false;
+    /**
+     * Create a watcher; callers should subsequently invoke {@link wait}.
+     */
+    constructor(params) {
+        this.page = params.page;
+        this.mainSession = params.mainSession;
+        this.networkManager = params.networkManager;
+        this.waitUntil = params.waitUntil;
+        this.timeoutMs = params.timeoutMs;
+        this.startTime = Date.now();
+        this.navigationCommandId = params.navigationCommandId;
+        this.idleStartTime = this.startTime;
+        this.abortPromise = new Promise((_, reject) => {
+            this.abortReject = reject;
+        });
+        this.installSessionListeners();
+    }
+    /** Hint the watcher with the loader id returned by Page.navigate. */
+    setExpectedLoaderId(loaderId) {
+        if (!loaderId)
+            return;
+        this.expectedLoaderId = loaderId;
+        this.initialLoaderId = loaderId;
+        this.currentLoaderId = loaderId;
+        this.idleStartTime = Date.now();
+    }
+    /** Wait for the requested lifecycle state or throw on timeout/abort. */
+    async wait() {
+        const deadline = Date.now() + this.timeoutMs;
+        try {
+            if (this.waitUntil === "domcontentloaded") {
+                await this.awaitWithAbort(this.page.waitForMainLoadState("domcontentloaded", this.timeRemaining(deadline)));
+                return;
+            }
+            while (true) {
+                await this.awaitWithAbort(this.page.waitForMainLoadState("load", this.timeRemaining(deadline)));
+                if (this.waitUntil !== "networkidle")
+                    break;
+                try {
+                    await this.awaitWithAbort(this.waitForNetworkIdle(deadline));
+                    break;
+                }
+                catch (error) {
+                    if (this.shouldRestartAfterFollowup(error)) {
+                        continue;
+                    }
+                    throw error;
+                }
+            }
+        }
+        finally {
+            this.dispose();
+        }
+        if (this.abortError)
+            throw this.abortError;
+    }
+    /** Cancel any outstanding network-idle waits and remove event listeners. */
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        if (this.idleHandle) {
+            void this.idleHandle.promise.catch(() => { });
+            this.idleHandle.dispose();
+            this.idleHandle = null;
+        }
+        for (const fn of this.cleanupCallbacks) {
+            try {
+                fn();
+            }
+            catch {
+                // ignore listener cleanup errors
+            }
+        }
+        this.cleanupCallbacks = [];
+        this.abortReject = null;
+    }
+    /** Subscribe to main-frame events to detect abort conditions. */
+    installSessionListeners() {
+        const onFrameNavigated = (evt) => {
+            if (!evt?.frame?.id)
+                return;
+            const mainFrameId = this.page.mainFrameId();
+            if (evt.frame.id !== mainFrameId)
+                return;
+            const loaderId = evt.frame.loaderId;
+            if (!loaderId)
+                return;
+            if (!this.initialLoaderId) {
+                this.initialLoaderId = loaderId;
+                this.currentLoaderId = loaderId;
+                this.idleStartTime = Date.now();
+            }
+            if (!this.expectedLoaderId) {
+                this.expectedLoaderId = loaderId;
+                this.currentLoaderId = loaderId;
+                this.idleStartTime = Date.now();
+                return;
+            }
+            if (loaderId !== this.expectedLoaderId) {
+                if (!this.page.isCurrentNavigationCommand(this.navigationCommandId)) {
+                    this.triggerAbort(new Error("Navigation was superseded by a new request"));
+                    return;
+                }
+                this.adoptNewMainLoader(loaderId);
+            }
+        };
+        const onFrameDetached = (evt) => {
+            if (!evt?.frameId)
+                return;
+            const mainFrameId = this.page.mainFrameId();
+            if (evt.frameId !== mainFrameId)
+                return;
+            if (evt.reason === "swap")
+                return;
+            this.triggerAbort(new Error("Main frame was detached"));
+        };
+        this.mainSession.on("Page.frameNavigated", onFrameNavigated);
+        this.cleanupCallbacks.push(() => {
+            this.mainSession.off("Page.frameNavigated", onFrameNavigated);
+        });
+        this.mainSession.on("Page.frameDetached", onFrameDetached);
+        this.cleanupCallbacks.push(() => {
+            this.mainSession.off("Page.frameDetached", onFrameDetached);
+        });
+    }
+    /** Compute remaining time until the shared deadline elapses. */
+    timeRemaining(deadline) {
+        const remaining = deadline - Date.now();
+        if (remaining <= 0) {
+            throw new sdkErrors_js_1.TimeoutError("Lifecycle wait", this.timeoutMs);
+        }
+        return remaining;
+    }
+    /** Await an operation but abort early if navigation replacement fires. */
+    async awaitWithAbort(operation) {
+        try {
+            return await Promise.race([operation, this.abortPromise]);
+        }
+        catch (error) {
+            if (this.abortError)
+                throw this.abortError;
+            throw error;
+        }
+    }
+    /** Mark the watcher as aborted and reject any pending waiters. */
+    triggerAbort(error) {
+        if (this.abortError)
+            return;
+        this.abortError = error;
+        if (this.abortReject) {
+            this.abortReject(error);
+            this.abortReject = null;
+        }
+    }
+    waitForNetworkIdle(deadline) {
+        this.pendingFollowupNavigation = false;
+        const remaining = this.timeRemaining(deadline);
+        const idleWindow = Math.min(network_js_1.DEFAULT_IDLE_WAIT, remaining);
+        this.idleHandle = this.networkManager.waitForIdle({
+            startTime: this.idleStartTime,
+            timeoutMs: remaining,
+            totalBudgetMs: this.timeoutMs,
+            idleTimeMs: idleWindow,
+            filter: this.buildIdleFilter(),
+        });
+        return this.idleHandle.promise.catch((error) => {
+            if (this.abortError)
+                throw this.abortError;
+            throw error;
+        });
+    }
+    shouldRestartAfterFollowup(error) {
+        if (!this.pendingFollowupNavigation)
+            return false;
+        if (!(error instanceof Error))
+            return false;
+        if (error.message !== "waitForIdle disposed")
+            return false;
+        this.pendingFollowupNavigation = false;
+        return true;
+    }
+    adoptNewMainLoader(loaderId) {
+        this.expectedLoaderId = loaderId;
+        this.currentLoaderId = loaderId;
+        this.idleStartTime = Date.now();
+        if (this.waitUntil !== "networkidle")
+            return;
+        this.pendingFollowupNavigation = true;
+        if (this.idleHandle) {
+            const handle = this.idleHandle;
+            this.idleHandle = null;
+            void handle.promise.catch(() => { });
+            handle.dispose();
+        }
+    }
+    buildIdleFilter() {
+        const loaderId = this.currentLoaderId;
+        const mainFrameId = this.page.mainFrameId();
+        return (info) => {
+            if (network_js_1.IGNORED_RESOURCE_TYPES.has(info.resourceType))
+                return false;
+            if (loaderId && info.loaderId) {
+                return info.loaderId === loaderId;
+            }
+            if (!info.loaderId && info.frameId) {
+                return info.frameId === mainFrameId;
+            }
+            return true;
+        };
+    }
+}
+exports.LifecycleWatcher = LifecycleWatcher;
+//# sourceMappingURL=lifecycleWatcher.js.map

package/dist/cjs/lib/v3/understudy/lifecycleWatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycleWatcher.js","sourceRoot":"","sources":["../../../../../lib/v3/understudy/lifecycleWatcher.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Protocol } from \"devtools-protocol\";\nimport type { LoadState } from \"../types/public/page.js\";\nimport type { CDPSessionLike } from \"./cdp.js\";\nimport type { NetworkManager } from \"./networkManager.js\";\nimport type { Page } from \"./page.js\";\nimport { TimeoutError } from \"../types/public/sdkErrors.js\";\nimport {\n  DEFAULT_IDLE_WAIT,\n  IGNORED_RESOURCE_TYPES,\n  type NetworkRequestInfo,\n  WaitForIdleHandle,\n} from \"../types/private/network.js\";\n\n/**\n * Coordinates page lifecycle waits (load/domcontentloaded/networkidle) while\n * following main-frame swaps and navigation aborts. Each navigation spawns a\n * one-off watcher that listens for relevant CDP events and resolves or rejects\n * depending on the requested `waitUntil` state.\n */\n\n/**\n * Small utility that mirrors Playwright's lifecycle watcher semantics. Bridges\n * main-frame lifecycle events with the NetworkManager's idle signal so callers\n * can await `load`, `domcontentloaded`, or `networkidle` with a single promise.\n */\nexport class LifecycleWatcher {\n  private readonly page: Page;\n  private readonly mainSession: CDPSessionLike;\n  private readonly networkManager: NetworkManager;\n  private readonly waitUntil: LoadState;\n  private readonly timeoutMs: number;\n  private readonly startTime: number;\n  private readonly navigationCommandId: number;\n  private currentLoaderId: string | undefined;\n  private idleStartTime: number;\n\n  private cleanupCallbacks: Array<() => void> = [];\n  private idleHandle: WaitForIdleHandle | null = null;\n\n  private abortReject: ((error: Error) => void) | null = null;\n  private abortPromise: Promise<never>;\n  private abortError: Error | null = null;\n  private disposed = false;\n\n  private expectedLoaderId: string | undefined;\n  private initialLoaderId: string | undefined;\n  private pendingFollowupNavigation = false;\n\n  /**\n   * Create a watcher; callers should subsequently invoke {@link wait}.\n   */\n  constructor(params: {\n    page: Page;\n    mainSession: CDPSessionLike;\n    networkManager: NetworkManager;\n    waitUntil: LoadState;\n    timeoutMs: number;\n    navigationCommandId: number;\n  }) {\n    this.page = params.page;\n    this.mainSession = params.mainSession;\n    this.networkManager = params.networkManager;\n    this.waitUntil = params.waitUntil;\n    this.timeoutMs = params.timeoutMs;\n    this.startTime = Date.now();\n    this.navigationCommandId = params.navigationCommandId;\n    this.idleStartTime = this.startTime;\n\n    this.abortPromise = new Promise<never>((_, reject) => {\n      this.abortReject = reject;\n    });\n\n    this.installSessionListeners();\n  }\n\n  /** Hint the watcher with the loader id returned by Page.navigate. */\n  public setExpectedLoaderId(loaderId: string | undefined): void {\n    if (!loaderId) return;\n    this.expectedLoaderId = loaderId;\n    this.initialLoaderId = loaderId;\n    this.currentLoaderId = loaderId;\n    this.idleStartTime = Date.now();\n  }\n\n  /** Wait for the requested lifecycle state or throw on timeout/abort. */\n  public async wait(): Promise<void> {\n    const deadline = Date.now() + this.timeoutMs;\n\n    try {\n      if (this.waitUntil === \"domcontentloaded\") {\n        await this.awaitWithAbort(\n          this.page.waitForMainLoadState(\n            \"domcontentloaded\",\n            this.timeRemaining(deadline),\n          ),\n        );\n        return;\n      }\n\n      while (true) {\n        await this.awaitWithAbort(\n          this.page.waitForMainLoadState(\"load\", this.timeRemaining(deadline)),\n        );\n\n        if (this.waitUntil !== \"networkidle\") break;\n\n        try {\n          await this.awaitWithAbort(this.waitForNetworkIdle(deadline));\n          break;\n        } catch (error) {\n          if (this.shouldRestartAfterFollowup(error)) {\n            continue;\n          }\n          throw error;\n        }\n      }\n    } finally {\n      this.dispose();\n    }\n\n    if (this.abortError) throw this.abortError;\n  }\n\n  /** Cancel any outstanding network-idle waits and remove event listeners. */\n  public dispose(): void {\n    if (this.disposed) return;\n    this.disposed = true;\n\n    if (this.idleHandle) {\n      void this.idleHandle.promise.catch(() => {});\n      this.idleHandle.dispose();\n      this.idleHandle = null;\n    }\n\n    for (const fn of this.cleanupCallbacks) {\n      try {\n        fn();\n      } catch {\n        // ignore listener cleanup errors\n      }\n    }\n    this.cleanupCallbacks = [];\n    this.abortReject = null;\n  }\n\n  /** Subscribe to main-frame events to detect abort conditions. */\n  private installSessionListeners(): void {\n    const onFrameNavigated = (evt: Protocol.Page.FrameNavigatedEvent) => {\n      if (!evt?.frame?.id) return;\n\n      const mainFrameId = this.page.mainFrameId();\n      if (evt.frame.id !== mainFrameId) return;\n\n      const loaderId = evt.frame.loaderId;\n      if (!loaderId) return;\n\n      if (!this.initialLoaderId) {\n        this.initialLoaderId = loaderId;\n        this.currentLoaderId = loaderId;\n        this.idleStartTime = Date.now();\n      }\n\n      if (!this.expectedLoaderId) {\n        this.expectedLoaderId = loaderId;\n        this.currentLoaderId = loaderId;\n        this.idleStartTime = Date.now();\n        return;\n      }\n\n      if (loaderId !== this.expectedLoaderId) {\n        if (!this.page.isCurrentNavigationCommand(this.navigationCommandId)) {\n          this.triggerAbort(\n            new Error(\"Navigation was superseded by a new request\"),\n          );\n          return;\n        }\n\n        this.adoptNewMainLoader(loaderId);\n      }\n    };\n\n    const onFrameDetached = (evt: Protocol.Page.FrameDetachedEvent) => {\n      if (!evt?.frameId) return;\n      const mainFrameId = this.page.mainFrameId();\n      if (evt.frameId !== mainFrameId) return;\n      if (evt.reason === \"swap\") return;\n      this.triggerAbort(new Error(\"Main frame was detached\"));\n    };\n\n    this.mainSession.on(\"Page.frameNavigated\", onFrameNavigated);\n    this.cleanupCallbacks.push(() => {\n      this.mainSession.off(\"Page.frameNavigated\", onFrameNavigated);\n    });\n\n    this.mainSession.on(\"Page.frameDetached\", onFrameDetached);\n    this.cleanupCallbacks.push(() => {\n      this.mainSession.off(\"Page.frameDetached\", onFrameDetached);\n    });\n  }\n\n  /** Compute remaining time until the shared deadline elapses. */\n  private timeRemaining(deadline: number): number {\n    const remaining = deadline - Date.now();\n    if (remaining <= 0) {\n      throw new TimeoutError(\"Lifecycle wait\", this.timeoutMs);\n    }\n    return remaining;\n  }\n\n  /** Await an operation but abort early if navigation replacement fires. */\n  private async awaitWithAbort<T>(operation: Promise<T>): Promise<T> {\n    try {\n      return await Promise.race([operation, this.abortPromise]);\n    } catch (error) {\n      if (this.abortError) throw this.abortError;\n      throw error;\n    }\n  }\n\n  /** Mark the watcher as aborted and reject any pending waiters. */\n  private triggerAbort(error: Error): void {\n    if (this.abortError) return;\n    this.abortError = error;\n    if (this.abortReject) {\n      this.abortReject(error);\n      this.abortReject = null;\n    }\n  }\n  private waitForNetworkIdle(deadline: number): Promise<void> {\n    this.pendingFollowupNavigation = false;\n    const remaining = this.timeRemaining(deadline);\n    const idleWindow = Math.min(DEFAULT_IDLE_WAIT, remaining);\n    this.idleHandle = this.networkManager.waitForIdle({\n      startTime: this.idleStartTime,\n      timeoutMs: remaining,\n      totalBudgetMs: this.timeoutMs,\n      idleTimeMs: idleWindow,\n      filter: this.buildIdleFilter(),\n    });\n\n    return this.idleHandle.promise.catch((error) => {\n      if (this.abortError) throw this.abortError;\n      throw error;\n    });\n  }\n\n  private shouldRestartAfterFollowup(error: unknown): boolean {\n    if (!this.pendingFollowupNavigation) return false;\n    if (!(error instanceof Error)) return false;\n    if (error.message !== \"waitForIdle disposed\") return false;\n    this.pendingFollowupNavigation = false;\n    return true;\n  }\n\n  private adoptNewMainLoader(loaderId: string): void {\n    this.expectedLoaderId = loaderId;\n    this.currentLoaderId = loaderId;\n    this.idleStartTime = Date.now();\n    if (this.waitUntil !== \"networkidle\") return;\n\n    this.pendingFollowupNavigation = true;\n\n    if (this.idleHandle) {\n      const handle = this.idleHandle;\n      this.idleHandle = null;\n      void handle.promise.catch(() => {});\n      handle.dispose();\n    }\n  }\n\n  private buildIdleFilter(): (info: NetworkRequestInfo) => boolean {\n    const loaderId = this.currentLoaderId;\n    const mainFrameId = this.page.mainFrameId();\n\n    return (info: NetworkRequestInfo) => {\n      if (IGNORED_RESOURCE_TYPES.has(info.resourceType)) return false;\n\n      if (loaderId && info.loaderId) {\n        return info.loaderId === loaderId;\n      }\n\n      if (!info.loaderId && info.frameId) {\n        return info.frameId === mainFrameId;\n      }\n\n      return true;\n    };\n  }\n}\n"]}