chrome-devtools-frontend 1.0.1652307 → 1.0.1656291

package/front_end/third_party/puppeteer/package/lib/puppeteer/util/httpUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"httpUtils.js","sourceRoot":"","sources":["../../../src/util/httpUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,MAAM;SACV,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE;QACP,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAClB,CAAC,CAAC;SACD,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}
+{"version":3,"file":"httpUtils.js","sourceRoot":"","sources":["../../../src/util/httpUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,KAAa;IAC9D,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,KAAK;SACT,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE;QACP,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAClB,CAAC,CAAC;SACD,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAChD,CAAC"}

package/front_end/third_party/puppeteer/package/lib/puppeteer/util/version.d.ts

@@ -3,5 +3,5 @@
  * Copyright 2025 Google Inc.
  * SPDX-License-Identifier: Apache-2.0
  */
-export declare const packageVersion = "25.2.1";
+export declare const packageVersion = "25.3.0";
 //# sourceMappingURL=version.d.ts.map

package/front_end/third_party/puppeteer/package/lib/puppeteer/util/version.js

@@ -5,6 +5,6 @@
  */
 // If moved update release-please config
 // x-release-please-start-version
-export const packageVersion = '25.2.1';
+export const packageVersion = '25.3.0';
 // x-release-please-end
 //# sourceMappingURL=version.js.map

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

@@ -559,7 +559,10 @@ export declare abstract class Browser extends EventEmitter<BrowserEvents> {
   /**
    * Installs an extension and returns the ID.
    */
-  abstract installExtension(path: string): Promise<string>;
+  abstract installExtension(
+    path: string,
+    options?: ExtensionInstallOptions,
+  ): Promise<string>;
   /**
    * Uninstalls an extension.
    */
@@ -919,7 +922,9 @@ export declare abstract class BrowserLauncher {
  * @public
  */
 export declare type CDPEvents = {
-  [Property in keyof ProtocolMapping.Events]: ProtocolMapping.Events[Property][0];
+  [
+    Property in keyof ProtocolMapping.Events
+  ]: ProtocolMapping.Events[Property][0];
 };
 
 /**
@@ -1042,10 +1047,7 @@ export declare interface ChromeHeadlessShellSettings {
  * @public
  */
 export declare type ChromeReleaseChannel =
-  | 'chrome'
-  | 'chrome-beta'
-  | 'chrome-canary'
-  | 'chrome-dev';
+  'chrome' | 'chrome-beta' | 'chrome-canary' | 'chrome-dev';
 
 /**
  * @public
@@ -2122,10 +2124,7 @@ export declare interface DownloadBehavior {
  * @public
  */
 export declare type DownloadPolicy =
-  | 'deny'
-  | 'allow'
-  | 'allowAndName'
-  | 'default';
+  'deny' | 'allow' | 'allowAndName' | 'default';
 
 /**
  * @public
@@ -2910,6 +2909,16 @@ export declare abstract class Extension {
   abstract triggerAction(page: Page): Promise<void>;
 }
 
+/**
+ * @public
+ */
+export declare interface ExtensionInstallOptions {
+  /**
+   * Whether to enable the extension in Incognito or OTR profiles in Chrome.
+   */
+  enabledInIncognito: boolean;
+}
+
 /**
  * Experimental ExtensionTransport allows establishing a connection via
  * chrome.debugger API if Puppeteer runs in an extension. Since Chrome
@@ -4069,8 +4078,9 @@ export declare abstract class HTTPResponse {
    */
   abstract statusText(): string;
   /**
-   * An object with HTTP headers associated with the response. All
-   * header names are lower-case.
+   * An object with HTTP headers associated with the response. All header names
+   * are lower-case. Duplicate header values are combined into a single
+   * comma-separated list except for `Set-Cookie` that is separated by `\n`.
    */
   abstract headers(): Record<string, string>;
   /**
@@ -4989,6 +4999,11 @@ export declare interface LaunchOptions extends ConnectOptions {
    * load the provided paths as unpacked extensions.
    */
   enableExtensions?: boolean | string[];
+  /**
+   * List of extensions that will be enable in Incognito and off-the-record
+   * profiles.
+   */
+  extensionsEnabledInIncognito?: string[];
   /**
    * Close the browser process on `Ctrl+C`.
    * @defaultValue `true`
@@ -8046,8 +8061,7 @@ export declare const PredefinedNetworkConditions: Readonly<{
  * @public
  */
 export declare type Predicate<From, To extends From = From> =
-  | ((value: From) => value is To)
-  | ((value: From) => Awaitable<boolean>);
+  ((value: From) => value is To) | ((value: From) => Awaitable<boolean>);
 
 export {Protocol};
 
@@ -8076,10 +8090,7 @@ export declare class ProtocolError extends PuppeteerError {
  * @public
  */
 export declare type ProtocolLifeCycleEvent =
-  | 'load'
-  | 'DOMContentLoaded'
-  | 'networkIdle'
-  | 'networkAlmostIdle';
+  'load' | 'DOMContentLoaded' | 'networkIdle' | 'networkAlmostIdle';
 
 /**
  * @public
@@ -8176,6 +8187,7 @@ declare namespace Puppeteer_2 {
     ScreenInfo,
     WorkAreaInsets,
     AddScreenParams,
+    ExtensionInstallOptions,
     BrowserContextEvents,
     CDPEvents,
     CDPSessionEvents,
@@ -8250,8 +8262,6 @@ declare namespace Puppeteer_2 {
     NetworkConditions,
     InternalNetworkConditions,
     TracingOptions,
-    WebMCPAnnotation,
-    WebMCPInvocationStatus,
     WebMCPToolsAddedEvent,
     WebMCPToolsRemovedEvent,
     WebMCPToolCallResult,
@@ -9148,7 +9158,7 @@ export declare type SupportedWebDriverCapability = Exclude<
 /**
  * Target represents a
  * {@link https://chromedevtools.github.io/devtools-protocol/tot/Target/ | CDP target}.
- * In CDP a target is something that can be debugged such a frame, a page or a
+ * In CDP a target is something that can be debugged, such as a frame, a page or a
  * worker.
  * @public
  */
@@ -9551,34 +9561,6 @@ export declare class WebMCP extends EventEmitter<{
   tools(): WebMCPTool[];
 }
 
-/**
- * Tool annotations
- *
- * @public
- */
-export declare interface WebMCPAnnotation {
-  /**
-   * A hint indicating that the tool does not modify any state.
-   */
-  readOnly?: boolean;
-  /**
-   * A hint indicating that the tool output may contain untrusted content, ex: UGC, 3rd
-   * party data.
-   */
-  untrustedContent?: boolean;
-  /**
-   * If the declarative tool was declared with the autosubmit attribute.
-   */
-  autosubmit?: boolean;
-}
-
-/**
- * Represents the status of a tool invocation.
- *
- * @public
- */
-export declare type WebMCPInvocationStatus = 'Completed' | 'Canceled' | 'Error';
-
 /**
  * Represents a registered WebMCP tool available on the page.
  *
@@ -9604,7 +9586,7 @@ export declare class WebMCPTool extends EventEmitter<{
   /**
    * Optional annotations for the tool.
    */
-  annotations?: WebMCPAnnotation;
+  annotations?: Protocol.WebMCP.Annotation;
   /**
    * Frame the tool was defined for.
    */
@@ -9656,7 +9638,7 @@ export declare interface WebMCPToolCallResult {
   /**
    * Status of the invocation.
    */
-  status: WebMCPInvocationStatus;
+  status: Protocol.WebMCP.InvocationStatus;
   /**
    * Output or error delivered as delivered to the agent. Missing if `status` is anything
    * other than Completed.
@@ -9843,10 +9825,7 @@ export declare type WindowId = string;
  * @public
  */
 export declare type WindowState =
-  | 'normal'
-  | 'minimized'
-  | 'maximized'
-  | 'fullscreen';
+  'normal' | 'minimized' | 'maximized' | 'fullscreen';
 
 /**
  * @public

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

@@ -1,6 +1,6 @@
 {
   "name": "puppeteer-core",
-  "version": "25.2.1",
+  "version": "25.3.0",
   "description": "A high-level API to control headless Chrome over the DevTools Protocol",
   "keywords": [
     "puppeteer",
@@ -148,7 +148,7 @@
   "author": "The Chromium Authors",
   "license": "Apache-2.0",
   "dependencies": {
-    "@puppeteer/browsers": "3.0.5",
+    "@puppeteer/browsers": "3.0.6",
     "chromium-bidi": "16.0.1",
     "devtools-protocol": "0.0.1638949",
     "typed-query-selector": "^2.12.2",
@@ -156,11 +156,11 @@
     "ws": "^8.21.0"
   },
   "devDependencies": {
-    "@types/chrome": "0.1.43",
+    "@types/chrome": "0.2.0",
     "@types/node": "^18.17.15",
     "@types/ws": "8.18.1",
     "mitt": "3.0.1",
-    "parsel-js": "1.2.2",
+    "parsel-js": "1.2.3",
     "rxjs": "^7.8.2",
     "urlpattern-polyfill": "10.1.0"
   }

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

@@ -324,6 +324,15 @@ export interface AddScreenParams {
   label?: string;
   isInternal?: boolean;
 }
+/**
+ * @public
+ */
+export interface ExtensionInstallOptions {
+  /**
+   * Whether to enable the extension in Incognito or OTR profiles in Chrome.
+   */
+  enabledInIncognito: boolean;
+}
 
 /**
  * {@link Browser} represents a browser instance that is either:
@@ -643,7 +652,10 @@ export abstract class Browser extends EventEmitter<BrowserEvents> {
   /**
    * Installs an extension and returns the ID.
    */
-  abstract installExtension(path: string): Promise<string>;
+  abstract installExtension(
+    path: string,
+    options?: ExtensionInstallOptions,
+  ): Promise<string>;
 
   /**
    * Uninstalls an extension.

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

@@ -125,7 +125,7 @@ export abstract class BrowserContext extends EventEmitter<BrowserContextEvents>
   abstract targets(): Target[];
 
   /**
-   * If defined, indicates an ongoing screenshot opereation.
+   * If defined, indicates an ongoing screenshot operation.
    */
   #pageScreenshotMutex?: Mutex;
   #screenshotOperationsCount = 0;
@@ -150,8 +150,7 @@ export abstract class BrowserContext extends EventEmitter<BrowserContextEvents>
    * @internal
    */
   waitForScreenshotOperations():
-    | Promise<InstanceType<typeof Mutex.Guard>>
-    | undefined {
+    Promise<InstanceType<typeof Mutex.Guard>> | undefined {
     return this.#pageScreenshotMutex?.acquire();
   }
 

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

@@ -12,7 +12,9 @@ import {EventEmitter, type EventType} from '../common/EventEmitter.js';
  * @public
  */
 export type CDPEvents = {
-  [Property in keyof ProtocolMapping.Events]: ProtocolMapping.Events[Property][0];
+  [
+    Property in keyof ProtocolMapping.Events
+  ]: ProtocolMapping.Events[Property][0];
 };
 
 /**

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

@@ -63,8 +63,9 @@ export abstract class HTTPResponse {
   abstract statusText(): string;
 
   /**
-   * An object with HTTP headers associated with the response. All
-   * header names are lower-case.
+   * An object with HTTP headers associated with the response. All header names
+   * are lower-case. Duplicate header values are combined into a single
+   * comma-separated list except for `Set-Cookie` that is separated by `\n`.
    */
   abstract headers(): Record<string, string>;
 

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

@@ -176,8 +176,7 @@ export abstract class Realm {
         signal,
       },
       pageFunction as unknown as
-        | ((...args: unknown[]) => Promise<Awaited<ReturnType<Func>>>)
-        | string,
+        ((...args: unknown[]) => Promise<Awaited<ReturnType<Func>>>) | string,
       ...args,
     );
     return await waitTask.result;

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

@@ -30,7 +30,7 @@ export enum TargetType {
 /**
  * Target represents a
  * {@link https://chromedevtools.github.io/devtools-protocol/tot/Target/ | CDP target}.
- * In CDP a target is something that can be debugged such a frame, a page or a
+ * In CDP a target is something that can be debugged, such as a frame, a page or a
  * worker.
  * @public
  */

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

@@ -862,8 +862,7 @@ export class FunctionLocator<T> extends Locator<T> {
  * @public
  */
 export type Predicate<From, To extends From = From> =
-  | ((value: From) => value is To)
-  | ((value: From) => Awaitable<boolean>);
+  ((value: From) => value is To) | ((value: From) => Awaitable<boolean>);
 /**
  * @internal
  */

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

@@ -101,7 +101,9 @@ export class BidiHTTPResponse extends HTTPResponse {
       // TODO: How to handle Binary Headers
       // https://w3c.github.io/webdriver-bidi/#type-network-Header
       if (header.value.type === 'string') {
-        headers[header.name.toLowerCase()] = normalizeHeaderValue(
+        const headerName = header.name.toLowerCase();
+        headers[headerName] = normalizeHeaderValue(
+          headerName,
           header.value.value,
         );
       }

package/front_end/third_party/puppeteer/package/src/bidi/core/Realm.ts

@@ -231,9 +231,7 @@ export class WindowRealm extends Realm {
  * @internal
  */
 export type DedicatedWorkerOwnerRealm =
-  | DedicatedWorkerRealm
-  | SharedWorkerRealm
-  | WindowRealm;
+  DedicatedWorkerRealm | SharedWorkerRealm | WindowRealm;
 
 /**
  * @internal

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

@@ -8,7 +8,11 @@ import type {ChildProcess} from 'node:child_process';
 
 import type {Protocol} from 'devtools-protocol';
 
-import type {CreatePageOptions, DebugInfo} from '../api/Browser.js';
+import type {
+  CreatePageOptions,
+  DebugInfo,
+  ExtensionInstallOptions,
+} from '../api/Browser.js';
 import {
   Browser as BrowserBase,
   BrowserEvent,
@@ -477,8 +481,14 @@ export class CdpBrowser extends BrowserBase {
     return response.targetId;
   }
 
-  override async installExtension(path: string): Promise<string> {
-    const {id} = await this.#connection.send('Extensions.loadUnpacked', {path});
+  override async installExtension(
+    path: string,
+    options?: ExtensionInstallOptions,
+  ): Promise<string> {
+    const {id} = await this.#connection.send('Extensions.loadUnpacked', {
+      path,
+      enableInIncognito: options?.enabledInIncognito ?? false,
+    });
     this.#extensions.delete(id);
     return id;
   }

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

@@ -459,7 +459,7 @@ export function referrerPolicyToProtocol(
 ): Protocol.Page.ReferrerPolicy {
   // See
   // https://chromedevtools.github.io/devtools-protocol/tot/Page/#type-ReferrerPolicy
-  // We need to conver from Web-facing phase to CDP's camelCase.
+  // We need to convert from Web-facing phase to CDP's camelCase.
   return referrerPolicy.replaceAll(/-./g, match => {
     return match[1]!.toUpperCase();
   }) as Protocol.Page.ReferrerPolicy;

package/front_end/third_party/puppeteer/package/src/cdp/FrameManager.ts

@@ -39,7 +39,6 @@ import {NetworkManager} from './NetworkManager.js';
 import type {CdpPage} from './Page.js';
 import type {CdpTarget} from './Target.js';
 
-const TIME_FOR_WAITING_FOR_SWAP = 100; // ms.
 const CHROME_EXTENSION_PREFIX = 'chrome-extension://';
 /**
  * A frame manager manages the frames for a given {@link Page | page}.
@@ -98,7 +97,7 @@ export class FrameManager extends EventEmitter<FrameManagerEvents> {
     this.#timeoutSettings = timeoutSettings;
     this.setupEventListeners(this.#client);
     client.once(CDPSessionEvent.Disconnected, () => {
-      void this.#onClientDisconnect().catch(debugCatchError);
+      void this.#onClientDisconnect(client).catch(debugCatchError);
     });
   }
 
@@ -107,15 +106,21 @@ export class FrameManager extends EventEmitter<FrameManagerEvents> {
    * disconnect means that the frame is removed or if it will be replaced by a
    * new frame. Therefore, we wait for a swap event.
    */
-  async #onClientDisconnect() {
+  async #onClientDisconnect(client: CdpCDPSession) {
     const mainFrame = this._frameTree.getMainFrame();
     if (!mainFrame) {
       return;
     }
 
-    if (!this.#page.browser().connected) {
-      // If the browser is not connected we know
-      // that activation will not happen
+    // If the disconnected client is not the current one, it means a swap
+    // has already happened.
+    if (this.#client !== client) {
+      return;
+    }
+
+    if (!this.#page.browser().connected || this.#page.isClosed()) {
+      // If the browser is not connected or the page is closed, we know
+      // that activation will not happen.
       this.#removeFramesRecursively(mainFrame);
       return;
     }
@@ -123,17 +128,23 @@ export class FrameManager extends EventEmitter<FrameManagerEvents> {
     for (const child of mainFrame.childFrames()) {
       this.#removeFramesRecursively(child);
     }
-    const swapped = Deferred.create<void>({
-      timeout: TIME_FOR_WAITING_FOR_SWAP,
-      message: 'Frame was not swapped',
-    });
-    mainFrame.once(FrameEvent.FrameSwappedByActivation, () => {
+    const swapped = Deferred.create<void>();
+    const onFrameSwapped = () => {
       swapped.resolve();
-    });
+    };
+    const onPageClosed = () => {
+      swapped.reject(new Error('Page closed'));
+    };
+    mainFrame.once(FrameEvent.FrameSwappedByActivation, onFrameSwapped);
+    this.#page.once(PageEvent.Close, onPageClosed);
+
     try {
       await swapped.valueOrThrow();
     } catch {
       this.#removeFramesRecursively(mainFrame);
+    } finally {
+      mainFrame.off(FrameEvent.FrameSwappedByActivation, onFrameSwapped);
+      this.#page.off(PageEvent.Close, onPageClosed);
     }
   }
 
@@ -154,7 +165,7 @@ export class FrameManager extends EventEmitter<FrameManagerEvents> {
     }
     this.setupEventListeners(client);
     client.once(CDPSessionEvent.Disconnected, () => {
-      void this.#onClientDisconnect().catch(debugCatchError);
+      void this.#onClientDisconnect(client).catch(debugCatchError);
     });
     await this.initialize(client, frame);
     await this.#networkManager.addClient(client);

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

@@ -52,7 +52,10 @@ export class CdpHTTPResponse extends HTTPResponse {
     this.#status = extraInfo ? extraInfo.statusCode : responsePayload.status;
     const headers = extraInfo ? extraInfo.headers : responsePayload.headers;
     for (const [key, value] of Object.entries(headers)) {
-      this.#headers[key.toLowerCase()] = normalizeHeaderValue(value);
+      const headerName = key.toLowerCase();
+      // See https://www.rfc-editor.org/rfc/rfc9110.html#name-field-order for
+      // the set-cookie exception.
+      this.#headers[headerName] = normalizeHeaderValue(headerName, value);
     }
 
     this.#securityDetails = responsePayload.securityDetails

package/front_end/third_party/puppeteer/package/src/cdp/Input.ts

@@ -292,7 +292,7 @@ export class CdpMouse extends Mouse {
     return Object.assign({...this.#_state}, ...this.#transactions);
   }
 
-  // Transactions can run in parallel, so we store each of thme in this array.
+  // Transactions can run in parallel, so we store each of them in this array.
   #transactions: Array<Partial<MouseState>> = [];
   #createTransaction(): {
     update: (updates: Partial<MouseState>) => void;

package/front_end/third_party/puppeteer/package/src/cdp/LifecycleWatcher.ts

@@ -47,10 +47,7 @@ export type PuppeteerLifeCycleEvent =
  * @public
  */
 export type ProtocolLifeCycleEvent =
-  | 'load'
-  | 'DOMContentLoaded'
-  | 'networkIdle'
-  | 'networkAlmostIdle';
+  'load' | 'DOMContentLoaded' | 'networkIdle' | 'networkAlmostIdle';
 
 const puppeteerToProtocolLifecycle = new Map<
   PuppeteerLifeCycleEvent,

package/front_end/third_party/puppeteer/package/src/cdp/Target.ts

@@ -36,8 +36,7 @@ export class CdpTarget extends Target {
   #targetInfo: Protocol.Target.TargetInfo;
   #targetManager?: TargetManager;
   #sessionFactory:
-    | ((isAutoAttachEmulated: boolean) => Promise<CdpCDPSession>)
-    | undefined;
+    ((isAutoAttachEmulated: boolean) => Promise<CdpCDPSession>) | undefined;
   #childTargets = new Set<CdpTarget>();
   _initializedDeferred = Deferred.create<InitializationStatus>();
   _isClosedDeferred = Deferred.create<void>();
@@ -57,8 +56,7 @@ export class CdpTarget extends Target {
     browserContext: BrowserContext | undefined,
     targetManager: TargetManager | undefined,
     sessionFactory:
-      | ((isAutoAttachEmulated: boolean) => Promise<CdpCDPSession>)
-      | undefined,
+      ((isAutoAttachEmulated: boolean) => Promise<CdpCDPSession>) | undefined,
   ) {
     super();
     this.#session = session;