chrome-devtools-frontend 1.0.1615539 → 1.0.1616061

package/front_end/third_party/puppeteer/package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "puppeteer-core",
-  "version": "24.40.0",
+  "version": "24.41.0",
   "description": "A high-level API to control headless Chrome over the DevTools Protocol",
   "keywords": [
     "puppeteer",
@@ -108,9 +108,8 @@
       ]
     },
     "build:types": {
-      "command": "api-extractor run --local && eslint --cache-location .eslintcache --cache --no-ignore --no-config-lookup -c=../../eslint.types.config.mjs --fix lib/types.d.ts",
+      "command": "api-extractor run --local && eslint --fix lib/types.d.ts --no-ignore",
       "files": [
-        "../../eslint.types.config.mjs",
         "api-extractor.json",
         "lib/esm/puppeteer/types.d.ts",
         "tsconfig.json"
@@ -152,14 +151,14 @@
     "@puppeteer/browsers": "2.13.0",
     "chromium-bidi": "14.0.0",
     "debug": "^4.4.3",
-    "devtools-protocol": "0.0.1581282",
+    "devtools-protocol": "0.0.1595872",
     "typed-query-selector": "^2.12.1",
     "webdriver-bidi-protocol": "0.4.1",
     "ws": "^8.19.0"
   },
   "devDependencies": {
-    "@types/chrome": "0.1.37",
-    "@types/debug": "4.1.12",
+    "@types/chrome": "0.1.40",
+    "@types/debug": "4.1.13",
     "@types/node": "^18.17.15",
     "@types/ws": "8.18.1",
     "mitt": "3.0.1",

package/front_end/third_party/puppeteer/package/src/api/Browser.ts

@@ -32,6 +32,7 @@ import {
 import {asyncDisposeSymbol, disposeSymbol} from '../util/disposable.js';
 
 import type {BrowserContext} from './BrowserContext.js';
+import type {Extension} from './Extension.js';
 import type {Page} from './Page.js';
 import type {Target} from './Target.js';
 /**
@@ -727,4 +728,16 @@ export abstract class Browser extends EventEmitter<BrowserEvents> {
    * @internal
    */
   abstract isNetworkEnabled(): boolean;
+
+  /**
+   * Retrieves a map of all extensions installed in the browser, where the keys
+   * are extension IDs and the values are the corresponding {@link Extension} instances.
+   *
+   * @public
+   */
+  abstract extensions(): Promise<Map<string, Extension>>;
+  /**
+   * @internal
+   */
+  abstract isIssuesEnabled(): boolean;
 }

package/front_end/third_party/puppeteer/package/src/api/Extension.ts

@@ -0,0 +1,98 @@
+/**
+ * @license
+ * Copyright 2026 Google Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import type {Page} from './Page.js';
+import type {WebWorker} from './WebWorker.js';
+
+/**
+ * {@link Extension} represents a browser extension installed in the browser.
+ * It provides access to the extension's ID, name, and version, as well as
+ * methods for interacting with the extension's background workers and pages.
+ *
+ * @example
+ * To get all extensions installed in the browser:
+ *
+ * ```ts
+ * const extensions = await browser.extensions();
+ * for (const [id, extension] of extensions) {
+ *   console.log(extension.name, id);
+ * }
+ * ```
+ *
+ * @experimental
+ * @public
+ */
+export abstract class Extension {
+  #id: string;
+  #version: string;
+  #name: string;
+
+  /**
+   * @internal
+   */
+  constructor(id: string, version: string, name: string) {
+    if (!id || !version) {
+      throw new Error('Extension ID and version are required');
+    }
+
+    this.#id = id;
+    this.#version = version;
+    this.#name = name;
+  }
+
+  /**
+   * The version of the extension as specified in its manifest.
+   *
+   * @public
+   */
+  get version(): string {
+    return this.#version;
+  }
+
+  /**
+   * The name of the extension as specified in its manifest.
+   *
+   * @public
+   */
+  get name(): string {
+    return this.#name;
+  }
+
+  /**
+   * The unique identifier of the extension.
+   *
+   * @public
+   */
+  get id(): string {
+    return this.#id;
+  }
+
+  /**
+   * Returns a list of the currently active service workers belonging
+   * to the extension.
+   *
+   * @public
+   */
+  abstract workers(): Promise<WebWorker[]>;
+
+  /**
+   * Returns a list of the currently active and visible pages belonging
+   * to the extension.
+   *
+   * @public
+   */
+  abstract pages(): Promise<Page[]>;
+
+  /**
+   * Triggers the default action of the extension for a specified page.
+   * This typically simulates a user clicking the extension's action icon
+   * in the browser toolbar, potentially opening a popup or executing an action script.
+   *
+   * @param page - The page to trigger the action on.
+   * @public
+   */
+  abstract triggerAction(page: Page): Promise<void>;
+}

package/front_end/third_party/puppeteer/package/src/api/Frame.ts

@@ -1200,4 +1200,13 @@ export abstract class Frame extends EventEmitter<FrameEvents> {
   abstract waitForDevicePrompt(
     options?: WaitTimeoutOptions,
   ): Promise<DeviceRequestPrompt>;
+
+  /**
+   * Retrieves the list of extension execution realms associated with this frame.
+   * Extension execution realms are created by extension content scripts injected
+   * into the frame.
+   *
+   * @public
+   */
+  abstract extensionRealms(): Realm[];
 }

package/front_end/third_party/puppeteer/package/src/api/Issue.ts

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2026 Google Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import type Protocol from 'devtools-protocol';
+
+/**
+ * The Issue interface represents a DevTools issue.
+ *
+ * @public
+ */
+export interface Issue {
+  /**
+   * The code of the issue.
+   */
+  code: string;
+
+  /**
+   * The details of the issue.
+   */
+  details: Protocol.Audits.InspectorIssueDetails;
+}

package/front_end/third_party/puppeteer/package/src/api/Page.ts

@@ -34,6 +34,7 @@ import type {Accessibility} from '../cdp/Accessibility.js';
 import type {Coverage} from '../cdp/Coverage.js';
 import type {NetworkConditions} from '../cdp/NetworkManager.js';
 import type {Tracing} from '../cdp/Tracing.js';
+import type {WebMCP} from '../cdp/WebMCP.js';
 import type {ConsoleMessage} from '../common/ConsoleMessage.js';
 import type {
   Cookie,
@@ -92,6 +93,7 @@ import type {
   ClickOptions,
   ElementHandle,
 } from './ElementHandle.js';
+import type {Extension} from './Extension.js';
 import type {
   Frame,
   FrameAddScriptTagOptions,
@@ -106,6 +108,7 @@ import type {
   Mouse,
   Touchscreen,
 } from './Input.js';
+import type {Issue} from './Issue.js';
 import type {JSHandle} from './JSHandle.js';
 import {
   FunctionLocator,
@@ -113,6 +116,7 @@ import {
   NodeLocator,
   type AwaitedLocator,
 } from './locators/locators.js';
+import type {Realm} from './Realm.js';
 import type {Target} from './Target.js';
 import type {WebWorker} from './WebWorker.js';
 
@@ -475,6 +479,11 @@ export const enum PageEvent {
    * event is dispatched.
    */
   DOMContentLoaded = 'domcontentloaded',
+  /**
+   * Emitted when a DevTools issue is reported.
+   * @experimental
+   */
+  Issue = 'issue',
   /**
    * Emitted when the page crashes. Will contain an `Error`.
    */
@@ -597,6 +606,7 @@ export interface PageEvents extends Record<EventType, unknown> {
   [PageEvent.Console]: ConsoleMessage;
   [PageEvent.Dialog]: Dialog;
   [PageEvent.DOMContentLoaded]: undefined;
+  [PageEvent.Issue]: Issue;
   [PageEvent.Error]: Error;
   [PageEvent.FrameAttached]: Frame;
   [PageEvent.FrameDetached]: Frame;
@@ -943,6 +953,15 @@ export abstract class Page extends EventEmitter<PageEvents> {
    */
   abstract get tracing(): Tracing;
 
+  /**
+   * Experimental API for {@link https://github.com/webmachinelearning/webmcp
+   * | WebMCP}. Requires Chrome 149+ with the
+   * `--enable-features=WebMCPTesting,DevToolsWebMCPSupport` flags enabled.
+   *
+   * @experimental
+   */
+  abstract get webmcp(): WebMCP;
+
   /**
    * {@inheritDoc Accessibility}
    */
@@ -3231,6 +3250,25 @@ export abstract class Page extends EventEmitter<PageEvents> {
    * {@inheritDoc BluetoothEmulation}
    */
   abstract get bluetooth(): BluetoothEmulation;
+
+  /**
+   * Triggers the default action of the specified extension for this page.
+   * This simulates clicking the extension's icon in the browser's toolbar.
+   *
+   * @param extension - The {@link Extension} whose action to trigger.
+   * @public
+   */
+  abstract triggerExtensionAction(extension: Extension): Promise<void>;
+
+  /**
+   * Retrieves the list of extension execution realms in the main frame of the page.
+   * These realms correspond to extension content scripts running on the page.
+   *
+   * Shortcut for {@link Frame.extensionRealms | mainFrame().extensionRealms()}.
+   *
+   * @public
+   */
+  abstract extensionRealms(): Realm[];
 }
 
 /**

package/front_end/third_party/puppeteer/package/src/api/Realm.ts

@@ -5,33 +5,83 @@
  */
 
 import type {TimeoutSettings} from '../common/TimeoutSettings.js';
-import type {
-  EvaluateFunc,
-  HandleFor,
-  InnerLazyParams,
-} from '../common/types.js';
+import type {EvaluateFunc, HandleFor} from '../common/types.js';
 import {TaskManager, WaitTask} from '../common/WaitTask.js';
 import {disposeSymbol} from '../util/disposable.js';
 
 import type {ElementHandle} from './ElementHandle.js';
 import type {Environment} from './Environment.js';
+import type {Extension} from './Extension.js';
 import type {JSHandle} from './JSHandle.js';
 
 /**
- * @internal
+ * @public
  */
-export abstract class Realm implements Disposable {
+export abstract class Realm {
+  /** @internal */
   protected readonly timeoutSettings: TimeoutSettings;
+  /** @internal */
   readonly taskManager = new TaskManager();
-
+  /** @internal */
   constructor(timeoutSettings: TimeoutSettings) {
     this.timeoutSettings = timeoutSettings;
   }
-
+  /** @internal */
   abstract get environment(): Environment;
 
+  /**
+   * Returns the origin that created the Realm.
+   * For example, if the realm was created by an extension content script,
+   * this will return the origin of the extension
+   * (e.g., `chrome-extension://<extension-id>`).
+   *
+   * @experimental
+   * @example
+   * `chrome-extension://<chrome-extension-id>`
+   */
+  abstract get origin(): string | undefined;
+  /**
+   * Returns the {@link Extension} that created this realm, if applicable.
+   * This is typically populated when the realm was created by an extension
+   * content script injected into a page.
+   *
+   * @returns A promise that resolves to the {@link Extension}
+   * or `null` if not created by an extension.
+   * @experimental
+   */
+  abstract extension(): Promise<Extension | null>;
+
+  /** @internal */
   abstract adoptHandle<T extends JSHandle<Node>>(handle: T): Promise<T>;
+
+  /** @internal */
   abstract transferHandle<T extends JSHandle<Node>>(handle: T): Promise<T>;
+
+  /**
+   * Evaluates a function in the realm's context and returns a
+   * {@link JSHandle} to the result.
+   *
+   * If the function passed to `realm.evaluateHandle` returns a Promise,
+   * the method will wait for the promise to resolve and return its value.
+   *
+   * {@link JSHandle} instances can be passed as arguments to the function.
+   *
+   * @example
+   *
+   * ```ts
+   * const aHandle = await realm.evaluateHandle(() => document.body);
+   * const resultHandle = await realm.evaluateHandle(
+   *   body => body.innerHTML,
+   *   aHandle,
+   * );
+   * ```
+   *
+   * @param pageFunction - A function to be evaluated in the realm.
+   * @param args - Arguments to be passed to the `pageFunction`.
+   * @returns A promise that resolves to a {@link JSHandle} containing
+   * the result.
+   * @public
+   */
   abstract evaluateHandle<
     Params extends unknown[],
     Func extends EvaluateFunc<Params> = EvaluateFunc<Params>,
@@ -39,6 +89,30 @@ export abstract class Realm implements Disposable {
     pageFunction: Func | string,
     ...args: Params
   ): Promise<HandleFor<Awaited<ReturnType<Func>>>>;
+
+  /**
+   * Evaluates a function in the realm's context and returns the
+   * resulting value.
+   *
+   * If the function passed to `realm.evaluate` returns a Promise,
+   * the method will wait for the promise to resolve and return its value.
+   *
+   * {@link JSHandle} instances can be passed as arguments to the function.
+   *
+   * @example
+   *
+   * ```ts
+   * const result = await realm.evaluate(() => {
+   *   return Promise.resolve(8 * 7);
+   * });
+   * console.log(result); // prints "56"
+   * ```
+   *
+   * @param pageFunction - A function to be evaluated in the realm.
+   * @param args - Arguments to be passed to the `pageFunction`.
+   * @returns A promise that resolves to the return value of the function.
+   * @public
+   */
   abstract evaluate<
     Params extends unknown[],
     Func extends EvaluateFunc<Params> = EvaluateFunc<Params>,
@@ -47,11 +121,33 @@ export abstract class Realm implements Disposable {
     ...args: Params
   ): Promise<Awaited<ReturnType<Func>>>;
 
+  /**
+   * Waits for a function to return a truthy value when evaluated in
+   * the realm's context.
+   *
+   * Arguments can be passed from Node.js to `pageFunction`.
+   *
+   * @example
+   *
+   * ```ts
+   * const selector = '.foo';
+   * await realm.waitForFunction(
+   *   selector => !!document.querySelector(selector),
+   *   {},
+   *   selector,
+   * );
+   * ```
+   *
+   * @param pageFunction - A function to evaluate in the realm.
+   * @param options - Options for polling and timeouts.
+   * @param args - Arguments to pass to the function.
+   * @returns A promise that resolves when the function returns a truthy
+   * value.
+   * @public
+   */
   async waitForFunction<
     Params extends unknown[],
-    Func extends EvaluateFunc<InnerLazyParams<Params>> = EvaluateFunc<
-      InnerLazyParams<Params>
-    >,
+    Func extends EvaluateFunc<Params> = EvaluateFunc<Params>,
   >(
     pageFunction: Func | string,
     options: {
@@ -87,8 +183,10 @@ export abstract class Realm implements Disposable {
     return await waitTask.result;
   }
 
+  /** @internal */
   abstract adoptBackendNode(backendNodeId?: number): Promise<JSHandle<Node>>;
 
+  /** @internal */
   get disposed(): boolean {
     return this.#disposed;
   }
@@ -101,6 +199,7 @@ export abstract class Realm implements Disposable {
       new Error('waitForFunction failed: frame got detached.'),
     );
   }
+
   /** @internal */
   [disposeSymbol](): void {
     this.dispose();

package/front_end/third_party/puppeteer/package/src/api/WebWorker.ts

@@ -4,8 +4,10 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
+import type {ConsoleMessage} from '../common/ConsoleMessage.js';
 import {UnsupportedOperation} from '../common/Errors.js';
-import {EventEmitter, type EventType} from '../common/EventEmitter.js';
+import type {EventType} from '../common/EventEmitter.js';
+import {EventEmitter} from '../common/EventEmitter.js';
 import {TimeoutSettings} from '../common/TimeoutSettings.js';
 import type {EvaluateFunc, HandleFor} from '../common/types.js';
 import {withSourcePuppeteerURLIfNone} from '../common/util.js';
@@ -13,6 +15,28 @@ import {withSourcePuppeteerURLIfNone} from '../common/util.js';
 import type {CDPSession} from './CDPSession.js';
 import type {Realm} from './Realm.js';
 
+/**
+ * @public
+ */
+export enum WebWorkerEvent {
+  /**
+   * Emitted when the worker calls a console API.
+   */
+  Console = 'console',
+  /**
+   * Emitted when the worker throws an exception.
+   */
+  Error = 'error',
+}
+
+/**
+ * @public
+ */
+export interface WebWorkerEvents extends Record<EventType, unknown> {
+  [WebWorkerEvent.Console]: ConsoleMessage;
+  [WebWorkerEvent.Error]: Error;
+}
+
 /**
  * This class represents a
  * {@link https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API | WebWorker}.
@@ -39,9 +63,7 @@ import type {Realm} from './Realm.js';
  *
  * @public
  */
-export abstract class WebWorker extends EventEmitter<
-  Record<EventType, unknown>
-> {
+export abstract class WebWorker extends EventEmitter<WebWorkerEvents> {
   /**
    * @internal
    */

package/front_end/third_party/puppeteer/package/src/api/api.ts

@@ -11,11 +11,13 @@ export * from './CDPSession.js';
 export * from './DeviceRequestPrompt.js';
 export * from './Dialog.js';
 export * from './ElementHandle.js';
+export * from './Extension.js';
 export type * from './Environment.js';
 export * from './Frame.js';
 export * from './HTTPRequest.js';
 export * from './HTTPResponse.js';
 export * from './Input.js';
+export type * from './Issue.js';
 export * from './JSHandle.js';
 export * from './Page.js';
 export * from './Realm.js';

package/front_end/third_party/puppeteer/package/src/bidi/Browser.ts

@@ -21,6 +21,7 @@ import {
   type DebugInfo,
 } from '../api/Browser.js';
 import {BrowserContextEvent} from '../api/BrowserContext.js';
+import type {Extension} from '../api/Extension.js';
 import type {Page} from '../api/Page.js';
 import type {Target} from '../api/Target.js';
 import type {Connection as CdpConnection} from '../cdp/Connection.js';
@@ -50,6 +51,7 @@ export interface BidiBrowserOptions {
   acceptInsecureCerts?: boolean;
   capabilities?: SupportedWebDriverCapabilities;
   networkEnabled: boolean;
+  issuesEnabled: boolean;
 }
 
 /**
@@ -153,6 +155,7 @@ export class BidiBrowser extends Browser {
   #target = new BidiBrowserTarget(this);
   #cdpConnection?: CdpConnection;
   #networkEnabled: boolean;
+  #issuesEnabled: boolean;
 
   private constructor(browserCore: BrowserCore, opts: BidiBrowserOptions) {
     super();
@@ -162,6 +165,7 @@ export class BidiBrowser extends Browser {
     this.#defaultViewport = opts.defaultViewport;
     this.#cdpConnection = opts.cdpConnection;
     this.#networkEnabled = opts.networkEnabled;
+    this.#issuesEnabled = opts.issuesEnabled;
   }
 
   #initialize() {
@@ -375,4 +379,12 @@ export class BidiBrowser extends Browser {
   override isNetworkEnabled(): boolean {
     return this.#networkEnabled;
   }
+
+  override extensions(): Promise<Map<string, Extension>> {
+    throw new UnsupportedOperation();
+  }
+
+  override isIssuesEnabled(): boolean {
+    return this.#issuesEnabled;
+  }
 }

package/front_end/third_party/puppeteer/package/src/bidi/BrowserConnector.ts

@@ -31,6 +31,7 @@ export async function _connectToBiDiBrowser(
   const {
     acceptInsecureCerts = false,
     networkEnabled = true,
+    issuesEnabled = true,
     defaultViewport = DEFAULT_VIEWPORT,
   } = options;
 
@@ -45,6 +46,7 @@ export async function _connectToBiDiBrowser(
     defaultViewport: defaultViewport,
     acceptInsecureCerts: acceptInsecureCerts,
     networkEnabled,
+    issuesEnabled,
     capabilities: options.capabilities,
   });
   return bidiBrowser;

package/front_end/third_party/puppeteer/package/src/bidi/BrowserContext.ts

@@ -187,6 +187,13 @@ export class BidiBrowserContext extends BrowserContext {
     });
   }
 
+  /**
+   * @internal
+   */
+  getTargetForPage(page: BidiPage): BidiPageTarget | undefined {
+    return this.#targets.get(page)?.[0];
+  }
+
   override async newPage(options?: CreatePageOptions): Promise<Page> {
     using _guard = await this.waitForScreenshotOperations();