chrome-devtools-frontend 1.0.1386602 → 1.0.1418433

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

@@ -322,6 +322,33 @@ export declare abstract class Browser extends EventEmitter<BrowserEvents> {
      * process running.
      */
     abstract disconnect(): Promise<void>;
+    /**
+     * Returns all cookies in the default {@link BrowserContext}.
+     *
+     * @remarks
+     *
+     * Shortcut for
+     * {@link BrowserContext.cookies | browser.defaultBrowserContext().cookies()}.
+     */
+    cookies(): Promise<Cookie[]>;
+    /**
+     * Sets cookies in the default {@link BrowserContext}.
+     *
+     * @remarks
+     *
+     * Shortcut for
+     * {@link BrowserContext.setCookie | browser.defaultBrowserContext().setCookie()}.
+     */
+    setCookie(...cookies: Cookie[]): Promise<void>;
+    /**
+     * Removes cookies from the default {@link BrowserContext}.
+     *
+     * @remarks
+     *
+     * Shortcut for
+     * {@link BrowserContext.deleteCookie | browser.defaultBrowserContext().deleteCookie()}.
+     */
+    deleteCookie(...cookies: Cookie[]): Promise<void>;
     /**
      * Whether Puppeteer is connected to this {@link Browser | browser}.
      *
@@ -348,57 +375,6 @@ export declare abstract class Browser extends EventEmitter<BrowserEvents> {
     abstract get debugInfo(): DebugInfo;
 }
 
-/**
- * Generic browser options that can be passed when launching any browser or when
- * connecting to an existing browser instance.
- * @public
- */
-export declare interface BrowserConnectOptions {
-    /**
-     * Whether to ignore HTTPS errors during navigation.
-     * @defaultValue `false`
-     */
-    acceptInsecureCerts?: boolean;
-    /**
-     * Sets the viewport for each page.
-     *
-     * @defaultValue '\{width: 800, height: 600\}'
-     */
-    defaultViewport?: Viewport | null;
-    /**
-     * Sets the download behavior for the context.
-     */
-    downloadBehavior?: DownloadBehavior;
-    /**
-     * Slows down Puppeteer operations by the specified amount of milliseconds to
-     * aid debugging.
-     */
-    slowMo?: number;
-    /**
-     * Callback to decide if Puppeteer should connect to a given target or not.
-     */
-    targetFilter?: TargetFilterCallback;
-
-    /**
-     * @defaultValue Determined at run time:
-     *
-     * - Launching Chrome - 'cdp'.
-     *
-     * - Launching Firefox - 'webDriverBiDi'.
-     *
-     * - Connecting to a browser - 'cdp'.
-     *
-     * @public
-     */
-    protocol?: ProtocolType;
-    /**
-     * Timeout setting for individual protocol (CDP) calls.
-     *
-     * @defaultValue `180_000`
-     */
-    protocolTimeout?: number;
-}
-
 /**
  * {@link BrowserContext} represents individual user contexts within a
  * {@link Browser | browser}.
@@ -525,6 +501,19 @@ export declare abstract class BrowserContext extends EventEmitter<BrowserContext
      * closed.
      */
     abstract close(): Promise<void>;
+    /**
+     * Gets all cookies in the browser context.
+     */
+    abstract cookies(): Promise<Cookie[]>;
+    /**
+     * Sets a cookie in the browser context.
+     */
+    abstract setCookie(...cookies: CookieData[]): Promise<void>;
+    /**
+     * Removes cookie in the browser context
+     * @param cookies - {@link Cookie | cookie} to remove
+     */
+    deleteCookie(...cookies: Cookie[]): Promise<void>;
     /**
      * Whether this {@link BrowserContext | browser context} is closed.
      */
@@ -648,50 +637,6 @@ export declare interface BrowserEvents extends Record<EventType, unknown> {
 
 }
 
-/**
- * Launcher options that only apply to Chrome.
- *
- * @public
- */
-export declare interface BrowserLaunchArgumentOptions {
-    /**
-     * Whether to run the browser in headless mode.
-     *
-     * @remarks
-     *
-     * - `true` launches the browser in the
-     *   {@link https://developer.chrome.com/articles/new-headless/ | new headless}
-     *   mode.
-     *
-     * - `'shell'` launches
-     *   {@link https://developer.chrome.com/blog/chrome-headless-shell | shell}
-     *   known as the old headless mode.
-     *
-     * @defaultValue `true`
-     */
-    headless?: boolean | 'shell';
-    /**
-     * Path to a user data directory.
-     * {@link https://chromium.googlesource.com/chromium/src/+/refs/heads/main/docs/user_data_dir.md | see the Chromium docs}
-     * for more info.
-     */
-    userDataDir?: string;
-    /**
-     * Whether to auto-open a DevTools panel for each tab. If this is set to
-     * `true`, then `headless` will be forced to `false`.
-     * @defaultValue `false`
-     */
-    devtools?: boolean;
-    /**
-     * Specify the debugging port number to use
-     */
-    debuggingPort?: number;
-    /**
-     * Additional command line arguments to pass to the browser instance.
-     */
-    args?: string[];
-}
-
 /**
  * Describes a launcher - a class that is able to create and launch a browser instance.
  *
@@ -702,9 +647,9 @@ export declare abstract class BrowserLauncher {
 
 
     get browser(): SupportedBrowser;
-    launch(options?: PuppeteerNodeLaunchOptions): Promise<Browser>;
-    abstract executablePath(channel?: ChromeReleaseChannel): string;
-    abstract defaultArgs(object: BrowserLaunchArgumentOptions): string[];
+    launch(options?: LaunchOptions): Promise<Browser>;
+    abstract executablePath(channel?: ChromeReleaseChannel, validatePath?: boolean): string;
+    abstract defaultArgs(object: LaunchOptions): string[];
 
 
 
@@ -986,7 +931,7 @@ connect: (options: Puppeteer_2.ConnectOptions) => Promise<Puppeteer_2.Browser>;
  */
 export declare class Connection extends EventEmitter<CDPSessionEvents> {
     #private;
-    constructor(url: string, transport: ConnectionTransport, delay?: number, timeout?: number);
+    constructor(url: string, transport: ConnectionTransport, delay?: number, timeout?: number, rawErrors?: boolean);
     static fromSession(session: CDPSession): Connection | undefined;
 
     get timeout(): number;
@@ -1029,9 +974,54 @@ export declare interface ConnectionTransport {
 }
 
 /**
+ * Generic browser options that can be passed when launching any browser or when
+ * connecting to an existing browser instance.
  * @public
  */
-export declare interface ConnectOptions extends BrowserConnectOptions {
+export declare interface ConnectOptions {
+    /**
+     * Whether to ignore HTTPS errors during navigation.
+     * @defaultValue `false`
+     */
+    acceptInsecureCerts?: boolean;
+    /**
+     * Sets the viewport for each page.
+     *
+     * @defaultValue '\{width: 800, height: 600\}'
+     */
+    defaultViewport?: Viewport | null;
+    /**
+     * Sets the download behavior for the context.
+     */
+    downloadBehavior?: DownloadBehavior;
+    /**
+     * Slows down Puppeteer operations by the specified amount of milliseconds to
+     * aid debugging.
+     */
+    slowMo?: number;
+    /**
+     * Callback to decide if Puppeteer should connect to a given target or not.
+     */
+    targetFilter?: TargetFilterCallback;
+
+    /**
+     * @defaultValue Determined at run time:
+     *
+     * - Launching Chrome - 'cdp'.
+     *
+     * - Launching Firefox - 'webDriverBiDi'.
+     *
+     * - Connecting to a browser - 'cdp'.
+     *
+     * @public
+     */
+    protocol?: ProtocolType;
+    /**
+     * Timeout setting for individual protocol (CDP) calls.
+     *
+     * @defaultValue `180_000`
+     */
+    protocolTimeout?: number;
     browserWSEndpoint?: string;
     browserURL?: string;
     transport?: ConnectionTransport;
@@ -1116,6 +1106,8 @@ export declare interface ContinueRequestOverrides {
     headers?: Record<string, string>;
 }
 
+export declare function convertCookiesPartitionKeyFromPuppeteerToCdp(partitionKey: CookiePartitionKey | string | undefined): Protocol.Network.CookiePartitionKey | undefined;
+
 /**
  * Represents a cookie object.
  *
@@ -1181,7 +1173,7 @@ export declare interface Cookie {
      * source origin
      * (https://w3c.github.io/webdriver-bidi/#type-storage-PartitionKey).
      */
-    partitionKey?: string;
+    partitionKey?: CookiePartitionKey | string;
     /**
      * True if cookie partition key is opaque. Supported only in Chrome.
      */
@@ -1189,7 +1181,68 @@ export declare interface Cookie {
 }
 
 /**
- * Cookie parameter object
+ * Cookie parameter object used to set cookies in the browser-level cookies
+ * API.
+ *
+ * @public
+ */
+export declare interface CookieData {
+    /**
+     * Cookie name.
+     */
+    name: string;
+    /**
+     * Cookie value.
+     */
+    value: string;
+    /**
+     * Cookie domain.
+     */
+    domain: string;
+    /**
+     * Cookie path.
+     */
+    path?: string;
+    /**
+     * True if cookie is secure.
+     */
+    secure?: boolean;
+    /**
+     * True if cookie is http-only.
+     */
+    httpOnly?: boolean;
+    /**
+     * Cookie SameSite type.
+     */
+    sameSite?: CookieSameSite;
+    /**
+     * Cookie expiration date, session cookie if not set
+     */
+    expires?: number;
+    /**
+     * Cookie Priority. Supported only in Chrome.
+     */
+    priority?: CookiePriority;
+    /**
+     * True if cookie is SameParty. Supported only in Chrome.
+     */
+    sameParty?: boolean;
+    /**
+     * Cookie source scheme type. Supported only in Chrome.
+     */
+    sourceScheme?: CookieSourceScheme;
+    /**
+     * Cookie partition key. In Chrome, it matches the top-level site the
+     * partitioned cookie is available in. In Firefox, it matches the
+     * source origin
+     * (https://w3c.github.io/webdriver-bidi/#type-storage-PartitionKey).
+     */
+    partitionKey?: CookiePartitionKey | string;
+}
+
+/**
+ * Cookie parameter object used to set cookies in the page-level cookies
+ * API.
  *
  * @public
  */
@@ -1249,7 +1302,29 @@ export declare interface CookieParam {
      * source origin
      * (https://w3c.github.io/webdriver-bidi/#type-storage-PartitionKey).
      */
-    partitionKey?: string;
+    partitionKey?: CookiePartitionKey | string;
+}
+
+/**
+ * Represents a cookie partition key in Chrome.
+ *
+ * @public
+ */
+export declare interface CookiePartitionKey {
+    /**
+     * The site of the top-level URL the browser was visiting at the start of the request
+     * to the endpoint that set the cookie.
+     *
+     * In Chrome, maps to the CDP's `topLevelSite` partition key.
+     */
+    sourceOrigin: string;
+    /**
+     * Indicates if the cookie has any ancestors that are cross-site to
+     * the topLevelSite.
+     *
+     * Supported only in Chrome.
+     */
+    hasCrossSiteAncestor?: boolean;
 }
 
 /**
@@ -1481,7 +1556,7 @@ export declare const
 /**
  * @public
  */
-defaultArgs: (options?: Puppeteer_2.BrowserLaunchArgumentOptions) => string[];
+defaultArgs: (options?: Puppeteer_2.LaunchOptions) => string[];
 
 /**
  * @public
@@ -1510,7 +1585,7 @@ export declare interface DeleteCookiesRequest {
      * cookie is available in. In Firefox, it matches the source origin
      * (https://w3c.github.io/webdriver-bidi/#type-storage-PartitionKey).
      */
-    partitionKey?: string;
+    partitionKey?: CookiePartitionKey | string;
 }
 
 /**
@@ -1736,7 +1811,7 @@ export declare abstract class ElementHandle<ElementType extends Node = Element>
      * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | CSS selectors}
      * can be passed as-is and a
      * {@link https://pptr.dev/guides/page-interactions#non-css-selectors | Puppeteer-specific selector syntax}
-     * allows quering by
+     * allows querying by
      * {@link https://pptr.dev/guides/page-interactions#text-selectors--p-text | text},
      * {@link https://pptr.dev/guides/page-interactions#aria-selectors--p-aria | a11y role and name},
      * and
@@ -1758,7 +1833,7 @@ export declare abstract class ElementHandle<ElementType extends Node = Element>
      * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | CSS selectors}
      * can be passed as-is and a
      * {@link https://pptr.dev/guides/page-interactions#non-css-selectors | Puppeteer-specific selector syntax}
-     * allows quering by
+     * allows querying by
      * {@link https://pptr.dev/guides/page-interactions#text-selectors--p-text | text},
      * {@link https://pptr.dev/guides/page-interactions#aria-selectors--p-aria | a11y role and name},
      * and
@@ -1796,7 +1871,7 @@ export declare abstract class ElementHandle<ElementType extends Node = Element>
      * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | CSS selectors}
      * can be passed as-is and a
      * {@link https://pptr.dev/guides/page-interactions#non-css-selectors | Puppeteer-specific selector syntax}
-     * allows quering by
+     * allows querying by
      * {@link https://pptr.dev/guides/page-interactions#text-selectors--p-text | text},
      * {@link https://pptr.dev/guides/page-interactions#aria-selectors--p-aria | a11y role and name},
      * and
@@ -1844,7 +1919,7 @@ export declare abstract class ElementHandle<ElementType extends Node = Element>
      * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | CSS selectors}
      * can be passed as-is and a
      * {@link https://pptr.dev/guides/page-interactions#non-css-selectors | Puppeteer-specific selector syntax}
-     * allows quering by
+     * allows querying by
      * {@link https://pptr.dev/guides/page-interactions#text-selectors--p-text | text},
      * {@link https://pptr.dev/guides/page-interactions#aria-selectors--p-aria | a11y role and name},
      * and
@@ -2160,6 +2235,11 @@ export declare abstract class ElementHandle<ElementType extends Node = Element>
      * ```
      */
     abstract autofill(data: AutofillData): Promise<void>;
+    /**
+     * When connected using Chrome DevTools Protocol, it returns a
+     * DOM.BackendNodeId for the element.
+     */
+    abstract backendNodeId(): Promise<number>;
 }
 
 /**
@@ -2271,7 +2351,11 @@ export declare const
 /**
  * @public
  */
-executablePath: (channel?: Puppeteer_2.ChromeReleaseChannel) => string;
+executablePath: {
+    (channel: Puppeteer_2.ChromeReleaseChannel): string;
+    (options: Puppeteer_2.LaunchOptions): string;
+    (): string;
+};
 
 /**
  * Defines experiment options for Puppeteer.
@@ -2550,7 +2634,7 @@ export declare abstract class Frame extends EventEmitter<FrameEvents> {
      * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | CSS selectors}
      * can be passed as-is and a
      * {@link https://pptr.dev/guides/page-interactions#non-css-selectors | Puppeteer-specific selector syntax}
-     * allows quering by
+     * allows querying by
      * {@link https://pptr.dev/guides/page-interactions#text-selectors--p-text | text},
      * {@link https://pptr.dev/guides/page-interactions#aria-selectors--p-aria | a11y role and name},
      * and
@@ -2575,7 +2659,7 @@ export declare abstract class Frame extends EventEmitter<FrameEvents> {
      * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | CSS selectors}
      * can be passed as-is and a
      * {@link https://pptr.dev/guides/page-interactions#non-css-selectors | Puppeteer-specific selector syntax}
-     * allows quering by
+     * allows querying by
      * {@link https://pptr.dev/guides/page-interactions#text-selectors--p-text | text},
      * {@link https://pptr.dev/guides/page-interactions#aria-selectors--p-aria | a11y role and name},
      * and
@@ -2598,7 +2682,7 @@ export declare abstract class Frame extends EventEmitter<FrameEvents> {
      * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | CSS selectors}
      * can be passed as-is and a
      * {@link https://pptr.dev/guides/page-interactions#non-css-selectors | Puppeteer-specific selector syntax}
-     * allows quering by
+     * allows querying by
      * {@link https://pptr.dev/guides/page-interactions#text-selectors--p-text | text},
      * {@link https://pptr.dev/guides/page-interactions#aria-selectors--p-aria | a11y role and name},
      * and
@@ -2631,7 +2715,7 @@ export declare abstract class Frame extends EventEmitter<FrameEvents> {
      * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | CSS selectors}
      * can be passed as-is and a
      * {@link https://pptr.dev/guides/page-interactions#non-css-selectors | Puppeteer-specific selector syntax}
-     * allows quering by
+     * allows querying by
      * {@link https://pptr.dev/guides/page-interactions#text-selectors--p-text | text},
      * {@link https://pptr.dev/guides/page-interactions#aria-selectors--p-aria | a11y role and name},
      * and
@@ -2666,7 +2750,7 @@ export declare abstract class Frame extends EventEmitter<FrameEvents> {
      * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | CSS selectors}
      * can be passed as-is and a
      * {@link https://pptr.dev/guides/page-interactions#non-css-selectors | Puppeteer-specific selector syntax}
-     * allows quering by
+     * allows querying by
      * {@link https://pptr.dev/guides/page-interactions#text-selectors--p-text | text},
      * {@link https://pptr.dev/guides/page-interactions#aria-selectors--p-aria | a11y role and name},
      * and
@@ -3824,15 +3908,16 @@ export declare const
 /**
  * @public
  */
-launch: (options?: Puppeteer_2.PuppeteerLaunchOptions) => Promise<Puppeteer_2.Browser>;
+launch: (options?: Puppeteer_2.LaunchOptions) => Promise<Puppeteer_2.Browser>;
 
 /**
  * Generic launch options that can be passed when launching any browser.
  * @public
  */
-export declare interface LaunchOptions {
+export declare interface LaunchOptions extends ConnectOptions {
     /**
-     * Chrome Release Channel
+     * If specified for Chrome, looks for a regular Chrome installation at a known
+     * system location instead of using the bundled Chrome binary.
      */
     channel?: ChromeReleaseChannel;
     /**
@@ -3906,6 +3991,42 @@ export declare interface LaunchOptions {
      * @defaultValue `true`
      */
     waitForInitialPage?: boolean;
+    /**
+     * Whether to run the browser in headless mode.
+     *
+     * @remarks
+     *
+     * - `true` launches the browser in the
+     *   {@link https://developer.chrome.com/articles/new-headless/ | new headless}
+     *   mode.
+     *
+     * - `'shell'` launches
+     *   {@link https://developer.chrome.com/blog/chrome-headless-shell | shell}
+     *   known as the old headless mode.
+     *
+     * @defaultValue `true`
+     */
+    headless?: boolean | 'shell';
+    /**
+     * Path to a user data directory.
+     * {@link https://chromium.googlesource.com/chromium/src/+/refs/heads/main/docs/user_data_dir.md | see the Chromium docs}
+     * for more info.
+     */
+    userDataDir?: string;
+    /**
+     * Whether to auto-open a DevTools panel for each tab. If this is set to
+     * `true`, then `headless` will be forced to `false`.
+     * @defaultValue `false`
+     */
+    devtools?: boolean;
+    /**
+     * Specify the debugging port number to use
+     */
+    debuggingPort?: number;
+    /**
+     * Additional command line arguments to pass to the browser instance.
+     */
+    args?: string[];
 }
 
 /**
@@ -4708,7 +4829,7 @@ export declare abstract class Page extends EventEmitter<PageEvents> {
      * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | CSS selectors}
      * can be passed as-is and a
      * {@link https://pptr.dev/guides/page-interactions#non-css-selectors | Puppeteer-specific selector syntax}
-     * allows quering by
+     * allows querying by
      * {@link https://pptr.dev/guides/page-interactions#text-selectors--p-text | text},
      * {@link https://pptr.dev/guides/page-interactions#aria-selectors--p-aria | a11y role and name},
      * and
@@ -4729,7 +4850,7 @@ export declare abstract class Page extends EventEmitter<PageEvents> {
      * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | CSS selectors}
      * can be passed as-is and a
      * {@link https://pptr.dev/guides/page-interactions#non-css-selectors | Puppeteer-specific selector syntax}
-     * allows quering by
+     * allows querying by
      * {@link https://pptr.dev/guides/page-interactions#text-selectors--p-text | text},
      * {@link https://pptr.dev/guides/page-interactions#aria-selectors--p-aria | a11y role and name},
      * and
@@ -4751,7 +4872,7 @@ export declare abstract class Page extends EventEmitter<PageEvents> {
      * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | CSS selectors}
      * can be passed as-is and a
      * {@link https://pptr.dev/guides/page-interactions#non-css-selectors | Puppeteer-specific selector syntax}
-     * allows quering by
+     * allows querying by
      * {@link https://pptr.dev/guides/page-interactions#text-selectors--p-text | text},
      * {@link https://pptr.dev/guides/page-interactions#aria-selectors--p-aria | a11y role and name},
      * and
@@ -4776,7 +4897,7 @@ export declare abstract class Page extends EventEmitter<PageEvents> {
      * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | CSS selectors}
      * can be passed as-is and a
      * {@link https://pptr.dev/guides/page-interactions#non-css-selectors | Puppeteer-specific selector syntax}
-     * allows quering by
+     * allows querying by
      * {@link https://pptr.dev/guides/page-interactions#text-selectors--p-text | text},
      * {@link https://pptr.dev/guides/page-interactions#aria-selectors--p-aria | a11y role and name},
      * and
@@ -4929,7 +5050,7 @@ export declare abstract class Page extends EventEmitter<PageEvents> {
      * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | CSS selectors}
      * can be passed as-is and a
      * {@link https://pptr.dev/guides/page-interactions#non-css-selectors | Puppeteer-specific selector syntax}
-     * allows quering by
+     * allows querying by
      * {@link https://pptr.dev/guides/page-interactions#text-selectors--p-text | text},
      * {@link https://pptr.dev/guides/page-interactions#aria-selectors--p-aria | a11y role and name},
      * and
@@ -4999,7 +5120,7 @@ export declare abstract class Page extends EventEmitter<PageEvents> {
      * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | CSS selectors}
      * can be passed as-is and a
      * {@link https://pptr.dev/guides/page-interactions#non-css-selectors | Puppeteer-specific selector syntax}
-     * allows quering by
+     * allows querying by
      * {@link https://pptr.dev/guides/page-interactions#text-selectors--p-text | text},
      * {@link https://pptr.dev/guides/page-interactions#aria-selectors--p-aria | a11y role and name},
      * and
@@ -5018,17 +5139,30 @@ export declare abstract class Page extends EventEmitter<PageEvents> {
      */
     $$eval<Selector extends string, Params extends unknown[], Func extends EvaluateFuncWith<Array<NodeFor<Selector>>, Params> = EvaluateFuncWith<Array<NodeFor<Selector>>, Params>>(selector: Selector, pageFunction: Func | string, ...args: Params): Promise<Awaited<ReturnType<Func>>>;
     /**
-     * If no URLs are specified, this method returns cookies for the current page
-     * URL. If URLs are specified, only cookies for those URLs are returned.
+     * If no URLs are specified, this method returns cookies for the
+     * current page URL. If URLs are specified, only cookies for those
+     * URLs are returned.
+     *
+     * @deprecated Page-level cookie API is deprecated. Use
+     * {@link Browser.cookies} or {@link BrowserContext.cookies} instead.
      */
     abstract cookies(...urls: string[]): Promise<Cookie[]>;
+    /**
+     * @deprecated Page-level cookie API is deprecated. Use
+     * {@link Browser.deleteCookie} or {@link BrowserContext.deleteCookie}
+     * instead.
+     */
     abstract deleteCookie(...cookies: DeleteCookiesRequest[]): Promise<void>;
     /**
      * @example
      *
-     * ```ts
+     *```ts
      * await page.setCookie(cookieObject1, cookieObject2);
-     * ```
+     *```
+     *
+     * @deprecated Page-level cookie API is deprecated. Use
+     * {@link Browser.setCookie} or {@link BrowserContext.setCookie}
+     * instead.
      */
     abstract setCookie(...cookies: CookieParam[]): Promise<void>;
     /**
@@ -5556,6 +5690,9 @@ export declare abstract class Page extends EventEmitter<PageEvents> {
      *   await page.emulateVisionDeficiency('blurredVision');
      *   await page.screenshot({path: 'blurred-vision.png'});
      *
+     *   await page.emulateVisionDeficiency('reducedContrast');
+     *   await page.screenshot({path: 'reduced-contrast.png'});
+     *
      *   await browser.close();
      * })();
      * ```
@@ -5596,8 +5733,8 @@ export declare abstract class Page extends EventEmitter<PageEvents> {
      *
      * This is either the viewport set with the previous {@link Page.setViewport}
      * call or the default viewport set via
-     * {@link BrowserConnectOptions.defaultViewport |
-     * BrowserConnectOptions.defaultViewport}.
+     * {@link ConnectOptions.defaultViewport |
+     * ConnectOptions.defaultViewport}.
      */
     abstract viewport(): Viewport | null;
     /**
@@ -5828,7 +5965,7 @@ export declare abstract class Page extends EventEmitter<PageEvents> {
      * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | CSS selectors}
      * can be passed as-is and a
      * {@link https://pptr.dev/guides/page-interactions#non-css-selectors | Puppeteer-specific selector syntax}
-     * allows quering by
+     * allows querying by
      * {@link https://pptr.dev/guides/page-interactions#text-selectors--p-text | text},
      * {@link https://pptr.dev/guides/page-interactions#aria-selectors--p-aria | a11y role and name},
      * and
@@ -5853,7 +5990,7 @@ export declare abstract class Page extends EventEmitter<PageEvents> {
      * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | CSS selectors}
      * can be passed as-is and a
      * {@link https://pptr.dev/guides/page-interactions#non-css-selectors | Puppeteer-specific selector syntax}
-     * allows quering by
+     * allows querying by
      * {@link https://pptr.dev/guides/page-interactions#text-selectors--p-text | text},
      * {@link https://pptr.dev/guides/page-interactions#aria-selectors--p-aria | a11y role and name},
      * and
@@ -5885,7 +6022,7 @@ export declare abstract class Page extends EventEmitter<PageEvents> {
      * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | CSS selectors}
      * can be passed as-is and a
      * {@link https://pptr.dev/guides/page-interactions#non-css-selectors | Puppeteer-specific selector syntax}
-     * allows quering by
+     * allows querying by
      * {@link https://pptr.dev/guides/page-interactions#text-selectors--p-text | text},
      * {@link https://pptr.dev/guides/page-interactions#aria-selectors--p-aria | a11y role and name},
      * and
@@ -5922,7 +6059,7 @@ export declare abstract class Page extends EventEmitter<PageEvents> {
      * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | CSS selectors}
      * can be passed as-is and a
      * {@link https://pptr.dev/guides/page-interactions#non-css-selectors | Puppeteer-specific selector syntax}
-     * allows quering by
+     * allows querying by
      * {@link https://pptr.dev/guides/page-interactions#text-selectors--p-text | text},
      * {@link https://pptr.dev/guides/page-interactions#aria-selectors--p-aria | a11y role and name},
      * and
@@ -5952,7 +6089,7 @@ export declare abstract class Page extends EventEmitter<PageEvents> {
      * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | CSS selectors}
      * can be passed as-is and a
      * {@link https://pptr.dev/guides/page-interactions#non-css-selectors | Puppeteer-specific selector syntax}
-     * allows quering by
+     * allows querying by
      * {@link https://pptr.dev/guides/page-interactions#text-selectors--p-text | text},
      * {@link https://pptr.dev/guides/page-interactions#aria-selectors--p-aria | a11y role and name},
      * and
@@ -5988,7 +6125,7 @@ export declare abstract class Page extends EventEmitter<PageEvents> {
      * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | CSS selectors}
      * can be passed as-is and a
      * {@link https://pptr.dev/guides/page-interactions#non-css-selectors | Puppeteer-specific selector syntax}
-     * allows quering by
+     * allows querying by
      * {@link https://pptr.dev/guides/page-interactions#text-selectors--p-text | text},
      * {@link https://pptr.dev/guides/page-interactions#aria-selectors--p-aria | a11y role and name},
      * and
@@ -6038,7 +6175,7 @@ export declare abstract class Page extends EventEmitter<PageEvents> {
      * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | CSS selectors}
      * can be passed as-is and a
      * {@link https://pptr.dev/guides/page-interactions#non-css-selectors | Puppeteer-specific selector syntax}
-     * allows quering by
+     * allows querying by
      * {@link https://pptr.dev/guides/page-interactions#text-selectors--p-text | text},
      * {@link https://pptr.dev/guides/page-interactions#aria-selectors--p-aria | a11y role and name},
      * and
@@ -6347,27 +6484,27 @@ export declare interface PageEvents extends Record<EventType, unknown> {
  *
  * The sizes of each format are as follows:
  *
- * - `Letter`: 8.5in x 11in
+ * - `Letter`: 8.5in x 11in / 21.59cm x 27.94cm
  *
- * - `Legal`: 8.5in x 14in
+ * - `Legal`: 8.5in x 14in / 21.59cm x 35.56cm
  *
- * - `Tabloid`: 11in x 17in
+ * - `Tabloid`: 11in x 17in / 27.94cm x 43.18cm
  *
- * - `Ledger`: 17in x 11in
+ * - `Ledger`: 17in x 11in / 43.18cm x 27.94cm
  *
- * - `A0`: 33.1102in x 46.811in
+ * - `A0`: 33.1102in x 46.811in / 84.1cm x 118.9cm
  *
- * - `A1`: 23.3858in x 33.1102in
+ * - `A1`: 23.3858in x 33.1102in / 59.4cm x 84.1cm
  *
- * - `A2`: 16.5354in x 23.3858in
+ * - `A2`: 16.5354in x 23.3858in / 42cm x 59.4cm
  *
- * - `A3`: 11.6929in x 16.5354in
+ * - `A3`: 11.6929in x 16.5354in / 29.7cm x 42cm
  *
- * - `A4`: 8.2677in x 11.6929in
+ * - `A4`: 8.2677in x 11.6929in / 21cm x 29.7cm
  *
- * - `A5`: 5.8268in x 8.2677in
+ * - `A5`: 5.8268in x 8.2677in / 14.8cm x 21cm
  *
- * - `A6`: 4.1339in x 5.8268in
+ * - `A6`: 4.1339in x 5.8268in / 10.5cm x 14.8cm
  *
  * @public
  */
@@ -6513,7 +6650,7 @@ export declare interface PDFOptions {
 /**
  * @public
  */
-export declare type Permission = 'geolocation' | 'midi' | 'notifications' | 'camera' | 'microphone' | 'background-sync' | 'ambient-light-sensor' | 'accelerometer' | 'gyroscope' | 'magnetometer' | 'accessibility-events' | 'clipboard-read' | 'clipboard-write' | 'clipboard-sanitized-write' | 'payment-handler' | 'persistent-storage' | 'idle-detection' | 'midi-sysex';
+export declare type Permission = 'accelerometer' | 'ambient-light-sensor' | 'background-sync' | 'camera' | 'clipboard-read' | 'clipboard-sanitized-write' | 'clipboard-write' | 'geolocation' | 'gyroscope' | 'idle-detection' | 'keyboard-lock' | 'magnetometer' | 'microphone' | 'midi-sysex' | 'midi' | 'notifications' | 'payment-handler' | 'persistent-storage' | 'pointer-lock';
 
 /**
  * @public
@@ -6784,6 +6921,7 @@ declare namespace Puppeteer_2 {
         ProtocolLifeCycleEvent,
         NetworkConditions,
         InternalNetworkConditions,
+        convertCookiesPartitionKeyFromPuppeteerToCdp,
         PredefinedNetworkConditions,
         TracingOptions,
         Tracing,
@@ -6796,7 +6934,6 @@ declare namespace Puppeteer_2 {
         ProtocolType,
         SupportedWebDriverCapability,
         SupportedWebDriverCapabilities,
-        BrowserConnectOptions,
         ConnectOptions,
         ConsoleMessageLocation,
         ConsoleMessageType,
@@ -6804,8 +6941,10 @@ declare namespace Puppeteer_2 {
         CookieSameSite,
         CookiePriority,
         CookieSourceScheme,
+        CookiePartitionKey,
         Cookie,
         CookieParam,
+        CookieData,
         DeleteCookiesRequest,
         CustomQueryHandler,
         Device,
@@ -6844,12 +6983,9 @@ declare namespace Puppeteer_2 {
         Viewport,
         DownloadPolicy,
         DownloadBehavior,
-        BrowserLaunchArgumentOptions,
         ChromeReleaseChannel,
         LaunchOptions,
-        PuppeteerNodeLaunchOptions,
         BrowserLauncher,
-        PuppeteerLaunchOptions,
         PuppeteerNode,
         ScreenRecorder
     }
@@ -6870,14 +7006,6 @@ export declare class PuppeteerError extends Error {
 
 }
 
-/**
- * @public
- */
-export declare interface PuppeteerLaunchOptions extends LaunchOptions, BrowserLaunchArgumentOptions, BrowserConnectOptions {
-    browser?: SupportedBrowser;
-    extraPrefsFirefox?: Record<string, unknown>;
-}
-
 /**
  * @public
  */
@@ -6984,11 +7112,19 @@ export declare class PuppeteerNode extends Puppeteer {
      *
      * @param options - Options to configure launching behavior.
      */
-    launch(options?: PuppeteerLaunchOptions): Promise<Browser>;
+    launch(options?: LaunchOptions): Promise<Browser>;
+    /**
+     * The default executable path for a given ChromeReleaseChannel.
+     */
+    executablePath(channel: ChromeReleaseChannel): string;
+    /**
+     * The default executable path given LaunchOptions.
+     */
+    executablePath(options: LaunchOptions): string;
     /**
      * The default executable path.
      */
-    executablePath(channel?: ChromeReleaseChannel): string;
+    executablePath(): string;
 
 
     /**
@@ -7013,9 +7149,9 @@ export declare class PuppeteerNode extends Puppeteer {
     /**
      * @param options - Set of configurable options to set on the browser.
      *
-     * @returns The default flags that Chromium will be launched with.
+     * @returns The default arguments that the browser will be launched with.
      */
-    defaultArgs(options?: BrowserLaunchArgumentOptions): string[];
+    defaultArgs(options?: LaunchOptions): string[];
     /**
      * Removes all non-current Firefox and Chrome binaries in the cache directory
      * identified by the provided Puppeteer configuration. The current browser
@@ -7033,13 +7169,6 @@ export declare class PuppeteerNode extends Puppeteer {
     trimCache(): Promise<void>;
 }
 
-/**
- * Utility type exposed to enable users to define options that can be passed to
- * `puppeteer.launch` without having to list the set of all types.
- * @public
- */
-export declare type PuppeteerNodeLaunchOptions = BrowserLaunchArgumentOptions & LaunchOptions & BrowserConnectOptions;
-
 /**
  * @public
  */
@@ -7346,6 +7475,13 @@ export declare interface SnapshotOptions {
      * @defaultValue `true`
      */
     interestingOnly?: boolean;
+    /**
+     * If true, gets accessibility trees for each of the iframes in the frame
+     * subtree.
+     *
+     * @defaultValue `false`
+     */
+    includeIframes?: boolean;
     /**
      * Root node to get the accessibility tree for
      * @defaultValue The root node of the entire page.