chrome-devtools-frontend 1.0.1668390 → 1.0.1669021

package/front_end/third_party/puppeteer/package/lib/types.d.ts

@@ -123,6 +123,11 @@ export declare interface AddScreenParams {
   isInternal?: boolean;
 }
 
+/**
+ * @public
+ */
+export declare const asyncDisposeSymbol: typeof Symbol.asyncDispose;
+
 /**
  * Supported autofill address field names.
  *
@@ -567,6 +572,55 @@ export declare abstract class Browser extends EventEmitter<BrowserEvents> {
    * Uninstalls an extension.
    */
   abstract uninstallExtension(id: string): Promise<void>;
+  /**
+   * Installs a Progressive Web App (PWA) and returns its manifest id.
+   *
+   * @remarks
+   *
+   * Only available when connected to the browser over a pipe connection. Set
+   * `pipe: true` in {@link PuppeteerNode.launch | puppeteer.launch}; the launch
+   * option defaults to `false`. The underlying `PWA` CDP domain is not exposed
+   * over a WebSocket connection.
+   *
+   * The returned manifest id echoes {@link InstallPWAOptions.manifestId}, so it
+   * can be passed directly to {@link Browser.launchPWA},
+   * {@link Browser.getPWAState}, or {@link Browser.uninstallPWA}.
+   */
+  abstract installPWA(options: InstallPWAOptions): Promise<string>;
+  /**
+   * Uninstalls a previously installed Progressive Web App (PWA).
+   *
+   * @remarks
+   *
+   * Only available over a pipe connection. See {@link Browser.installPWA}.
+   */
+  abstract uninstallPWA(options: UninstallPWAOptions): Promise<void>;
+  /**
+   * Launches an installed Progressive Web App (PWA) and resolves with the
+   * {@link Page | page} backing the app window.
+   *
+   * @remarks
+   *
+   * Only available over a pipe connection. See {@link Browser.installPWA}.
+   *
+   * `PWA.launch` resolves with the id of the launched _tab_ target. Puppeteer
+   * does not expose tab targets through {@link Browser.targets}; this method
+   * instead resolves with the tab's child page target (the app's web contents).
+   * If Chromium focuses an existing app window, this returns that window's
+   * existing page.
+   */
+  abstract launchPWA(options: LaunchPWAOptions): Promise<Page>;
+  /**
+   * Returns the OS-integration state of an installed Progressive Web App (PWA),
+   * such as its badge count and registered file handlers.
+   *
+   * @remarks
+   *
+   * Only available over a pipe connection. See {@link Browser.installPWA}.
+   * Meaningful only for an app that is currently installed; querying an
+   * unknown manifest id rejects.
+   */
+  abstract getPWAState(options: GetPWAStateOptions): Promise<PWAState>;
   /**
    * Gets a list of {@link ScreenInfo | screen information objects}.
    */
@@ -591,6 +645,8 @@ export declare abstract class Browser extends EventEmitter<BrowserEvents> {
    * Whether Puppeteer is connected to this {@link Browser | browser}.
    */
   abstract get connected(): boolean;
+  [disposeSymbol](): void;
+  [asyncDisposeSymbol](): Promise<void>;
   /**
    * Get debug information from Puppeteer.
    *
@@ -788,6 +844,8 @@ export declare abstract class BrowserContext extends EventEmitter<BrowserContext
    * Identifier for this {@link BrowserContext | browser context}.
    */
   get id(): string | undefined;
+  [disposeSymbol](): void;
+  [asyncDisposeSymbol](): Promise<void>;
 }
 
 /**
@@ -2067,6 +2125,11 @@ export declare interface DeviceRequestPromptDevice {
  */
 export declare abstract class Dialog {
   #private;
+  /**
+   * A boolean value indicating whether the dialog has been handled.
+   */
+  get handled(): boolean;
+  protected set handled(handled: boolean);
   /**
    * The type of the dialog.
    */
@@ -2094,6 +2157,11 @@ export declare abstract class Dialog {
   dismiss(): Promise<void>;
 }
 
+/**
+ * @public
+ */
+export declare const disposeSymbol: typeof Symbol.dispose;
+
 /**
  * @public
  */
@@ -2794,6 +2862,8 @@ export declare class EventEmitter<
    * @returns `this` to enable you to chain method calls.
    */
   removeAllListeners(type?: keyof EventsWithWildcard<Events>): this;
+  [disposeSymbol](): void;
+  [asyncDisposeSymbol](): Promise<void>;
 }
 
 /**
@@ -3731,6 +3801,18 @@ export declare interface GeolocationOptions {
   accuracy?: number;
 }
 
+/**
+ * Options for {@link Browser.getPWAState}.
+ *
+ * @public
+ */
+export declare interface GetPWAStateOptions {
+  /**
+   * The id from the web app's manifest file.
+   */
+  manifestId: string;
+}
+
 /**
  * @public
  */
@@ -4157,6 +4239,37 @@ export declare type InnerParams<T extends unknown[]> = {
   [K in keyof T]: FlattenHandle<T[K]>;
 };
 
+/**
+ * Options for {@link Browser.installPWA}.
+ *
+ * @public
+ */
+export declare interface InstallPWAOptions {
+  /**
+   * The id from the web app's manifest file, commonly the URL of the site
+   * installing the web app. See
+   * {@link https://web.dev/learn/pwa/web-app-manifest | Web app manifest}.
+   */
+  manifestId: string;
+  /**
+   * The URL used to install the app, or the URL of its signed web bundle.
+   *
+   * This is required because the browser-scoped CDP session has no associated
+   * page from which Chromium could derive an install URL.
+   */
+  installUrlOrBundleUrl: string;
+  /**
+   * Whether the app should open in a standalone window or a browser tab.
+   *
+   * @remarks
+   *
+   * `PWA.install` alone leaves the app at Chromium's default display mode
+   * (`browser`); setting this chains a `PWA.changeAppUserSettings` call to apply
+   * the preference.
+   */
+  displayMode?: PWADisplayMode;
+}
+
 /**
  * @public
  */
@@ -4355,6 +4468,8 @@ export declare abstract class JSHandle<T = unknown> {
    * backing this handle.
    */
   abstract remoteObject(): Protocol.Runtime.RemoteObject;
+  [disposeSymbol](): void;
+  [asyncDisposeSymbol](): Promise<void>;
 }
 
 /**
@@ -5100,6 +5215,28 @@ export declare interface LaunchOptions extends ConnectOptions {
   signal?: AbortSignal;
 }
 
+/**
+ * Options for {@link Browser.launchPWA}.
+ *
+ * @public
+ */
+export declare interface LaunchPWAOptions {
+  /**
+   * The id from the web app's manifest file.
+   */
+  manifestId: string;
+  /**
+   * An optional URL within the app's scope to launch. Defaults to the app's
+   * start URL.
+   */
+  url?: string;
+  /**
+   * Maximum time in milliseconds to wait for the app's page target to appear.
+   * Defaults to 30 seconds. Pass `0` to disable the timeout.
+   */
+  timeout?: number;
+}
+
 /**
  * Locators describe a strategy of locating objects and performing an action on
  * them. If the action fails because the object is not ready for the action, the
@@ -5817,7 +5954,7 @@ export declare abstract class Page extends EventEmitter<PageEvents> {
   abstract get tracing(): Tracing;
   /**
    * Experimental API for {@link https://github.com/webmachinelearning/webmcp| WebMCP}.
-   * Requires Chrome 150+ with the `--enable-features=WebMCP` flag enabled.
+   * Requires Chrome 151+ with the `--enable-features=WebMCP` flag enabled.
    *
    * @experimental
    */
@@ -7560,6 +7697,8 @@ export declare abstract class Page extends EventEmitter<PageEvents> {
    * @experimental
    */
   abstract windowId(): Promise<WindowId>;
+  [disposeSymbol](): void;
+  [asyncDisposeSymbol](): Promise<void>;
   /**
    * Opens DevTools for the this page if not already open and returns the DevTools page.
    * This method is only available in Chrome.
@@ -8188,6 +8327,12 @@ declare namespace Puppeteer_2 {
     WorkAreaInsets,
     AddScreenParams,
     ExtensionInstallOptions,
+    PWADisplayMode,
+    InstallPWAOptions,
+    UninstallPWAOptions,
+    LaunchPWAOptions,
+    GetPWAStateOptions,
+    PWAState,
     BrowserContextEvents,
     CDPEvents,
     CDPSessionEvents,
@@ -8371,6 +8516,8 @@ declare namespace Puppeteer_2 {
     FileChooser,
     Puppeteer,
     SecurityDetails,
+    disposeSymbol,
+    asyncDisposeSymbol,
     BrowserLauncher,
     PuppeteerNode,
     ScreenRecorder,
@@ -8537,6 +8684,31 @@ export declare class PuppeteerNode extends Puppeteer {
   trimCache(): Promise<void>;
 }
 
+/**
+ * If the user prefers opening an installed web app in a standalone window or in
+ * a browser tab.
+ *
+ * @public
+ */
+export declare type PWADisplayMode = 'standalone' | 'browser';
+
+/**
+ * The OS-integration state of an installed web app, returned by
+ * {@link Browser.getPWAState}.
+ *
+ * @public
+ */
+export declare interface PWAState {
+  /**
+   * The current badge count shown on the app icon.
+   */
+  badgeCount: number;
+  /**
+   * The file handlers registered by the app with the OS.
+   */
+  fileHandlers: Protocol.PWA.FileHandler[];
+}
+
 /**
  * @public
  */
@@ -8682,6 +8854,7 @@ export declare abstract class Realm {
     },
     ...args: Params
   ): Promise<HandleFor<Awaited<ReturnType<Func>>>>;
+  [disposeSymbol](): void;
 }
 
 /**
@@ -8865,6 +9038,7 @@ export declare class ScreenRecorder extends PassThrough {
    * @public
    */
   stop(): Promise<void>;
+  [asyncDisposeSymbol](): Promise<void>;
 }
 
 /**
@@ -9338,6 +9512,18 @@ export declare interface TracingOptions {
   categories?: string[];
 }
 
+/**
+ * Options for {@link Browser.uninstallPWA}.
+ *
+ * @public
+ */
+export declare interface UninstallPWAOptions {
+  /**
+   * The id from the web app's manifest file.
+   */
+  manifestId: string;
+}
+
 /**
  * Puppeteer will throw this error if a method is not
  * supported by the currently used protocol

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

@@ -1,6 +1,6 @@
 {
   "name": "puppeteer-core",
-  "version": "25.3.0",
+  "version": "25.4.0",
   "description": "A high-level API to control headless Chrome over the DevTools Protocol",
   "keywords": [
     "puppeteer",
@@ -149,14 +149,14 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@puppeteer/browsers": "3.0.6",
-    "chromium-bidi": "16.0.1",
-    "devtools-protocol": "0.0.1638949",
+    "chromium-bidi": "17.0.2",
+    "devtools-protocol": "0.0.1653615",
     "typed-query-selector": "^2.12.2",
     "webdriver-bidi-protocol": "0.4.2",
-    "ws": "^8.21.0"
+    "ws": "^8.21.1"
   },
   "devDependencies": {
-    "@types/chrome": "0.2.0",
+    "@types/chrome": "0.2.2",
     "@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

@@ -334,6 +334,108 @@ export interface ExtensionInstallOptions {
   enabledInIncognito: boolean;
 }
 
+/**
+ * If the user prefers opening an installed web app in a standalone window or in
+ * a browser tab.
+ *
+ * @public
+ */
+export type PWADisplayMode = 'standalone' | 'browser';
+
+/**
+ * Options for {@link Browser.installPWA}.
+ *
+ * @public
+ */
+export interface InstallPWAOptions {
+  /**
+   * The id from the web app's manifest file, commonly the URL of the site
+   * installing the web app. See
+   * {@link https://web.dev/learn/pwa/web-app-manifest | Web app manifest}.
+   */
+  manifestId: string;
+  /**
+   * The URL used to install the app, or the URL of its signed web bundle.
+   *
+   * This is required because the browser-scoped CDP session has no associated
+   * page from which Chromium could derive an install URL.
+   */
+  installUrlOrBundleUrl: string;
+  /**
+   * Whether the app should open in a standalone window or a browser tab.
+   *
+   * @remarks
+   *
+   * `PWA.install` alone leaves the app at Chromium's default display mode
+   * (`browser`); setting this chains a `PWA.changeAppUserSettings` call to apply
+   * the preference.
+   */
+  displayMode?: PWADisplayMode;
+}
+
+/**
+ * Options for {@link Browser.uninstallPWA}.
+ *
+ * @public
+ */
+export interface UninstallPWAOptions {
+  /**
+   * The id from the web app's manifest file.
+   */
+  manifestId: string;
+}
+
+/**
+ * Options for {@link Browser.launchPWA}.
+ *
+ * @public
+ */
+export interface LaunchPWAOptions {
+  /**
+   * The id from the web app's manifest file.
+   */
+  manifestId: string;
+  /**
+   * An optional URL within the app's scope to launch. Defaults to the app's
+   * start URL.
+   */
+  url?: string;
+  /**
+   * Maximum time in milliseconds to wait for the app's page target to appear.
+   * Defaults to 30 seconds. Pass `0` to disable the timeout.
+   */
+  timeout?: number;
+}
+
+/**
+ * Options for {@link Browser.getPWAState}.
+ *
+ * @public
+ */
+export interface GetPWAStateOptions {
+  /**
+   * The id from the web app's manifest file.
+   */
+  manifestId: string;
+}
+
+/**
+ * The OS-integration state of an installed web app, returned by
+ * {@link Browser.getPWAState}.
+ *
+ * @public
+ */
+export interface PWAState {
+  /**
+   * The current badge count shown on the app icon.
+   */
+  badgeCount: number;
+  /**
+   * The file handlers registered by the app with the OS.
+   */
+  fileHandlers: Protocol.PWA.FileHandler[];
+}
+
 /**
  * {@link Browser} represents a browser instance that is either:
  *
@@ -662,6 +764,59 @@ export abstract class Browser extends EventEmitter<BrowserEvents> {
    */
   abstract uninstallExtension(id: string): Promise<void>;
 
+  /**
+   * Installs a Progressive Web App (PWA) and returns its manifest id.
+   *
+   * @remarks
+   *
+   * Only available when connected to the browser over a pipe connection. Set
+   * `pipe: true` in {@link PuppeteerNode.launch | puppeteer.launch}; the launch
+   * option defaults to `false`. The underlying `PWA` CDP domain is not exposed
+   * over a WebSocket connection.
+   *
+   * The returned manifest id echoes {@link InstallPWAOptions.manifestId}, so it
+   * can be passed directly to {@link Browser.launchPWA},
+   * {@link Browser.getPWAState}, or {@link Browser.uninstallPWA}.
+   */
+  abstract installPWA(options: InstallPWAOptions): Promise<string>;
+
+  /**
+   * Uninstalls a previously installed Progressive Web App (PWA).
+   *
+   * @remarks
+   *
+   * Only available over a pipe connection. See {@link Browser.installPWA}.
+   */
+  abstract uninstallPWA(options: UninstallPWAOptions): Promise<void>;
+
+  /**
+   * Launches an installed Progressive Web App (PWA) and resolves with the
+   * {@link Page | page} backing the app window.
+   *
+   * @remarks
+   *
+   * Only available over a pipe connection. See {@link Browser.installPWA}.
+   *
+   * `PWA.launch` resolves with the id of the launched _tab_ target. Puppeteer
+   * does not expose tab targets through {@link Browser.targets}; this method
+   * instead resolves with the tab's child page target (the app's web contents).
+   * If Chromium focuses an existing app window, this returns that window's
+   * existing page.
+   */
+  abstract launchPWA(options: LaunchPWAOptions): Promise<Page>;
+
+  /**
+   * Returns the OS-integration state of an installed Progressive Web App (PWA),
+   * such as its badge count and registered file handlers.
+   *
+   * @remarks
+   *
+   * Only available over a pipe connection. See {@link Browser.installPWA}.
+   * Meaningful only for an app that is currently installed; querying an
+   * unknown manifest id rejects.
+   */
+  abstract getPWAState(options: GetPWAStateOptions): Promise<PWAState>;
+
   /**
    * Gets a list of {@link ScreenInfo | screen information objects}.
    */
@@ -690,12 +845,10 @@ export abstract class Browser extends EventEmitter<BrowserEvents> {
    */
   abstract get connected(): boolean;
 
-  /** @internal */
   override [disposeSymbol](): void {
     return void this[asyncDisposeSymbol]().catch(debugCatchError);
   }
 
-  /** @internal */
   override async [asyncDisposeSymbol](): Promise<void> {
     if (this.process()) {
       await this.close();

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

@@ -371,12 +371,10 @@ export abstract class BrowserContext extends EventEmitter<BrowserContextEvents>
     return undefined;
   }
 
-  /** @internal */
   override [disposeSymbol](): void {
     return void this[asyncDisposeSymbol]().catch(debugCatchError);
   }
 
-  /** @internal */
   override async [asyncDisposeSymbol](): Promise<void> {
     await this.close();
     await super[asyncDisposeSymbol]();

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

@@ -34,10 +34,18 @@ export abstract class Dialog {
   #type: Protocol.Page.DialogType;
   #message: string;
   #defaultValue: string;
+  #handled = false;
+
   /**
-   * @internal
+   * A boolean value indicating whether the dialog has been handled.
    */
-  protected handled = false;
+  public get handled(): boolean {
+    return this.#handled;
+  }
+
+  protected set handled(handled: boolean) {
+    this.#handled = handled;
+  }
 
   /**
    * @internal

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

@@ -193,12 +193,10 @@ export abstract class JSHandle<T = unknown> {
    */
   abstract remoteObject(): Protocol.Runtime.RemoteObject;
 
-  /** @internal */
   [disposeSymbol](): void {
     return void this[asyncDisposeSymbol]().catch(debugCatchError);
   }
 
-  /** @internal */
   [asyncDisposeSymbol](): Promise<void> {
     return this.dispose();
   }

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

@@ -957,7 +957,7 @@ export abstract class Page extends EventEmitter<PageEvents> {
 
   /**
    * Experimental API for {@link https://github.com/webmachinelearning/webmcp| WebMCP}.
-   * Requires Chrome 150+ with the `--enable-features=WebMCP` flag enabled.
+   * Requires Chrome 151+ with the `--enable-features=WebMCP` flag enabled.
    *
    * @experimental
    */
@@ -3232,12 +3232,10 @@ export abstract class Page extends EventEmitter<PageEvents> {
    */
   abstract windowId(): Promise<WindowId>;
 
-  /** @internal */
   override [disposeSymbol](): void {
     return void this[asyncDisposeSymbol]().catch(debugCatchError);
   }
 
-  /** @internal */
   override async [asyncDisposeSymbol](): Promise<void> {
     await this.close();
     await super[asyncDisposeSymbol]();

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

@@ -199,7 +199,6 @@ export abstract class Realm {
     );
   }
 
-  /** @internal */
   [disposeSymbol](): void {
     this.dispose();
   }

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

@@ -15,8 +15,10 @@ import type {Handler} from '../common/EventEmitter.js';
 
 import {BidiConnection} from './Connection.js';
 
-const bidiServerLogger = (prefix: string, ...args: unknown[]): void => {
-  debug(`bidi:${prefix}`)?.(args);
+const bidiServerLogger = (
+  prefix: string,
+): ((...args: unknown[]) => void) | undefined => {
+  return debug(`bidi:${prefix}`);
 };
 
 /**

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

@@ -19,6 +19,7 @@ import {
   type WindowBounds,
   type WindowId,
   type DebugInfo,
+  type PWAState,
 } from '../api/Browser.js';
 import {BrowserContextEvent} from '../api/BrowserContext.js';
 import type {Extension} from '../api/Extension.js';
@@ -297,6 +298,22 @@ export class BidiBrowser extends Browser {
     await this.#browserCore.uninstallExtension(id);
   }
 
+  override installPWA(): Promise<string> {
+    throw new UnsupportedOperation();
+  }
+
+  override uninstallPWA(): Promise<void> {
+    throw new UnsupportedOperation();
+  }
+
+  override launchPWA(): Promise<Page> {
+    throw new UnsupportedOperation();
+  }
+
+  override getPWAState(): Promise<PWAState> {
+    throw new UnsupportedOperation();
+  }
+
   override screens(): Promise<ScreenInfo[]> {
     throw new UnsupportedOperation();
   }

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

@@ -102,10 +102,11 @@ export class BidiHTTPResponse extends HTTPResponse {
       // https://w3c.github.io/webdriver-bidi/#type-network-Header
       if (header.value.type === 'string') {
         const headerName = header.name.toLowerCase();
-        headers[headerName] = normalizeHeaderValue(
-          headerName,
-          header.value.value,
-        );
+        const value =
+          headerName in headers
+            ? `${headers[headerName]}\n${header.value.value}`
+            : header.value.value;
+        headers[headerName] = normalizeHeaderValue(headerName, value);
       }
     }
     return headers;