chrome-devtools-frontend 1.0.1040857 → 1.0.1070764

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

@@ -85,6 +85,8 @@ export declare type ActionResult = 'continue' | 'abort' | 'respond';
 
 /* Excluded from this release type: ariaHandler */
 
+/* Excluded from this release type: assert */
+
 /**
  * @public
  */
@@ -162,18 +164,15 @@ export declare interface BoxModel {
  * @public
  */
 export declare class Browser extends EventEmitter {
-    #private;
-    /* Excluded from this release type: _create */
-    /* Excluded from this release type: _targets */
     /* Excluded from this release type: __constructor */
     /* Excluded from this release type: _attach */
     /* Excluded from this release type: _detach */
+    /* Excluded from this release type: _targets */
     /**
      * The spawned browser process. Returns `null` if the browser instance was created with
      * {@link Puppeteer.connect}.
      */
     process(): ChildProcess | null;
-    /* Excluded from this release type: _targetManager */
     /* Excluded from this release type: _getIsPageTargetCallback */
     /**
      * Creates a new incognito browser context. This won't share cookies/cache with other
@@ -325,6 +324,7 @@ export declare interface BrowserConnectOptions {
      */
     targetFilter?: TargetFilterCallback;
     /* Excluded from this release type: _isPageTarget */
+    /* Excluded from this release type: protocol */
 }
 
 /**
@@ -362,7 +362,6 @@ export declare interface BrowserConnectOptions {
  * @public
  */
 export declare class BrowserContext extends EventEmitter {
-    #private;
     /* Excluded from this release type: __constructor */
     /**
      * An array of all active targets inside the browser context.
@@ -451,6 +450,7 @@ export declare class BrowserContext extends EventEmitter {
      * Only incognito browser contexts can be closed.
      */
     close(): Promise<void>;
+    get id(): string | undefined;
 }
 
 /**
@@ -490,7 +490,7 @@ export declare interface BrowserContextOptions {
      */
     proxyServer?: string;
     /**
-     * Bypass the proxy for the given semi-colon-separated list of hosts.
+     * Bypass the proxy for the given list of hosts.
      */
     proxyBypassList?: string[];
 }
@@ -542,33 +542,44 @@ export declare const enum BrowserEmittedEvents {
 }
 
 /**
- * BrowserFetcher can download and manage different versions of Chromium and Firefox.
+ * BrowserFetcher can download and manage different versions of Chromium and
+ * Firefox.
+ *
+ * @remarks
+ * BrowserFetcher operates on revision strings that specify a precise version of
+ * Chromium, e.g. `"533271"`. Revision strings can be obtained from
+ * {@link http://omahaproxy.appspot.com/ | omahaproxy.appspot.com}. For Firefox,
+ * BrowserFetcher downloads Firefox Nightly and operates on version numbers such
+ * as `"75"`.
  *
  * @remarks
- * BrowserFetcher operates on revision strings that specify a precise version of Chromium, e.g. `"533271"`. Revision strings can be obtained from {@link http://omahaproxy.appspot.com/ | omahaproxy.appspot.com}.
- * In the Firefox case, BrowserFetcher downloads Firefox Nightly and
- * operates on version numbers such as `"75"`.
+ * The default constructed fetcher will always be for Chromium unless otherwise
+ * specified.
+ *
+ * @remarks
+ * BrowserFetcher is not designed to work concurrently with other instances of
+ * BrowserFetcher that share the same downloads directory.
  *
  * @example
  * An example of using BrowserFetcher to download a specific version of Chromium
  * and running Puppeteer against it:
  *
  * ```ts
- * const browserFetcher = puppeteer.createBrowserFetcher();
+ * const browserFetcher = new BrowserFetcher({path: 'path/to/download/folder'});
  * const revisionInfo = await browserFetcher.download('533271');
  * const browser = await puppeteer.launch({
  *   executablePath: revisionInfo.executablePath,
  * });
  * ```
  *
- * **NOTE** BrowserFetcher is not designed to work concurrently with other
- * instances of BrowserFetcher that share the same downloads directory.
- *
  * @public
  */
 export declare class BrowserFetcher {
     #private;
-    /* Excluded from this release type: __constructor */
+    /**
+     * Constructs a browser fetcher for the given options.
+     */
+    constructor(options: BrowserFetcherOptions);
     /**
      * @returns Returns the current `Platform`, which is one of `mac`, `linux`,
      * `win32` or `win64`.
@@ -606,10 +617,10 @@ export declare class BrowserFetcher {
     /**
      * @remarks
      * This method is affected by the current `product`.
-     * @returns A promise with a list of all revision strings (for the current `product`)
+     * @returns A list of all revision strings (for the current `product`)
      * available locally on disk.
      */
-    localRevisions(): Promise<string[]>;
+    localRevisions(): string[];
     /**
      * @remarks
      * This method is affected by the current `product`.
@@ -629,10 +640,38 @@ export declare class BrowserFetcher {
  * @public
  */
 export declare interface BrowserFetcherOptions {
+    /**
+     * Determines the path to download browsers to.
+     */
+    path: string;
+    /**
+     * Determines which platform the browser will be suited for.
+     *
+     * @defaultValue Auto-detected.
+     */
     platform?: Platform;
-    product?: string;
-    path?: string;
+    /**
+     * Determines which product the {@link BrowserFetcher} is for.
+     *
+     * @defaultValue `"chrome"`.
+     */
+    product?: 'chrome' | 'firefox';
+    /**
+     * Determines the host that will be used for downloading.
+     *
+     * @defaultValue Either
+     *
+     * - https://storage.googleapis.com or
+     * - https://archive.mozilla.org/pub/firefox/nightly/latest-mozilla-central
+     *
+     */
     host?: string;
+    /**
+     * Enables the use of the Chromium binary for macOS ARM.
+     *
+     * @experimental
+     */
+    useMacOSARMBinary?: boolean;
 }
 
 /**
@@ -684,6 +723,12 @@ export declare interface BrowserLaunchArgumentOptions {
 
 /* Excluded from this release type: BrowserWebSocketTransport */
 
+/* Excluded from this release type: CDPBrowser */
+
+/* Excluded from this release type: CDPBrowserContext */
+
+/* Excluded from this release type: CDPPage */
+
 /**
  * The `CDPSession` instances are used to talk raw Chrome Devtools Protocol.
  *
@@ -713,17 +758,14 @@ export declare interface BrowserLaunchArgumentOptions {
  * @public
  */
 export declare class CDPSession extends EventEmitter {
-    #private;
     /* Excluded from this release type: __constructor */
     connection(): Connection | undefined;
     send<T extends keyof ProtocolMapping.Commands>(method: T, ...paramArgs: ProtocolMapping.Commands[T]['paramsType']): Promise<ProtocolMapping.Commands[T]['returnType']>;
-    /* Excluded from this release type: _onMessage */
     /**
      * Detaches the cdpSession from the target. Once detached, the cdpSession object
      * won't emit any events and can't be used to send messages.
      */
     detach(): Promise<void>;
-    /* Excluded from this release type: _onClosed */
     /**
      * Returns the session's id.
      */
@@ -738,12 +780,10 @@ declare interface CDPSession_3 extends EventEmitter {
     send<T extends keyof ProtocolMapping.Commands>(method: T, ...paramArgs: ProtocolMapping.Commands[T]['paramsType']): Promise<ProtocolMapping.Commands[T]['returnType']>;
 }
 
-declare interface CDPSession_4 extends EventEmitter {
-    send<T extends keyof ProtocolMapping.Commands>(method: T, ...paramArgs: ProtocolMapping.Commands[T]['paramsType']): Promise<ProtocolMapping.Commands[T]['returnType']>;
-}
-
 /* Excluded from this release type: CDPSessionEmittedEvents */
 
+/* Excluded from this release type: CDPSessionImpl */
+
 /**
  * @public
  */
@@ -769,7 +809,8 @@ export declare type ChromeReleaseChannel = 'chrome' | 'chrome-beta' | 'chrome-ca
 /* Excluded from this release type: ChromeTargetManager */
 
 /**
- * Clears all registered handlers.
+ * @deprecated Import {@link Puppeteer} and use the static method
+ * {@link Puppeteer.clearCustomQueryHandlers}
  *
  * @public
  */
@@ -794,11 +835,16 @@ export declare interface ClickOptions {
      */
     clickCount?: number;
     /**
-     * Offset for the clickable point relative to the top-left corder of the border box.
+     * Offset for the clickable point relative to the top-left corner of the border box.
      */
     offset?: Offset;
 }
 
+declare interface CommandResponse {
+    id: number;
+    result: object;
+}
+
 /**
  * @public
  */
@@ -815,6 +861,101 @@ export declare interface CommonEventEmitter {
 
 /* Excluded from this release type: CommonPuppeteerSettings */
 
+/**
+ * Defines options to configure Puppeteer's behavior during installation and
+ * runtime.
+ *
+ * See individual properties for more information.
+ *
+ * @public
+ */
+export declare interface Configuration {
+    /**
+     * Specifies a certain version of the browser you'd like Puppeteer to use.
+     *
+     * Can be overridden by `PUPPETEER_BROWSER_REVISION`.
+     *
+     * See {@link PuppeteerNode.launch | puppeteer.launch} on how executable path
+     * is inferred.
+     *
+     * @defaultValue A compatible-revision of the browser.
+     */
+    browserRevision?: string;
+    /**
+     * Defines the directory to be used by Puppeteer for caching.
+     *
+     * Can be overridden by `PUPPETEER_CACHE_DIR`.
+     *
+     * @defaultValue `path.join(os.homedir(), '.cache', 'puppeteer')`
+     */
+    cacheDirectory?: string;
+    /**
+     * Specifies the URL prefix that is used to download Chromium.
+     *
+     * Can be overridden by `PUPPETEER_DOWNLOAD_HOST`.
+     *
+     * @remarks
+     * This must include the protocol and may even need a path prefix.
+     *
+     * @defaultValue Either https://storage.googleapis.com or
+     * https://archive.mozilla.org/pub/firefox/nightly/latest-mozilla-central,
+     * depending on the product.
+     */
+    downloadHost?: string;
+    /**
+     * Specifies the path for the downloads folder.
+     *
+     * Can be overridden by `PUPPETEER_DOWNLOAD_PATH`.
+     *
+     * @defaultValue `<cache>/<product>` where `<cache>` is Puppeteer's cache
+     * directory and `<product>` is the name of the browser.
+     */
+    downloadPath?: string;
+    /**
+     * Specifies an executable path to be used in
+     * {@link PuppeteerNode.launch | puppeteer.launch}.
+     *
+     * Can be overridden by `PUPPETEER_EXECUTABLE_PATH`.
+     *
+     * @defaultValue Auto-computed.
+     */
+    executablePath?: string;
+    /**
+     * Specifies which browser you'd like Puppeteer to use.
+     *
+     * Can be overridden by `PUPPETEER_PRODUCT`.
+     *
+     * @defaultValue `'chrome'`
+     */
+    defaultProduct?: Product;
+    /**
+     * Defines the directory to be used by Puppeteer for creating temporary files.
+     *
+     * Can be overridden by `PUPPETEER_TMP_DIR`.
+     *
+     * @defaultValue `os.tmpdir()`
+     */
+    temporaryDirectory?: string;
+    /**
+     * Tells Puppeteer to not download during installation.
+     *
+     * Can be overridden by `PUPPETEER_SKIP_DOWNLOAD`.
+     */
+    skipDownload?: boolean;
+    /**
+     * Tells Puppeteer to log at the given level.
+     *
+     * At the moment, any option silences logging.
+     *
+     * @defaultValue `undefined`
+     */
+    logLevel?: 'silent' | 'error' | 'warn';
+    /**
+     * Defines experimental options for Puppeteer.
+     */
+    experiments?: ExperimentsConfiguration;
+}
+
 export declare const connect: (options: ConnectOptions) => Promise<Browser>;
 
 /**
@@ -845,6 +986,8 @@ export declare class Connection extends EventEmitter {
     createSession(targetInfo: Protocol.Target.TargetInfo): Promise<CDPSession>;
 }
 
+/* Excluded from this release type: Connection_2 */
+
 /**
  * @public
  */
@@ -891,7 +1034,7 @@ export declare interface ConnectOptions extends BrowserConnectOptions {
     transport?: ConnectionTransport;
 }
 
-/* Excluded from this release type: _connectToBrowser */
+/* Excluded from this release type: _connectToCDPBrowser */
 
 /* Excluded from this release type: ConsoleAPICalledCallback */
 
@@ -1006,14 +1149,16 @@ export declare class Coverage {
     constructor(client: CDPSession);
     /**
      * @param options - Set of configurable options for coverage defaults to
-     * `resetOnNavigation : true, reportAnonymousScripts : false`
+     * `resetOnNavigation : true, reportAnonymousScripts : false,`
+     * `includeRawScriptCoverage : false, useBlockCoverage : true`
      * @returns Promise that resolves when coverage is started.
      *
      * @remarks
      * Anonymous scripts are ones that don't have an associated url. These are
      * scripts that are dynamically created on the page using `eval` or
      * `new Function`. If `reportAnonymousScripts` is set to `true`, anonymous
-     * scripts will have `pptr://__puppeteer_evaluation_script__` as their URL.
+     * scripts URL will start with `debugger://VM` (unless a magic //# sourceURL
+     * comment is present, in which case that will the be URL).
      */
     startJSCoverage(options?: JSCoverageOptions): Promise<void>;
     /**
@@ -1063,11 +1208,23 @@ export declare interface CoverageEntry {
     }>;
 }
 
-export declare const createBrowserFetcher: (options: BrowserFetcherOptions) => BrowserFetcher;
+/**
+ * @deprecated Construct {@link BrowserFetcher} manually.
+ *
+ * @public
+ */
+export declare const /**
+ * @deprecated Construct {@link BrowserFetcher} manually.
+ *
+ * @public
+ */
+createBrowserFetcher: (options: Partial<BrowserFetcherOptions>) => BrowserFetcher;
 
-/* Excluded from this release type: createJSHandle */
+/* Excluded from this release type: createDebuggableDeferredPromise */
 
-/* Excluded from this release type: createLauncher */
+/* Excluded from this release type: createDeferredPromise */
+
+/* Excluded from this release type: createJSHandle */
 
 /**
  * @public
@@ -1116,10 +1273,12 @@ export declare interface CSSCoverageOptions {
  * limitations under the License.
  */
 /**
+ * @deprecated Do not use.
+ *
  * @public
  */
 export declare class CustomError extends Error {
-    constructor(message?: string);
+    /* Excluded from this release type: __constructor */
 }
 
 /**
@@ -1137,7 +1296,8 @@ export declare interface CustomQueryHandler {
 }
 
 /**
- * @returns a list with the names of all registered custom query handlers.
+ * @deprecated Import {@link Puppeteer} and use the static method
+ * {@link Puppeteer.customQueryHandlerNames}
  *
  * @public
  */
@@ -1156,66 +1316,26 @@ export declare const DEFAULT_INTERCEPT_RESOLUTION_PRIORITY = 0;
 
 export declare const defaultArgs: (options?: BrowserLaunchArgumentOptions) => string[];
 
-/**
- * Copyright 2017 Google Inc. All rights reserved.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
+/* Excluded from this release type: DEFERRED_PROMISE_DEBUG_TIMEOUT */
+
+/* Excluded from this release type: DeferredPromise */
+
+/* Excluded from this release type: DeferredPromiseOptions */
+
 /**
  * @public
  */
 export declare interface Device {
-    name: string;
     userAgent: string;
-    viewport: {
-        width: number;
-        height: number;
-        deviceScaleFactor: number;
-        isMobile: boolean;
-        hasTouch: boolean;
-        isLandscape: boolean;
-    };
+    viewport: Viewport;
 }
 
 /**
- * A list of devices to be used with `page.emulate(options)`. Actual list of devices can be found in {@link https://github.com/puppeteer/puppeteer/blob/main/src/common/DeviceDescriptors.ts | src/common/DeviceDescriptors.ts}.
- *
- * @example
- *
- * ```ts
- * const puppeteer = require('puppeteer');
- * const iPhone = puppeteer.devices['iPhone 6'];
- *
- * (async () => {
- *   const browser = await puppeteer.launch();
- *   const page = await browser.newPage();
- *   await page.emulate(iPhone);
- *   await page.goto('https://www.google.com');
- *   // other actions...
- *   await browser.close();
- * })();
- * ```
+ * @deprecated Import {@link KnownDevices}
  *
  * @public
  */
-export declare const devices: DevicesMap;
-
-/**
- * @public
- */
-export declare type DevicesMap = {
-    [name: string]: Device;
-};
+export declare const devices: Readonly<Record<"Blackberry PlayBook" | "Blackberry PlayBook landscape" | "BlackBerry Z30" | "BlackBerry Z30 landscape" | "Galaxy Note 3" | "Galaxy Note 3 landscape" | "Galaxy Note II" | "Galaxy Note II landscape" | "Galaxy S III" | "Galaxy S III landscape" | "Galaxy S5" | "Galaxy S5 landscape" | "Galaxy S8" | "Galaxy S8 landscape" | "Galaxy S9+" | "Galaxy S9+ landscape" | "Galaxy Tab S4" | "Galaxy Tab S4 landscape" | "iPad" | "iPad landscape" | "iPad (gen 6)" | "iPad (gen 6) landscape" | "iPad (gen 7)" | "iPad (gen 7) landscape" | "iPad Mini" | "iPad Mini landscape" | "iPad Pro" | "iPad Pro landscape" | "iPad Pro 11" | "iPad Pro 11 landscape" | "iPhone 4" | "iPhone 4 landscape" | "iPhone 5" | "iPhone 5 landscape" | "iPhone 6" | "iPhone 6 landscape" | "iPhone 6 Plus" | "iPhone 6 Plus landscape" | "iPhone 7" | "iPhone 7 landscape" | "iPhone 7 Plus" | "iPhone 7 Plus landscape" | "iPhone 8" | "iPhone 8 landscape" | "iPhone 8 Plus" | "iPhone 8 Plus landscape" | "iPhone SE" | "iPhone SE landscape" | "iPhone X" | "iPhone X landscape" | "iPhone XR" | "iPhone XR landscape" | "iPhone 11" | "iPhone 11 landscape" | "iPhone 11 Pro" | "iPhone 11 Pro landscape" | "iPhone 11 Pro Max" | "iPhone 11 Pro Max landscape" | "iPhone 12" | "iPhone 12 landscape" | "iPhone 12 Pro" | "iPhone 12 Pro landscape" | "iPhone 12 Pro Max" | "iPhone 12 Pro Max landscape" | "iPhone 12 Mini" | "iPhone 12 Mini landscape" | "iPhone 13" | "iPhone 13 landscape" | "iPhone 13 Pro" | "iPhone 13 Pro landscape" | "iPhone 13 Pro Max" | "iPhone 13 Pro Max landscape" | "iPhone 13 Mini" | "iPhone 13 Mini landscape" | "JioPhone 2" | "JioPhone 2 landscape" | "Kindle Fire HDX" | "Kindle Fire HDX landscape" | "LG Optimus L70" | "LG Optimus L70 landscape" | "Microsoft Lumia 550" | "Microsoft Lumia 950" | "Microsoft Lumia 950 landscape" | "Nexus 10" | "Nexus 10 landscape" | "Nexus 4" | "Nexus 4 landscape" | "Nexus 5" | "Nexus 5 landscape" | "Nexus 5X" | "Nexus 5X landscape" | "Nexus 6" | "Nexus 6 landscape" | "Nexus 6P" | "Nexus 6P landscape" | "Nexus 7" | "Nexus 7 landscape" | "Nokia Lumia 520" | "Nokia Lumia 520 landscape" | "Nokia N9" | "Nokia N9 landscape" | "Pixel 2" | "Pixel 2 landscape" | "Pixel 2 XL" | "Pixel 2 XL landscape" | "Pixel 3" | "Pixel 3 landscape" | "Pixel 4" | "Pixel 4 landscape" | "Pixel 4a (5G)" | "Pixel 4a (5G) landscape" | "Pixel 5" | "Pixel 5 landscape" | "Moto G4" | "Moto G4 landscape", Device>>;
 
 /**
  * Dialog instances are dispatched by the {@link Page} via the `dialog` event.
@@ -1270,8 +1390,6 @@ export declare class Dialog {
     dismiss(): Promise<void>;
 }
 
-/* Excluded from this release type: downloadBrowser */
-
 /**
  * ElementHandle represents an in-page DOM element.
  *
@@ -1308,6 +1426,7 @@ export declare class Dialog {
 export declare class ElementHandle<ElementType extends Node = Element> extends JSHandle<ElementType> {
     #private;
     /* Excluded from this release type: __constructor */
+    get frame(): Frame;
     /**
      * Queries the current element for an element matching the given selector.
      *
@@ -1394,7 +1513,12 @@ export declare class ElementHandle<ElementType extends Node = Element> extends J
     /**
      * @deprecated Use {@link ElementHandle.$$} with the `xpath` prefix.
      *
+     * Example: `await elementHandle.$$('xpath/' + xpathExpression)`
+     *
      * The method evaluates the XPath expression relative to the elementHandle.
+     * If `xpath` starts with `//` instead of `.//`, the dot will be appended
+     * automatically.
+     *
      * If there are no such elements, the method will resolve to an empty array.
      * @param expression - Expression to {@link https://developer.mozilla.org/en-US/docs/Web/API/Document/evaluate | evaluate}
      */
@@ -1436,11 +1560,15 @@ export declare class ElementHandle<ElementType extends Node = Element> extends J
      * @returns An element matching the given selector.
      * @throws Throws if an element matching the given selector doesn't appear.
      */
-    waitForSelector<Selector extends string>(selector: Selector, options?: Exclude<WaitForSelectorOptions, 'root'>): Promise<ElementHandle<NodeFor<Selector>> | null>;
+    waitForSelector<Selector extends string>(selector: Selector, options?: WaitForSelectorOptions): Promise<ElementHandle<NodeFor<Selector>> | null>;
     /**
      * @deprecated Use {@link ElementHandle.waitForSelector} with the `xpath`
      * prefix.
      *
+     * Example: `await elementHandle.waitForSelector('xpath/' + xpathExpression)`
+     *
+     * The method evaluates the XPath expression relative to the elementHandle.
+     *
      * Wait for the `xpath` within the element. If at the moment of calling the
      * method the `xpath` already exists, the method will return immediately. If
      * the `xpath` doesn't appear after the `timeout` milliseconds of waiting, the
@@ -1449,7 +1577,7 @@ export declare class ElementHandle<ElementType extends Node = Element> extends J
      * If `xpath` starts with `//` instead of `.//`, the dot will be appended
      * automatically.
      *
-     * This method works across navigation
+     * This method works across navigation.
      *
      * ```ts
      * const puppeteer = require('puppeteer');
@@ -1657,7 +1785,11 @@ export declare class ElementHandle<ElementType extends Node = Element> extends J
  */
 export declare type ErrorCode = 'aborted' | 'accessdenied' | 'addressunreachable' | 'blockedbyclient' | 'blockedbyresponse' | 'connectionaborted' | 'connectionclosed' | 'connectionfailed' | 'connectionrefused' | 'connectionreset' | 'internetdisconnected' | 'namenotresolved' | 'timedout' | 'failed';
 
+/* Excluded from this release type: ErrorLike */
+
 /**
+ * @deprecated Import error classes directly.
+ *
  * Puppeteer methods might throw errors if they are unable to fulfill a request.
  * For example, `page.waitForSelector(selector[, options])` might fail if the
  * selector doesn't match any nodes during the given timeframe.
@@ -1672,7 +1804,7 @@ export declare type ErrorCode = 'aborted' | 'accessdenied' | 'addressunreachable
  * try {
  *   await page.waitForSelector('.foo');
  * } catch (e) {
- *   if (e instanceof puppeteer.errors.TimeoutError) {
+ *   if (e instanceof TimeoutError) {
  *     // Do something if this is a timeout.
  *   }
  * }
@@ -1766,169 +1898,35 @@ export declare class EventEmitter implements CommonEventEmitter {
     private eventListenersCount;
 }
 
-/**
- * @public
- */
 export declare type EventType = string | symbol;
 
 /* Excluded from this release type: ExceptionThrownCallback */
 
-export declare const executablePath: (channel?: string | undefined) => string;
+export declare const executablePath: (channel?: ChromeReleaseChannel | undefined) => string;
 
-/* Excluded from this release type: executablePathForChannel */
+/* Excluded from this release type: ExecutionContext */
 
 /**
- * @deprecated Do not use directly.
- *
- * Represents a context for JavaScript execution.
- *
- * @example
- * A {@link Page} can have several execution contexts:
- *
- * - Each {@link Frame} of a {@link Page | page} has a "default" execution
- *   context that is always created after frame is attached to DOM. This context
- *   is returned by the {@link Frame.executionContext} method.
- * - Each {@link https://developer.chrome.com/extensions | Chrome extensions}
- *   creates additional execution contexts to isolate their code.
+ * Defines experiment options for Puppeteer.
  *
- * @remarks
- * By definition, each context is isolated from one another, however they are
- * all able to manipulate non-JavaScript resources (such as DOM).
+ * See individual properties for more information.
  *
- * @remarks
- * Besides pages, execution contexts can be found in
- * {@link WebWorker | workers}.
+ * @public
  */
-export declare class ExecutionContext {
-    #private;
-    /* Excluded from this release type: _client */
-    /* Excluded from this release type: _world */
-    /* Excluded from this release type: _contextId */
-    /* Excluded from this release type: _contextName */
-    /* Excluded from this release type: __constructor */
+export declare interface ExperimentsConfiguration {
     /**
-     * @returns The frame associated with this execution context.
+     * Require Puppeteer to download Chromium for Apple M1.
      *
-     * @remarks
-     * Not every execution context is associated with a frame. For example,
-     * {@link WebWorker | workers} have execution contexts that are not associated
-     * with frames.
-     */
-    frame(): Frame | null;
-    /**
-     * Evaluates the given function.
+     * On Apple M1 devices Puppeteer by default downloads the version for
+     * Intel's processor which runs via Rosetta. It works without any problems,
+     * however, with this option, you should get more efficient resource usage
+     * (CPU and RAM) that could lead to a faster execution time.
      *
-     * @example
+     * Can be overridden by `PUPPETEER_EXPERIMENTAL_CHROMIUM_MAC_ARM`.
      *
-     * ```ts
-     * const executionContext = await page.mainFrame().executionContext();
-     * const result = await executionContext.evaluate(() => Promise.resolve(8 * 7))* ;
-     * console.log(result); // prints "56"
-     * ```
-     *
-     * @example
-     * A string can also be passed in instead of a function:
-     *
-     * ```ts
-     * console.log(await executionContext.evaluate('1 + 2')); // prints "3"
-     * ```
-     *
-     * @example
-     * Handles can also be passed as `args`. They resolve to their referenced object:
-     *
-     * ```ts
-     * const oneHandle = await executionContext.evaluateHandle(() => 1);
-     * const twoHandle = await executionContext.evaluateHandle(() => 2);
-     * const result = await executionContext.evaluate(
-     *   (a, b) => a + b,
-     *   oneHandle,
-     *   twoHandle
-     * );
-     * await oneHandle.dispose();
-     * await twoHandle.dispose();
-     * console.log(result); // prints '3'.
-     * ```
-     *
-     * @param pageFunction - The function to evaluate.
-     * @param args - Additional arguments to pass into the function.
-     * @returns The result of evaluating the function. If the result is an object,
-     * a vanilla object containing the serializable properties of the result is
-     * returned.
-     */
-    evaluate<Params extends unknown[], Func extends EvaluateFunc<Params> = EvaluateFunc<Params>>(pageFunction: Func | string, ...args: Params): Promise<Awaited<ReturnType<Func>>>;
-    /**
-     * Evaluates the given function.
-     *
-     * Unlike {@link ExecutionContext.evaluate | evaluate}, this method returns a
-     * handle to the result of the function.
-     *
-     * This method may be better suited if the object cannot be serialized (e.g.
-     * `Map`) and requires further manipulation.
-     *
-     * @example
-     *
-     * ```ts
-     * const context = await page.mainFrame().executionContext();
-     * const handle: JSHandle<typeof globalThis> = await context.evaluateHandle(
-     *   () => Promise.resolve(self)
-     * );
-     * ```
-     *
-     * @example
-     * A string can also be passed in instead of a function.
-     *
-     * ```ts
-     * const handle: JSHandle<number> = await context.evaluateHandle('1 + 2');
-     * ```
-     *
-     * @example
-     * Handles can also be passed as `args`. They resolve to their referenced object:
-     *
-     * ```ts
-     * const bodyHandle: ElementHandle<HTMLBodyElement> =
-     *   await context.evaluateHandle(() => {
-     *     return document.body;
-     *   });
-     * const stringHandle: JSHandle<string> = await context.evaluateHandle(
-     *   body => body.innerHTML,
-     *   body
-     * );
-     * console.log(await stringHandle.jsonValue()); // prints body's innerHTML
-     * // Always dispose your garbage! :)
-     * await bodyHandle.dispose();
-     * await stringHandle.dispose();
-     * ```
-     *
-     * @param pageFunction - The function to evaluate.
-     * @param args - Additional arguments to pass into the function.
-     * @returns A {@link JSHandle | handle} to the result of evaluating the
-     * function. If the result is a `Node`, then this will return an
-     * {@link ElementHandle | element handle}.
-     */
-    evaluateHandle<Params extends unknown[], Func extends EvaluateFunc<Params> = EvaluateFunc<Params>>(pageFunction: Func | string, ...args: Params): Promise<HandleFor<Awaited<ReturnType<Func>>>>;
-    /**
-     * Iterates through the JavaScript heap and finds all the objects with the
-     * given prototype.
-     *
-     * @example
-     *
-     * ```ts
-     * // Create a Map object
-     * await page.evaluate(() => (window.map = new Map()));
-     * // Get a handle to the Map object prototype
-     * const mapPrototype = await page.evaluateHandle(() => Map.prototype);
-     * // Query all map instances into an array
-     * const mapInstances = await page.queryObjects(mapPrototype);
-     * // Count amount of map objects in heap
-     * const count = await page.evaluate(maps => maps.length, mapInstances);
-     * await mapInstances.dispose();
-     * await mapPrototype.dispose();
-     * ```
-     *
-     * @param prototypeHandle - a handle to the object prototype
-     * @returns A handle to an array of objects with the given prototype.
+     * @defaultValue `false`
      */
-    queryObjects<Prototype>(prototypeHandle: JSHandle<Prototype>): Promise<HandleFor<Prototype[]>>;
+    macArmChromiumEnabled?: boolean;
 }
 
 /* Excluded from this release type: FetchRequestId */
@@ -1987,6 +1985,8 @@ export declare class FileChooser {
  */
 export declare type FlattenHandle<T> = T extends HandleOr<infer U> ? U : never;
 
+/* Excluded from this release type: FlattenLazyArg */
+
 /**
  * Represents a DOM frame.
  *
@@ -2049,7 +2049,7 @@ export declare class Frame {
     /* Excluded from this release type: _name */
     /* Excluded from this release type: _hasStartedLoading */
     /* Excluded from this release type: _lifecycleEvents */
-    /* Excluded from this release type: _childFrames */
+    /* Excluded from this release type: _parentId */
     /* Excluded from this release type: __constructor */
     /* Excluded from this release type: updateClient */
     /**
@@ -2131,12 +2131,7 @@ export declare class Frame {
         waitUntil?: PuppeteerLifeCycleEvent | PuppeteerLifeCycleEvent[];
     }): Promise<HTTPResponse | null>;
     /* Excluded from this release type: _client */
-    /**
-     * @deprecated Do not use the execution context directly.
-     *
-     * @returns a promise that resolves to the frame's default execution context.
-     */
-    executionContext(): Promise<ExecutionContext>;
+    /* Excluded from this release type: executionContext */
     /**
      * Behaves identically to {@link Page.evaluateHandle} except it's run within
      * the context of this frame.
@@ -2218,7 +2213,11 @@ export declare class Frame {
     /**
      * @deprecated Use {@link Frame.$$} with the `xpath` prefix.
      *
+     * Example: `await frame.$$('xpath/' + xpathExpression)`
+     *
      * This method evaluates the given XPath expression and returns the results.
+     * If `xpath` starts with `//` instead of `.//`, the dot will be appended
+     * automatically.
      * @param expression - the XPath expression to evaluate.
      */
     $x(expression: string): Promise<Array<ElementHandle<Node>>>;
@@ -2261,6 +2260,12 @@ export declare class Frame {
     /**
      * @deprecated Use {@link Frame.waitForSelector} with the `xpath` prefix.
      *
+     * Example: `await frame.waitForSelector('xpath/' + xpathExpression)`
+     *
+     * The method evaluates the XPath expression relative to the Frame.
+     * If `xpath` starts with `//` instead of `.//`, the dot will be appended
+     * automatically.
+     *
      * Wait for the `xpath` to appear in page. If at the moment of calling the
      * method the `xpath` already exists, the method will return immediately. If
      * the xpath doesn't appear after the `timeout` milliseconds of waiting, the
@@ -2355,21 +2360,19 @@ export declare class Frame {
      * Adds a `<script>` tag into the page with the desired url or content.
      *
      * @param options - Options for the script.
-     * @returns a promise that resolves to the added tag when the script's
-     * `onload` event fires or when the script content was injected into the
-     * frame.
+     * @returns An {@link ElementHandle | element handle} to the injected
+     * `<script>` element.
      */
     addScriptTag(options: FrameAddScriptTagOptions): Promise<ElementHandle<HTMLScriptElement>>;
     /**
-     * Adds a `<link rel="stylesheet">` tag into the page with the desired url or
+     * Adds a `<link rel="stylesheet">` tag into the page with the desired URL or
      * a `<style type="text/css">` tag with the content.
      *
-     * @param options - Options for the style link.
-     * @returns a promise that resolves to the added tag when the stylesheets's
-     * `onload` event fires or when the CSS content was injected into the
-     * frame.
+     * @returns An {@link ElementHandle | element handle} to the loaded `<link>`
+     * or `<style>` element.
      */
-    addStyleTag(options: FrameAddStyleTagOptions): Promise<ElementHandle<HTMLStyleElement | HTMLLinkElement>>;
+    addStyleTag(options: Omit<FrameAddStyleTagOptions, 'url'>): Promise<ElementHandle<HTMLStyleElement>>;
+    addStyleTag(options: FrameAddStyleTagOptions): Promise<ElementHandle<HTMLLinkElement>>;
     /**
      * Clicks the first element found that matches `selector`.
      *
@@ -2459,7 +2462,7 @@ export declare class Frame {
         delay: number;
     }): Promise<void>;
     /**
-     * @deprecated Use `new Promise(r => setTimeout(r, milliseconds));`.
+     * @deprecated Replace with `new Promise(r => setTimeout(r, milliseconds));`.
      *
      * Causes your script to wait for the given number of milliseconds.
      *
@@ -2496,24 +2499,29 @@ export declare class Frame {
  */
 export declare interface FrameAddScriptTagOptions {
     /**
-     * the URL of the script to be added.
+     * URL of the script to be added.
      */
     url?: string;
     /**
-     * The path to a JavaScript file to be injected into the frame.
+     * Path to a JavaScript file to be injected into the frame.
+     *
      * @remarks
      * If `path` is a relative path, it is resolved relative to the current
      * working directory (`process.cwd()` in Node.js).
      */
     path?: string;
     /**
-     * Raw JavaScript content to be injected into the frame.
+     * JavaScript to be injected into the frame.
      */
     content?: string;
     /**
-     * Set the script's `type`. Use `module` in order to load an ES2015 module.
+     * Sets the `type` of the script. Use `module` in order to load an ES2015 module.
      */
     type?: string;
+    /**
+     * Sets the `id` of the script.
+     */
+    id?: string;
 }
 
 /**
@@ -2545,6 +2553,8 @@ declare interface FrameManager_2 {
 
 /* Excluded from this release type: FrameManagerEmittedEvents */
 
+/* Excluded from this release type: FrameTree */
+
 /**
  * @public
  */
@@ -2561,7 +2571,7 @@ export declare interface FrameWaitForFunctionOptions {
      *
      * - `mutation` - to execute `pageFunction` on every DOM mutation.
      */
-    polling?: string | number;
+    polling?: 'raf' | 'mutation' | number;
     /**
      * Maximum time to wait in milliseconds. Defaults to `30000` (30 seconds).
      * Pass `0` to disable the timeout. Puppeteer's default timeout can be changed
@@ -2608,9 +2618,6 @@ export declare type HandleFor<T> = T extends Node ? ElementHandle<T> : JSHandle<
  */
 export declare type HandleOr<T> = HandleFor<T> | JSHandle<T> | T;
 
-/**
- * @public
- */
 export declare type Handler<T = any> = (event?: T) => void;
 
 /**
@@ -2657,7 +2664,7 @@ export declare class HTTPRequest {
      *
      * @experimental
      */
-    get client(): CDPSession_4;
+    get client(): CDPSession_3;
     /* Excluded from this release type: __constructor */
     /**
      * @returns the URL of the request
@@ -2961,7 +2968,7 @@ export declare class HTTPResponse {
 
     /* Excluded from this release type: importFS */
 
-    /* Excluded from this release type: initializePuppeteer */
+    /* Excluded from this release type: InnerLazyParams */
 
     /**
      * @public
@@ -3006,6 +3013,12 @@ export declare class HTTPResponse {
 
     /* Excluded from this release type: InternalQueryHandler */
 
+    /* Excluded from this release type: IntervalPoller */
+
+    /* Excluded from this release type: isErrnoException */
+
+    /* Excluded from this release type: isErrorLike */
+
     /* Excluded from this release type: isNode */
 
     /* Excluded from this release type: isNumber */
@@ -3018,6 +3031,8 @@ export declare class HTTPResponse {
 
     /* Excluded from this release type: isString */
 
+    /* Excluded from this release type: isTargetClosedError */
+
     /**
      * @public
      */
@@ -3028,6 +3043,7 @@ export declare class HTTPResponse {
             resetOnNavigation?: boolean;
             reportAnonymousScripts?: boolean;
             includeRawScriptCoverage?: boolean;
+            useBlockCoverage?: boolean;
         }): Promise<void>;
         stop(): Promise<JSCoverageEntry[]>;
     }
@@ -3060,6 +3076,12 @@ export declare class HTTPResponse {
          * Whether the result includes raw V8 script coverage entries.
          */
         includeRawScriptCoverage?: boolean;
+        /**
+         * Whether to collect coverage information at the block level.
+         * If true, coverage will be collected at the block level (this is the default).
+         * If false, coverage will be collected at the function level.
+         */
+        useBlockCoverage?: boolean;
     }
 
     /**
@@ -3092,10 +3114,7 @@ export declare class HTTPResponse {
         /* Excluded from this release type: client */
         /* Excluded from this release type: disposed */
         /* Excluded from this release type: __constructor */
-        /**
-         * @returns The execution context the handle belongs to.
-         */
-        executionContext(): ExecutionContext;
+        /* Excluded from this release type: executionContext */
         /**
          * Evaluates the given function with the current handle as its first argument.
          *
@@ -3182,7 +3201,7 @@ export declare class HTTPResponse {
      * {@link Keyboard.up}, and {@link Keyboard.sendCharacter}
      * to manually fire events as if they were generated from a real keyboard.
      *
-     * On MacOS, keyboard shortcuts like `⌘ A` -\> Select All do not work.
+     * On macOS, keyboard shortcuts like `⌘ A` -\> Select All do not work.
      * See {@link https://github.com/puppeteer/puppeteer/issues/1313 | #1313}.
      *
      * @example
@@ -3334,6 +3353,29 @@ export declare class HTTPResponse {
      */
     export declare type KeyInput = '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | 'Power' | 'Eject' | 'Abort' | 'Help' | 'Backspace' | 'Tab' | 'Numpad5' | 'NumpadEnter' | 'Enter' | '\r' | '\n' | 'ShiftLeft' | 'ShiftRight' | 'ControlLeft' | 'ControlRight' | 'AltLeft' | 'AltRight' | 'Pause' | 'CapsLock' | 'Escape' | 'Convert' | 'NonConvert' | 'Space' | 'Numpad9' | 'PageUp' | 'Numpad3' | 'PageDown' | 'End' | 'Numpad1' | 'Home' | 'Numpad7' | 'ArrowLeft' | 'Numpad4' | 'Numpad8' | 'ArrowUp' | 'ArrowRight' | 'Numpad6' | 'Numpad2' | 'ArrowDown' | 'Select' | 'Open' | 'PrintScreen' | 'Insert' | 'Numpad0' | 'Delete' | 'NumpadDecimal' | 'Digit0' | 'Digit1' | 'Digit2' | 'Digit3' | 'Digit4' | 'Digit5' | 'Digit6' | 'Digit7' | 'Digit8' | 'Digit9' | 'KeyA' | 'KeyB' | 'KeyC' | 'KeyD' | 'KeyE' | 'KeyF' | 'KeyG' | 'KeyH' | 'KeyI' | 'KeyJ' | 'KeyK' | 'KeyL' | 'KeyM' | 'KeyN' | 'KeyO' | 'KeyP' | 'KeyQ' | 'KeyR' | 'KeyS' | 'KeyT' | 'KeyU' | 'KeyV' | 'KeyW' | 'KeyX' | 'KeyY' | 'KeyZ' | 'MetaLeft' | 'MetaRight' | 'ContextMenu' | 'NumpadMultiply' | 'NumpadAdd' | 'NumpadSubtract' | 'NumpadDivide' | 'F1' | 'F2' | 'F3' | 'F4' | 'F5' | 'F6' | 'F7' | 'F8' | 'F9' | 'F10' | 'F11' | 'F12' | 'F13' | 'F14' | 'F15' | 'F16' | 'F17' | 'F18' | 'F19' | 'F20' | 'F21' | 'F22' | 'F23' | 'F24' | 'NumLock' | 'ScrollLock' | 'AudioVolumeMute' | 'AudioVolumeDown' | 'AudioVolumeUp' | 'MediaTrackNext' | 'MediaTrackPrevious' | 'MediaStop' | 'MediaPlayPause' | 'Semicolon' | 'Equal' | 'NumpadEqual' | 'Comma' | 'Minus' | 'Period' | 'Slash' | 'Backquote' | 'BracketLeft' | 'Backslash' | 'BracketRight' | 'Quote' | 'AltGraph' | 'Props' | 'Cancel' | 'Clear' | 'Shift' | 'Control' | 'Alt' | 'Accept' | 'ModeChange' | ' ' | 'Print' | 'Execute' | '\u0000' | 'a' | 'b' | 'c' | 'd' | 'e' | 'f' | 'g' | 'h' | 'i' | 'j' | 'k' | 'l' | 'm' | 'n' | 'o' | 'p' | 'q' | 'r' | 's' | 't' | 'u' | 'v' | 'w' | 'x' | 'y' | 'z' | 'Meta' | '*' | '+' | '-' | '/' | ';' | '=' | ',' | '.' | '`' | '[' | '\\' | ']' | "'" | 'Attn' | 'CrSel' | 'ExSel' | 'EraseEof' | 'Play' | 'ZoomOut' | ')' | '!' | '@' | '#' | '$' | '%' | '^' | '&' | '(' | 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G' | 'H' | 'I' | 'J' | 'K' | 'L' | 'M' | 'N' | 'O' | 'P' | 'Q' | 'R' | 'S' | 'T' | 'U' | 'V' | 'W' | 'X' | 'Y' | 'Z' | ':' | '<' | '_' | '>' | '?' | '~' | '{' | '|' | '}' | '"' | 'SoftLeft' | 'SoftRight' | 'Camera' | 'Call' | 'EndCall' | 'VolumeDown' | 'VolumeUp';
 
+    /**
+     * A list of devices to be used with {@link Page.emulate}.
+     *
+     * @example
+     *
+     * ```ts
+     * import {KnownDevices} from 'puppeteer';
+     * const iPhone = KnownDevices['iPhone 6'];
+     *
+     * (async () => {
+     *   const browser = await puppeteer.launch();
+     *   const page = await browser.newPage();
+     *   await page.emulate(iPhone);
+     *   await page.goto('https://www.google.com');
+     *   // other actions...
+     *   await browser.close();
+     * })();
+     * ```
+     *
+     * @public
+     */
+    export declare const KnownDevices: Readonly<Record<"Blackberry PlayBook" | "Blackberry PlayBook landscape" | "BlackBerry Z30" | "BlackBerry Z30 landscape" | "Galaxy Note 3" | "Galaxy Note 3 landscape" | "Galaxy Note II" | "Galaxy Note II landscape" | "Galaxy S III" | "Galaxy S III landscape" | "Galaxy S5" | "Galaxy S5 landscape" | "Galaxy S8" | "Galaxy S8 landscape" | "Galaxy S9+" | "Galaxy S9+ landscape" | "Galaxy Tab S4" | "Galaxy Tab S4 landscape" | "iPad" | "iPad landscape" | "iPad (gen 6)" | "iPad (gen 6) landscape" | "iPad (gen 7)" | "iPad (gen 7) landscape" | "iPad Mini" | "iPad Mini landscape" | "iPad Pro" | "iPad Pro landscape" | "iPad Pro 11" | "iPad Pro 11 landscape" | "iPhone 4" | "iPhone 4 landscape" | "iPhone 5" | "iPhone 5 landscape" | "iPhone 6" | "iPhone 6 landscape" | "iPhone 6 Plus" | "iPhone 6 Plus landscape" | "iPhone 7" | "iPhone 7 landscape" | "iPhone 7 Plus" | "iPhone 7 Plus landscape" | "iPhone 8" | "iPhone 8 landscape" | "iPhone 8 Plus" | "iPhone 8 Plus landscape" | "iPhone SE" | "iPhone SE landscape" | "iPhone X" | "iPhone X landscape" | "iPhone XR" | "iPhone XR landscape" | "iPhone 11" | "iPhone 11 landscape" | "iPhone 11 Pro" | "iPhone 11 Pro landscape" | "iPhone 11 Pro Max" | "iPhone 11 Pro Max landscape" | "iPhone 12" | "iPhone 12 landscape" | "iPhone 12 Pro" | "iPhone 12 Pro landscape" | "iPhone 12 Pro Max" | "iPhone 12 Pro Max landscape" | "iPhone 12 Mini" | "iPhone 12 Mini landscape" | "iPhone 13" | "iPhone 13 landscape" | "iPhone 13 Pro" | "iPhone 13 Pro landscape" | "iPhone 13 Pro Max" | "iPhone 13 Pro Max landscape" | "iPhone 13 Mini" | "iPhone 13 Mini landscape" | "JioPhone 2" | "JioPhone 2 landscape" | "Kindle Fire HDX" | "Kindle Fire HDX landscape" | "LG Optimus L70" | "LG Optimus L70 landscape" | "Microsoft Lumia 550" | "Microsoft Lumia 950" | "Microsoft Lumia 950 landscape" | "Nexus 10" | "Nexus 10 landscape" | "Nexus 4" | "Nexus 4 landscape" | "Nexus 5" | "Nexus 5 landscape" | "Nexus 5X" | "Nexus 5X landscape" | "Nexus 6" | "Nexus 6 landscape" | "Nexus 6P" | "Nexus 6P landscape" | "Nexus 7" | "Nexus 7 landscape" | "Nokia Lumia 520" | "Nokia Lumia 520 landscape" | "Nokia N9" | "Nokia N9 landscape" | "Pixel 2" | "Pixel 2 landscape" | "Pixel 2 XL" | "Pixel 2 XL landscape" | "Pixel 3" | "Pixel 3 landscape" | "Pixel 4" | "Pixel 4 landscape" | "Pixel 4a (5G)" | "Pixel 4a (5G) landscape" | "Pixel 5" | "Pixel 5 landscape" | "Moto G4" | "Moto G4 landscape", Device>>;
+
     export declare const launch: (options?: PuppeteerLaunchOptions) => Promise<Browser>;
 
     /**
@@ -3412,9 +3454,9 @@ export declare class HTTPResponse {
         waitForInitialPage?: boolean;
     }
 
-    /* Excluded from this release type: LifecycleWatcher */
+    /* Excluded from this release type: LazyArg */
 
-    /* Excluded from this release type: logPolitely */
+    /* Excluded from this release type: LifecycleWatcher */
 
     /**
      * @public
@@ -3423,8 +3465,6 @@ export declare class HTTPResponse {
 
     /* Excluded from this release type: MAIN_WORLD */
 
-    /* Excluded from this release type: makePredicateString */
-
     /**
      * @public
      */
@@ -3604,7 +3644,7 @@ export declare class HTTPResponse {
         drop(target: Point, data: Protocol.Input.DragData): Promise<void>;
         /**
          * Performs a drag, dragenter, dragover, and drop in sequence.
-         * @param target - point to drag from
+         * @param start - point to drag from
          * @param target - point to drop on
          * @param options - An object of options. Accepts delay which,
          * if specified, is the time to wait between `dragover` and `drop` in milliseconds.
@@ -3636,6 +3676,8 @@ export declare class HTTPResponse {
         deltaY?: number;
     }
 
+    /* Excluded from this release type: MutationPoller */
+
     /**
      * @public
      */
@@ -3646,26 +3688,7 @@ export declare class HTTPResponse {
     }
 
     /**
-     * A list of network conditions to be used with
-     * `page.emulateNetworkConditions(networkConditions)`. Actual list of predefined
-     * conditions can be found in
-     * {@link https://github.com/puppeteer/puppeteer/blob/main/src/common/NetworkConditions.ts | src/common/NetworkConditions.ts}.
-     *
-     * @example
-     *
-     * ```ts
-     * const puppeteer = require('puppeteer');
-     * const slow3G = puppeteer.networkConditions['Slow 3G'];
-     *
-     * (async () => {
-     *   const browser = await puppeteer.launch();
-     *   const page = await browser.newPage();
-     *   await page.emulateNetworkConditions(slow3G);
-     *   await page.goto('https://www.google.com');
-     *   // other actions...
-     *   await browser.close();
-     * })();
-     * ```
+     * @deprecated Import {@link PredefinedNetworkConditions}.
      *
      * @public
      */
@@ -3694,11 +3717,11 @@ export declare class HTTPResponse {
      */
     export declare interface Offset {
         /**
-         * x-offset for the clickable point relative to the top-left corder of the border box.
+         * x-offset for the clickable point relative to the top-left corner of the border box.
          */
         x: number;
         /**
-         * y-offset for the clickable point relative to the top-left corder of the border box.
+         * y-offset for the clickable point relative to the top-left corner of the border box.
          */
         y: number;
     }
@@ -3756,7 +3779,6 @@ export declare class HTTPResponse {
      */
     export declare class Page extends EventEmitter {
         #private;
-        /* Excluded from this release type: _create */
         /* Excluded from this release type: __constructor */
         /**
          * @returns `true` if drag events are being intercepted, `false` otherwise.
@@ -3827,7 +3849,6 @@ export declare class HTTPResponse {
          * @returns A target this page was created from.
          */
         target(): Target;
-        /* Excluded from this release type: _client */
         /**
          * Get the browser the page belongs to.
          */
@@ -3910,20 +3931,26 @@ export declare class HTTPResponse {
          */
         setDragInterception(enabled: boolean): Promise<void>;
         /**
+         * Sets the network connection to offline.
+         *
+         * It does not change the parameters used in {@link Page.emulateNetworkConditions}
+         *
          * @param enabled - When `true`, enables offline mode for the page.
-         * @remarks
-         * NOTE: while this method sets the network connection to offline, it does
-         * not change the parameters used in [page.emulateNetworkConditions(networkConditions)]
-         * (#pageemulatenetworkconditionsnetworkconditions)
          */
         setOfflineMode(enabled: boolean): Promise<void>;
         /**
-         * @param networkConditions - Passing `null` disables network condition emulation.
+         * This does not affect WebSockets and WebRTC PeerConnections (see
+         * https://crbug.com/563644). To set the page offline, you can use
+         * {@link Page.setOfflineMode}.
+         *
+         * A list of predefined network conditions can be used by importing
+         * {@link PredefinedNetworkConditions}.
+         *
          * @example
          *
          * ```ts
-         * const puppeteer = require('puppeteer');
-         * const slow3G = puppeteer.networkConditions['Slow 3G'];
+         * import {PredefinedNetworkConditions} from 'puppeteer';
+         * const slow3G = PredefinedNetworkConditions['Slow 3G'];
          *
          * (async () => {
          *   const browser = await puppeteer.launch();
@@ -3935,10 +3962,8 @@ export declare class HTTPResponse {
          * })();
          * ```
          *
-         * @remarks
-         * NOTE: This does not affect WebSockets and WebRTC PeerConnections (see
-         * https://crbug.com/563644). To set the page offline, you can use
-         * [page.setOfflineMode(enabled)](#pagesetofflinemodeenabled).
+         * @param networkConditions - Passing `null` disables network condition
+         * emulation.
          */
         emulateNetworkConditions(networkConditions: NetworkConditions | null): Promise<void>;
         /**
@@ -3963,6 +3988,10 @@ export declare class HTTPResponse {
          * @param timeout - Maximum time in milliseconds.
          */
         setDefaultTimeout(timeout: number): void;
+        /**
+         * @returns Maximum time in milliseconds.
+         */
+        getDefaultTimeout(): number;
         /**
          * Runs `document.querySelector` within the page. If no element matches the
          * selector, the return value resolves to `null`.
@@ -4042,11 +4071,6 @@ export declare class HTTPResponse {
          * This method iterates the JavaScript heap and finds all objects with the
          * given prototype.
          *
-         * @remarks
-         * Shortcut for
-         * {@link ExecutionContext.queryObjects |
-         * page.mainFrame().executionContext().queryObjects(prototypeHandle)}.
-         *
          * @example
          *
          * ```ts
@@ -4231,27 +4255,24 @@ export declare class HTTPResponse {
          * Shortcut for
          * {@link Frame.addScriptTag | page.mainFrame().addScriptTag(options)}.
          *
-         * @returns Promise which resolves to the added tag when the script's onload
-         * fires or when the script content was injected into frame.
+         * @param options - Options for the script.
+         * @returns An {@link ElementHandle | element handle} to the injected
+         * `<script>` element.
          */
-        addScriptTag(options: {
-            url?: string;
-            path?: string;
-            content?: string;
-            type?: string;
-            id?: string;
-        }): Promise<ElementHandle<HTMLScriptElement>>;
+        addScriptTag(options: FrameAddScriptTagOptions): Promise<ElementHandle<HTMLScriptElement>>;
         /**
-         * Adds a `<link rel="stylesheet">` tag into the page with the desired URL or a
-         * `<style type="text/css">` tag with the content.
-         * @returns Promise which resolves to the added tag when the stylesheet's
-         * onload fires or when the CSS content was injected into frame.
+         * Adds a `<link rel="stylesheet">` tag into the page with the desired URL or
+         * a `<style type="text/css">` tag with the content.
+         *
+         * Shortcut for
+         * {@link Frame.addStyleTag | page.mainFrame().addStyleTag(options)}.
+         *
+         * @returns An {@link ElementHandle | element handle} to the injected `<link>`
+         * or `<style>` element.
          */
-        addStyleTag(options: {
-            url?: string;
-            path?: string;
-            content?: string;
-        }): Promise<ElementHandle<Node>>;
+        addStyleTag(options: Omit<FrameAddStyleTagOptions, 'url'>): Promise<ElementHandle<HTMLStyleElement>>;
+        addStyleTag(options: FrameAddStyleTagOptions): Promise<ElementHandle<HTMLLinkElement>>;
+        addStyleTag(options: FrameAddStyleTagOptions): Promise<ElementHandle<HTMLStyleElement | HTMLLinkElement>>;
         /**
          * The method adds a function called `name` on the page's `window` object.
          * When called, the function executes `puppeteerFunction` in node.js and
@@ -4543,21 +4564,17 @@ export declare class HTTPResponse {
         /**
          * @param urlOrPredicate - A URL or predicate to wait for
          * @param options - Optional waiting parameters
-         * @returns Promise which resolves to the matched response
+         * @returns Promise which resolves to the matched request
          * @example
          *
          * ```ts
-         * const firstResponse = await page.waitForResponse(
+         * const firstRequest = await page.waitForRequest(
          *   'https://example.com/resource'
          * );
-         * const finalResponse = await page.waitForResponse(
-         *   response =>
-         *     response.url() === 'https://example.com' && response.status() === 200
+         * const finalRequest = await page.waitForRequest(
+         *   request => request.url() === 'https://example.com'
          * );
-         * const finalResponse = await page.waitForResponse(async response => {
-         *   return (await response.text()).includes('<html>');
-         * });
-         * return finalResponse.ok();
+         * return finalRequest.response()?.ok();
          * ```
          *
          * @remarks
@@ -4689,20 +4706,25 @@ export declare class HTTPResponse {
          */
         bringToFront(): Promise<void>;
         /**
-         * Emulates given device metrics and user agent.
+         * Emulates a given device's metrics and user agent.
+         *
+         * To aid emulation, Puppeteer provides a list of known devices that can be
+         * via {@link KnownDevices}.
          *
          * @remarks
          * This method is a shortcut for calling two methods:
-         * {@link Page.setUserAgent} and {@link Page.setViewport} To aid emulation,
-         * Puppeteer provides a list of device descriptors that can be obtained via
-         * {@link devices}. `page.emulate` will resize the page. A lot of websites
-         * don't expect phones to change size, so you should emulate before navigating
-         * to the page.
+         * {@link Page.setUserAgent} and {@link Page.setViewport}.
+         *
+         * @remarks
+         * This method will resize the page. A lot of websites don't expect phones to
+         * change size, so you should emulate before navigating to the page.
+         *
          * @example
          *
          * ```ts
-         * const puppeteer = require('puppeteer');
-         * const iPhone = puppeteer.devices['iPhone 6'];
+         * import {KnownDevices} from 'puppeteer';
+         * const iPhone = KnownDevices['iPhone 6'];
+         *
          * (async () => {
          *   const browser = await puppeteer.launch();
          *   const page = await browser.newPage();
@@ -4712,17 +4734,10 @@ export declare class HTTPResponse {
          *   await browser.close();
          * })();
          * ```
-         *
-         * @remarks List of all available devices is available in the source code:
-         * {@link https://github.com/puppeteer/puppeteer/blob/main/src/common/DeviceDescriptors.ts | src/common/DeviceDescriptors.ts}.
          */
-        emulate(options: {
-            viewport: Viewport;
-            userAgent: string;
-        }): Promise<void>;
+        emulate(device: Device): Promise<void>;
         /**
          * @param enabled - Whether or not to enable JavaScript on the page.
-         * @returns
          * @remarks
          * NOTE: changing this value won't affect scripts that have already been run.
          * It will take full effect on the next navigation.
@@ -5019,13 +5034,13 @@ export declare class HTTPResponse {
          *
          * // overwrite the `languages` property to use a custom getter
          * Object.defineProperty(navigator, 'languages', {
-         * get: function () {
-         * return ['en-US', 'en', 'bn'];
-         * },
+         *   get: function () {
+         *     return ['en-US', 'en', 'bn'];
+         *   },
          * });
          *
          * // In your puppeteer script, assuming the preload.js file is
-         * in same folder of our script
+         * // in same folder of our script.
          * const preloadFile = fs.readFileSync('./preload.js', 'utf8');
          * await page.evaluateOnNewDocument(preloadFile);
          * ```
@@ -5035,6 +5050,7 @@ export declare class HTTPResponse {
          * Toggles ignoring cache for each request based on the enabled state. By
          * default, caching is enabled.
          * @param enabled - sets the `enabled` state of cache
+         * @defaultValue true
          */
         setCacheEnabled(enabled?: boolean): Promise<void>;
         /**
@@ -5249,7 +5265,7 @@ export declare class HTTPResponse {
             delay: number;
         }): Promise<void>;
         /**
-         * @deprecated Use `new Promise(r => setTimeout(r, milliseconds));`.
+         * @deprecated Replace with `new Promise(r => setTimeout(r, milliseconds));`.
          *
          * Causes your script to wait for the given number of milliseconds.
          *
@@ -5319,7 +5335,7 @@ export declare class HTTPResponse {
          *   (30 seconds). Pass `0` to disable timeout. The default value can be changed
          *   by using the {@link Page.setDefaultTimeout} method.
          */
-        waitForSelector<Selector extends string>(selector: Selector, options?: Exclude<WaitForSelectorOptions, 'root'>): Promise<ElementHandle<NodeFor<Selector>> | null>;
+        waitForSelector<Selector extends string>(selector: Selector, options?: WaitForSelectorOptions): Promise<ElementHandle<NodeFor<Selector>> | null>;
         /**
          * Wait for the `xpath` to appear in page. If at the moment of calling the
          * method the `xpath` already exists, the method will return immediately. If
@@ -5430,27 +5446,9 @@ export declare class HTTPResponse {
          * ```
          *
          * @param pageFunction - Function to be evaluated in browser context
-         * @param options - Optional waiting parameters
-         *
-         * - `polling` - An interval at which the `pageFunction` is executed, defaults
-         *   to `raf`. If `polling` is a number, then it is treated as an interval in
-         *   milliseconds at which the function would be executed. If polling is a
-         *   string, then it can be one of the following values:
-         *   - `raf` - to constantly execute `pageFunction` in
-         *     `requestAnimationFrame` callback. This is the tightest polling mode
-         *     which is suitable to observe styling changes.
-         *   - `mutation`- to execute pageFunction on every DOM mutation.
-         * - `timeout` - maximum time to wait for in milliseconds. Defaults to `30000`
-         *   (30 seconds). Pass `0` to disable timeout. The default value can be
-         *   changed by using the {@link Page.setDefaultTimeout} method.
-         *   @param args - Arguments to pass to `pageFunction`
-         *   @returns A `Promise` which resolves to a JSHandle/ElementHandle of the the
-         *   `pageFunction`'s return value.
-         */
-        waitForFunction<Params extends unknown[], Func extends EvaluateFunc<Params> = EvaluateFunc<Params>>(pageFunction: Func | string, options?: {
-            timeout?: number;
-            polling?: string | number;
-        }, ...args: Params): Promise<HandleFor<Awaited<ReturnType<Func>>>>;
+         * @param options - Options for configuring waiting behavior.
+         */
+        waitForFunction<Params extends unknown[], Func extends EvaluateFunc<Params> = EvaluateFunc<Params>>(pageFunction: Func | string, options?: FrameWaitForFunctionOptions, ...args: Params): Promise<HandleFor<Awaited<ReturnType<Func>>>>;
     }
 
     /* Excluded from this release type: PageBinding */
@@ -5830,6 +5828,35 @@ export declare class HTTPResponse {
         y: number;
     }
 
+    /* Excluded from this release type: Poller */
+
+    /**
+     * A list of network conditions to be used with
+     * {@link Page.emulateNetworkConditions}.
+     *
+     * @example
+     *
+     * ```ts
+     * import {PredefinedNetworkConditions} from 'puppeteer';
+     * const slow3G = PredefinedNetworkConditions['Slow 3G'];
+     *
+     * (async () => {
+     *   const browser = await puppeteer.launch();
+     *   const page = await browser.newPage();
+     *   await page.emulateNetworkConditions(slow3G);
+     *   await page.goto('https://www.google.com');
+     *   // other actions...
+     *   await browser.close();
+     * })();
+     * ```
+     *
+     * @public
+     */
+    export declare const PredefinedNetworkConditions: Readonly<{
+        'Slow 3G': NetworkConditions;
+        'Fast 3G': NetworkConditions;
+    }>;
+
     /**
      * @public
      */
@@ -5867,13 +5894,19 @@ export declare class HTTPResponse {
 
     /**
      * Describes a launcher - a class that is able to create and launch a browser instance.
+     *
      * @public
      */
-    export declare interface ProductLauncher {
+    export declare class ProductLauncher {
+        #private;
+        /* Excluded from this release type: puppeteer */
+        /* Excluded from this release type: __constructor */
+        get product(): Product;
         launch(object: PuppeteerNodeLaunchOptions): Promise<Browser>;
-        executablePath: (path?: any) => string;
+        executablePath(channel?: ChromeReleaseChannel): string;
         defaultArgs(object: BrowserLaunchArgumentOptions): string[];
-        product: Product;
+        /* Excluded from this release type: getProfilePath */
+        /* Excluded from this release type: resolveExecutablePath */
     }
 
     export { Protocol }
@@ -5884,8 +5917,23 @@ export declare class HTTPResponse {
      * @public
      */
     export declare class ProtocolError extends CustomError {
-        code?: number;
-        originalMessage: string;
+        #private;
+        /**
+         * @internal
+         */
+        set code(code: number | undefined);
+        /**
+         * @public
+         */
+        get code(): number | undefined;
+        /**
+         * @internal
+         */
+        set originalMessage(originalMessage: string);
+        /**
+         * @public
+         */
+        get originalMessage(): string;
     }
 
     /**
@@ -5905,90 +5953,62 @@ export declare class HTTPResponse {
      * @public
      */
     export declare class Puppeteer {
-        protected _isPuppeteerCore: boolean;
-        protected _changedProduct: boolean;
-        /* Excluded from this release type: __constructor */
         /**
-         * This method attaches Puppeteer to an existing browser instance.
+         * Registers a {@link CustomQueryHandler | custom query handler}.
          *
          * @remarks
+         * After registration, the handler can be used everywhere where a selector is
+         * expected by prepending the selection string with `<name>/`. The name is only
+         * allowed to consist of lower- and upper case latin letters.
          *
-         * @param options - Set of configurable options to set on the browser.
-         * @returns Promise which resolves to browser instance.
-         */
-        connect(options: ConnectOptions): Promise<Browser>;
-        /**
-         * @deprecated Import directly puppeteer.
          * @example
          *
-         * ```ts
-         * import {devices} from 'puppeteer';
          * ```
-         */
-        get devices(): typeof devices;
-        /**
-         * @deprecated Import directly puppeteer.
-         * @example
-         *
-         * ```ts
-         * import {errors} from 'puppeteer';
+         * puppeteer.registerCustomQueryHandler('text', { … });
+         * const aHandle = await page.$('text/…');
          * ```
-         */
-        get errors(): typeof errors;
-        /**
-         * @deprecated Import directly puppeteer.
-         * @example
          *
-         * ```ts
-         * import {networkConditions} from 'puppeteer';
-         * ```
+         * @param name - The name that the custom query handler will be registered
+         * under.
+         * @param queryHandler - The {@link CustomQueryHandler | custom query handler}
+         * to register.
+         *
+         * @public
          */
-        get networkConditions(): typeof networkConditions;
+        static registerCustomQueryHandler(name: string, queryHandler: CustomQueryHandler): void;
         /**
-         * @deprecated Import directly puppeteer.
-         * @example
-         *
-         * ```ts
-         * import {registerCustomQueryHandler} from 'puppeteer';
-         * ```
+         * Unregisters a custom query handler for a given name.
          */
-        registerCustomQueryHandler(name: string, queryHandler: CustomQueryHandler): void;
+        static unregisterCustomQueryHandler(name: string): void;
         /**
-         * @deprecated Import directly puppeteer.
-         * @example
-         *
-         * ```ts
-         * import {unregisterCustomQueryHandler} from 'puppeteer';
-         * ```
+         * Gets the names of all custom query handlers.
          */
-        unregisterCustomQueryHandler(name: string): void;
+        static customQueryHandlerNames(): string[];
         /**
-         * @deprecated Import directly puppeteer.
-         * @example
-         *
-         * ```ts
-         * import {customQueryHandlerNames} from 'puppeteer';
-         * ```
+         * Unregisters all custom query handlers.
          */
-        customQueryHandlerNames(): string[];
+        static clearCustomQueryHandlers(): void;
+        /* Excluded from this release type: _isPuppeteerCore */
+        /* Excluded from this release type: _changedProduct */
+        /* Excluded from this release type: __constructor */
         /**
-         * @deprecated Import directly puppeteer.
-         * @example
+         * This method attaches Puppeteer to an existing browser instance.
          *
-         * ```ts
-         * import {clearCustomQueryHandlers} from 'puppeteer';
-         * ```
+         * @remarks
+         *
+         * @param options - Set of configurable options to set on the browser.
+         * @returns Promise which resolves to browser instance.
          */
-        clearCustomQueryHandlers(): void;
+        connect(options: ConnectOptions): Promise<Browser>;
     }
 
     /* Excluded from this release type: PUPPETEER_REVISIONS */
 
     /* Excluded from this release type: PUPPETEER_WORLD */
 
-    /* Excluded from this release type: puppeteerDirname */
-
     /**
+     * @deprecated Do not use.
+     *
      * @public
      */
     export declare interface PuppeteerErrors {
@@ -6048,23 +6068,29 @@ export declare class HTTPResponse {
      */
     export declare class PuppeteerNode extends Puppeteer {
         #private;
-        _preferredRevision: string;
+        /* Excluded from this release type: defaultBrowserRevision */
+        /* Excluded from this release type: configuration */
         /* Excluded from this release type: __constructor */
         /**
          * This method attaches Puppeteer to an existing browser instance.
          *
          * @param options - Set of configurable options to set on the browser.
          * @returns Promise which resolves to browser instance.
+         *
+         * @public
          */
         connect(options: ConnectOptions): Promise<Browser>;
-        /* Excluded from this release type: _productName */
-        /* Excluded from this release type: _productName */
         /**
-         * Launches puppeteer and launches a browser instance with given arguments and
-         * options when specified.
+         * Launches a browser instance with given arguments and options when
+         * specified.
+         *
+         * When using with `puppeteer-core`,
+         * {@link LaunchOptions.executablePath | options.executablePath} or
+         * {@link LaunchOptions.channel | options.channel} must be provided.
          *
          * @example
-         * You can use `ignoreDefaultArgs` to filter out `--mute-audio` from default arguments:
+         * You can use {@link LaunchOptions.ignoreDefaultArgs | options.ignoreDefaultArgs}
+         * to filter out `--mute-audio` from default arguments:
          *
          * ```ts
          * const browser = await puppeteer.launch({
@@ -6073,57 +6099,75 @@ export declare class HTTPResponse {
          * ```
          *
          * @remarks
-         * **NOTE** Puppeteer can also be used to control the Chrome browser, but it
-         * works best with the version of Chromium it is bundled with. There is no
-         * guarantee it will work with any other version. Use `executablePath` option
-         * with extreme caution. If Google Chrome (rather than Chromium) is preferred,
-         * a {@link https://www.google.com/chrome/browser/canary.html | Chrome Canary}
+         * Puppeteer can also be used to control the Chrome browser, but it works best
+         * with the version of Chromium downloaded by default by Puppeteer. There is
+         * no guarantee it will work with any other version. If Google Chrome (rather
+         * than Chromium) is preferred, a
+         * {@link https://www.google.com/chrome/browser/canary.html | Chrome Canary}
          * or
          * {@link https://www.chromium.org/getting-involved/dev-channel | Dev Channel}
-         * build is suggested. In `puppeteer.launch([options])`, any mention of
-         * Chromium also applies to Chrome. See
+         * build is suggested. See
          * {@link https://www.howtogeek.com/202825/what%E2%80%99s-the-difference-between-chromium-and-chrome/ | this article}
          * for a description of the differences between Chromium and Chrome.
          * {@link https://chromium.googlesource.com/chromium/src/+/lkgr/docs/chromium_browser_vs_google_chrome.md | This article}
          * describes some differences for Linux users.
          *
-         * @param options - Set of configurable options to set on the browser.
-         * @returns Promise which resolves to browser instance.
+         * @param options - Options to configure launching behavior.
+         *
+         * @public
          */
         launch(options?: PuppeteerLaunchOptions): Promise<Browser>;
         /**
-         * @remarks
-         * **NOTE** `puppeteer.executablePath()` is affected by the
-         * `PUPPETEER_EXECUTABLE_PATH` and `PUPPETEER_CHROMIUM_REVISION` environment
-         * variables.
+         * @returns The default executable path.
          *
-         * @returns A path where Puppeteer expects to find the bundled browser. The
-         * browser binary might not be there if the download was skipped with the
-         * `PUPPETEER_SKIP_DOWNLOAD` environment variable.
+         * @public
          */
-        executablePath(channel?: string): string;
-        /* Excluded from this release type: _launcher */
+        executablePath(channel?: ChromeReleaseChannel): string;
+        /* Excluded from this release type: browserRevision */
+        /* Excluded from this release type: defaultDownloadPath */
         /**
-         * The name of the browser that is under automation (`"chrome"` or
-         * `"firefox"`)
+         * @returns The name of the browser that was last launched.
          *
-         * @remarks
-         * The product is set by the `PUPPETEER_PRODUCT` environment variable or the
-         * `product` option in `puppeteer.launch([options])` and defaults to `chrome`.
-         * Firefox support is experimental.
+         * @public
+         */
+        get lastLaunchedProduct(): Product;
+        /**
+         * @returns The name of the browser that will be launched by default. For
+         * `puppeteer`, this is influenced by your configuration. Otherwise, it's
+         * `chrome`.
+         *
+         * @public
+         */
+        get defaultProduct(): Product;
+        /**
+         * @deprecated Do not use as this field as it does not take into account
+         * multiple browsers of different types. Use
+         * {@link PuppeteerNode.defaultProduct | defaultProduct} or
+         * {@link PuppeteerNode.lastLaunchedProduct | lastLaunchedProduct}.
+         *
+         * @returns The name of the browser that is under automation.
+         *
+         * @public
          */
         get product(): string;
         /**
          * @param options - Set of configurable options to set on the browser.
+         *
          * @returns The default flags that Chromium will be launched with.
+         *
+         * @public
          */
         defaultArgs(options?: BrowserLaunchArgumentOptions): string[];
         /**
+         * @deprecated If you are using `puppeteer-core`, do not use this method. Just
+         * construct {@link BrowserFetcher} manually.
+         *
          * @param options - Set of configurable options to specify the settings of the
          * BrowserFetcher.
+         *
          * @returns A new BrowserFetcher instance.
          */
-        createBrowserFetcher(options: BrowserFetcherOptions): BrowserFetcher;
+        createBrowserFetcher(options: Partial<BrowserFetcherOptions>): BrowserFetcher;
     }
 
     /**
@@ -6133,29 +6177,19 @@ export declare class HTTPResponse {
      */
     export declare type PuppeteerNodeLaunchOptions = BrowserLaunchArgumentOptions & LaunchOptions & BrowserConnectOptions;
 
+    /* Excluded from this release type: PuppeteerQueryHandler */
+
+    /* Excluded from this release type: PuppeteerUtil */
+
     /* Excluded from this release type: QueuedEventGroup */
 
+    /* Excluded from this release type: RAFPoller */
+
     /* Excluded from this release type: RedirectInfo */
 
     /**
-     * Registers a {@link CustomQueryHandler | custom query handler}.
-     *
-     * @remarks
-     * After registration, the handler can be used everywhere where a selector is
-     * expected by prepending the selection string with `<name>/`. The name is only
-     * allowed to consist of lower- and upper case latin letters.
-     *
-     * @example
-     *
-     * ```
-     * puppeteer.registerCustomQueryHandler('text', { … });
-     * const aHandle = await page.$('text/…');
-     * ```
-     *
-     * @param name - The name that the custom query handler will be registered
-     * under.
-     * @param queryHandler - The {@link CustomQueryHandler | custom query handler}
-     * to register.
+     * @deprecated Import {@link Puppeteer} and use the static method
+     * {@link Puppeteer.registerCustomQueryHandler}
      *
      * @public
      */
@@ -6173,8 +6207,6 @@ export declare class HTTPResponse {
 
     /* Excluded from this release type: removeEventListeners */
 
-    /* Excluded from this release type: resolveExecutablePath */
-
     /**
      * Resource types for HTTPRequests as perceived by the rendering engine.
      *
@@ -6197,8 +6229,6 @@ export declare class HTTPResponse {
         body: string | Buffer;
     }
 
-    /* Excluded from this release type: rootDirname */
-
     /**
      * @public
      */
@@ -6207,6 +6237,10 @@ export declare class HTTPResponse {
         y: number;
         width: number;
         height: number;
+        /**
+         * @defaultValue 1
+         */
+        scale?: number;
     }
 
     /**
@@ -6387,6 +6421,8 @@ export declare class HTTPResponse {
 
          /* Excluded from this release type: source */
 
+         /* Excluded from this release type: supportedMetrics */
+
          /**
           * @public
           */
@@ -6452,8 +6488,12 @@ export declare class HTTPResponse {
 
          /* Excluded from this release type: TargetManagerEmittedEvents */
 
+         /* Excluded from this release type: TaskManager */
+
          /* Excluded from this release type: TaskQueue */
 
+         /* Excluded from this release type: TextContent */
+
          /**
           * TimeoutError is emitted whenever certain operations are terminated due to
           * timeout.
@@ -6469,8 +6509,6 @@ export declare class HTTPResponse {
 
          /* Excluded from this release type: TimeoutSettings */
 
-         /* Excluded from this release type: tmpdir */
-
          /**
           * The Touchscreen class exposes touchscreen events.
           * @public
@@ -6529,8 +6567,11 @@ export declare class HTTPResponse {
              categories?: string[];
          }
 
+         /* Excluded from this release type: unitToPixels */
+
          /**
-          * @param name - The name of the query handler to unregistered.
+          * @deprecated Import {@link Puppeteer} and use the static method
+          * {@link Puppeteer.unregisterCustomQueryHandler}
           *
           * @public
           */
@@ -6635,10 +6676,6 @@ export declare class HTTPResponse {
               * @defaultValue `30000` (30 seconds)
               */
              timeout?: number;
-             /**
-              * @deprecated Do not use. Use the {@link ElementHandle.waitForSelector}
-              */
-             root?: ElementHandle<Node>;
          }
 
          /**
@@ -6673,6 +6710,8 @@ export declare class HTTPResponse {
 
          /* Excluded from this release type: waitWithTimeout */
 
+         /* Excluded from this release type: WEB_PERMISSION_TO_PROTOCOL_PERMISSION */
+
          /**
           * This class represents a
           * {@link https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API | WebWorker}.
@@ -6702,15 +6741,11 @@ export declare class HTTPResponse {
          export declare class WebWorker extends EventEmitter {
              #private;
              /* Excluded from this release type: __constructor */
+             /* Excluded from this release type: executionContext */
              /**
               * @returns The URL of this web worker.
               */
              url(): string;
-             /**
-              * Returns the ExecutionContext the WebWorker runs in
-              * @returns The ExecutionContext the web worker runs in.
-              */
-             executionContext(): Promise<ExecutionContext>;
              /**
               * If the function passed to the `worker.evaluate` returns a Promise, then
               * `worker.evaluate` would wait for the promise to resolve and return its