chrome-devtools-frontend 1.0.1040337 → 1.0.1070764

package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/{node → common}/NodeWebSocketTransport.js

@@ -27,8 +27,6 @@ var _NodeWebSocketTransport_ws;
  */
 import NodeWebSocket from 'ws';
 import { packageVersion } from '../generated/version.js';
-import { promises as dns } from 'dns';
-import { URL } from 'url';
 /**
  * @internal
  */
@@ -49,19 +47,7 @@ export class NodeWebSocketTransport {
         // Silently ignore all errors - we don't know what to do with them.
         __classPrivateFieldGet(this, _NodeWebSocketTransport_ws, "f").addEventListener('error', () => { });
     }
-    static async create(urlString) {
-        // TODO(jrandolf): Starting in Node 17, IPv6 is favoured over IPv4 due to a change
-        // in a default option:
-        // - https://github.com/nodejs/node/issues/40537,
-        // Due to this, for Firefox, we must parse and resolve the `localhost` hostname
-        // manually with the previous behavior according to:
-        // - https://nodejs.org/api/dns.html#dnslookuphostname-options-callback
-        // because of https://bugzilla.mozilla.org/show_bug.cgi?id=1769994.
-        const url = new URL(urlString);
-        if (url.hostname === 'localhost') {
-            const { address } = await dns.lookup(url.hostname, { verbatim: false });
-            url.hostname = address;
-        }
+    static create(url) {
         return new Promise((resolve, reject) => {
             const ws = new NodeWebSocket(url, [], {
                 followRedirects: true,

package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/NodeWebSocketTransport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeWebSocketTransport.js","sourceRoot":"","sources":["../../../../src/common/NodeWebSocketTransport.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,aAAa,MAAM,IAAI,CAAC;AAE/B,OAAO,EAAC,cAAc,EAAC,MAAM,yBAAyB,CAAC;AAEvD;;GAEG;AACH,MAAM,OAAO,sBAAsB;IAuBjC,YAAY,EAAiB;QAJ7B,6CAAmB;QAKjB,uBAAA,IAAI,8BAAO,EAAE,MAAA,CAAC;QACd,uBAAA,IAAI,kCAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE;YAC3C,IAAI,IAAI,CAAC,SAAS,EAAE;gBAClB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;aACvC;QACH,CAAC,CAAC,CAAC;QACH,uBAAA,IAAI,kCAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;YACtC,IAAI,IAAI,CAAC,OAAO,EAAE;gBAChB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;aACzB;QACH,CAAC,CAAC,CAAC;QACH,mEAAmE;QACnE,uBAAA,IAAI,kCAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC/C,CAAC;IApCD,MAAM,CAAC,MAAM,CAAC,GAAW;QACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,EAAE,GAAG,IAAI,aAAa,CAAC,GAAG,EAAE,EAAE,EAAE;gBACpC,eAAe,EAAE,IAAI;gBACrB,iBAAiB,EAAE,KAAK;gBACxB,UAAU,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI;gBAC7B,OAAO,EAAE;oBACP,YAAY,EAAE,aAAa,cAAc,EAAE;iBAC5C;aACF,CAAC,CAAC;YAEH,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE;gBAC/B,OAAO,OAAO,CAAC,IAAI,sBAAsB,CAAC,EAAE,CAAC,CAAC,CAAC;YACjD,CAAC,CAAC,CAAC;YACH,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;IACL,CAAC;IAsBD,IAAI,CAAC,OAAe;QAClB,uBAAA,IAAI,kCAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IAED,KAAK;QACH,uBAAA,IAAI,kCAAI,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC;CACF"}

package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Page.d.ts

@@ -17,22 +17,20 @@
 /// <reference types="node" />
 import { Protocol } from 'devtools-protocol';
 import type { Readable } from 'stream';
+import type { Browser } from '../api/Browser.js';
+import type { BrowserContext } from '../api/BrowserContext.js';
+import { GeolocationOptions, MediaFeature, Metrics, Page, ScreenshotOptions, WaitForOptions, WaitTimeoutOptions } from '../api/Page.js';
 import { Accessibility } from './Accessibility.js';
-import { Browser, BrowserContext } from './Browser.js';
 import { CDPSession } from './Connection.js';
-import { ConsoleMessage } from './ConsoleMessage.js';
 import { Coverage } from './Coverage.js';
-import { Dialog } from './Dialog.js';
-import { WaitForSelectorOptions } from './IsolatedWorld.js';
 import { ElementHandle } from './ElementHandle.js';
-import { EventEmitter } from './EventEmitter.js';
 import { FileChooser } from './FileChooser.js';
-import { Frame } from './Frame.js';
+import { Frame, FrameAddScriptTagOptions, FrameAddStyleTagOptions, FrameWaitForFunctionOptions } from './Frame.js';
 import { HTTPRequest } from './HTTPRequest.js';
 import { HTTPResponse } from './HTTPResponse.js';
 import { Keyboard, Mouse, MouseButton, Touchscreen } from './Input.js';
+import { WaitForSelectorOptions } from './IsolatedWorld.js';
 import { JSHandle } from './JSHandle.js';
-import { PuppeteerLifeCycleEvent } from './LifecycleWatcher.js';
 import { Credentials, NetworkConditions } from './NetworkManager.js';
 import { PDFOptions } from './PDFOptions.js';
 import { Viewport } from './PuppeteerViewport.js';
@@ -42,374 +40,14 @@ import { Tracing } from './Tracing.js';
 import { EvaluateFunc, HandleFor, NodeFor } from './types.js';
 import { WebWorker } from './WebWorker.js';
 /**
- * @public
+ * @internal
  */
-export interface Metrics {
-    Timestamp?: number;
-    Documents?: number;
-    Frames?: number;
-    JSEventListeners?: number;
-    Nodes?: number;
-    LayoutCount?: number;
-    RecalcStyleCount?: number;
-    LayoutDuration?: number;
-    RecalcStyleDuration?: number;
-    ScriptDuration?: number;
-    TaskDuration?: number;
-    JSHeapUsedSize?: number;
-    JSHeapTotalSize?: number;
-}
-/**
- * @public
- */
-export interface WaitTimeoutOptions {
-    /**
-     * Maximum wait time in milliseconds. Pass 0 to disable the timeout.
-     *
-     * The default value can be changed by using the
-     * {@link Page.setDefaultTimeout} method.
-     *
-     * @defaultValue `30000`
-     */
-    timeout?: number;
-}
-/**
- * @public
- */
-export interface WaitForOptions {
-    /**
-     * Maximum wait time in milliseconds. Pass 0 to disable the timeout.
-     *
-     * The default value can be changed by using the
-     * {@link Page.setDefaultTimeout} or {@link Page.setDefaultNavigationTimeout}
-     * methods.
-     *
-     * @defaultValue `30000`
-     */
-    timeout?: number;
-    waitUntil?: PuppeteerLifeCycleEvent | PuppeteerLifeCycleEvent[];
-}
-/**
- * @public
- */
-export interface GeolocationOptions {
-    /**
-     * Latitude between `-90` and `90`.
-     */
-    longitude: number;
-    /**
-     * Longitude between `-180` and `180`.
-     */
-    latitude: number;
-    /**
-     * Optional non-negative accuracy value.
-     */
-    accuracy?: number;
-}
-/**
- * @public
- */
-export interface MediaFeature {
-    name: string;
-    value: string;
-}
-/**
- * @public
- */
-export interface ScreenshotClip {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-}
-/**
- * @public
- */
-export interface ScreenshotOptions {
-    /**
-     * @defaultValue `png`
-     */
-    type?: 'png' | 'jpeg' | 'webp';
-    /**
-     * The file path to save the image to. The screenshot type will be inferred
-     * from file extension. If path is a relative path, then it is resolved
-     * relative to current working directory. If no path is provided, the image
-     * won't be saved to the disk.
-     */
-    path?: string;
-    /**
-     * When `true`, takes a screenshot of the full page.
-     * @defaultValue `false`
-     */
-    fullPage?: boolean;
-    /**
-     * An object which specifies the clipping region of the page.
-     */
-    clip?: ScreenshotClip;
-    /**
-     * Quality of the image, between 0-100. Not applicable to `png` images.
-     */
-    quality?: number;
-    /**
-     * Hides default white background and allows capturing screenshots with transparency.
-     * @defaultValue `false`
-     */
-    omitBackground?: boolean;
-    /**
-     * Encoding of the image.
-     * @defaultValue `binary`
-     */
-    encoding?: 'base64' | 'binary';
-    /**
-     * Capture the screenshot beyond the viewport.
-     * @defaultValue `true`
-     */
-    captureBeyondViewport?: boolean;
-    /**
-     * Capture the screenshot from the surface, rather than the view.
-     * @defaultValue `true`
-     */
-    fromSurface?: boolean;
-}
-/**
- * All the events that a page instance may emit.
- *
- * @public
- */
-export declare const enum PageEmittedEvents {
-    /**
-     * Emitted when the page closes.
-     * @eventProperty
-     */
-    Close = "close",
-    /**
-     * Emitted when JavaScript within the page calls one of console API methods,
-     * e.g. `console.log` or `console.dir`. Also emitted if the page throws an
-     * error or a warning.
-     *
-     * @remarks
-     * A `console` event provides a {@link ConsoleMessage} representing the
-     * console message that was logged.
-     *
-     * @example
-     * An example of handling `console` event:
-     *
-     * ```ts
-     * page.on('console', msg => {
-     *   for (let i = 0; i < msg.args().length; ++i)
-     *     console.log(`${i}: ${msg.args()[i]}`);
-     * });
-     * page.evaluate(() => console.log('hello', 5, {foo: 'bar'}));
-     * ```
-     */
-    Console = "console",
-    /**
-     * Emitted when a JavaScript dialog appears, such as `alert`, `prompt`,
-     * `confirm` or `beforeunload`. Puppeteer can respond to the dialog via
-     * {@link Dialog.accept} or {@link Dialog.dismiss}.
-     */
-    Dialog = "dialog",
-    /**
-     * Emitted when the JavaScript
-     * {@link https://developer.mozilla.org/en-US/docs/Web/Events/DOMContentLoaded | DOMContentLoaded }
-     * event is dispatched.
-     */
-    DOMContentLoaded = "domcontentloaded",
-    /**
-     * Emitted when the page crashes. Will contain an `Error`.
-     */
-    Error = "error",
-    /** Emitted when a frame is attached. Will contain a {@link Frame}. */
-    FrameAttached = "frameattached",
-    /** Emitted when a frame is detached. Will contain a {@link Frame}. */
-    FrameDetached = "framedetached",
-    /**
-     * Emitted when a frame is navigated to a new URL. Will contain a
-     * {@link Frame}.
-     */
-    FrameNavigated = "framenavigated",
-    /**
-     * Emitted when the JavaScript
-     * {@link https://developer.mozilla.org/en-US/docs/Web/Events/load | load}
-     * event is dispatched.
-     */
-    Load = "load",
-    /**
-     * Emitted when the JavaScript code makes a call to `console.timeStamp`. For
-     * the list of metrics see {@link Page.metrics | page.metrics}.
-     *
-     * @remarks
-     * Contains an object with two properties:
-     *
-     * - `title`: the title passed to `console.timeStamp`
-     * - `metrics`: objec containing metrics as key/value pairs. The values will
-     *   be `number`s.
-     */
-    Metrics = "metrics",
-    /**
-     * Emitted when an uncaught exception happens within the page. Contains an
-     * `Error`.
-     */
-    PageError = "pageerror",
-    /**
-     * Emitted when the page opens a new tab or window.
-     *
-     * Contains a {@link Page} corresponding to the popup window.
-     *
-     * @example
-     *
-     * ```ts
-     * const [popup] = await Promise.all([
-     *   new Promise(resolve => page.once('popup', resolve)),
-     *   page.click('a[target=_blank]'),
-     * ]);
-     * ```
-     *
-     * ```ts
-     * const [popup] = await Promise.all([
-     *   new Promise(resolve => page.once('popup', resolve)),
-     *   page.evaluate(() => window.open('https://example.com')),
-     * ]);
-     * ```
-     */
-    Popup = "popup",
-    /**
-     * Emitted when a page issues a request and contains a {@link HTTPRequest}.
-     *
-     * @remarks
-     * The object is readonly. See {@link Page.setRequestInterception} for
-     * intercepting and mutating requests.
-     */
-    Request = "request",
-    /**
-     * Emitted when a request ended up loading from cache. Contains a
-     * {@link HTTPRequest}.
-     *
-     * @remarks
-     * For certain requests, might contain undefined.
-     * {@link https://crbug.com/750469}
-     */
-    RequestServedFromCache = "requestservedfromcache",
-    /**
-     * Emitted when a request fails, for example by timing out.
-     *
-     * Contains a {@link HTTPRequest}.
-     *
-     * @remarks
-     * HTTP Error responses, such as 404 or 503, are still successful responses
-     * from HTTP standpoint, so request will complete with `requestfinished` event
-     * and not with `requestfailed`.
-     */
-    RequestFailed = "requestfailed",
-    /**
-     * Emitted when a request finishes successfully. Contains a
-     * {@link HTTPRequest}.
-     */
-    RequestFinished = "requestfinished",
-    /**
-     * Emitted when a response is received. Contains a {@link HTTPResponse}.
-     */
-    Response = "response",
-    /**
-     * Emitted when a dedicated
-     * {@link https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API | WebWorker}
-     * is spawned by the page.
-     */
-    WorkerCreated = "workercreated",
-    /**
-     * Emitted when a dedicated
-     * {@link https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API | WebWorker}
-     * is destroyed by the page.
-     */
-    WorkerDestroyed = "workerdestroyed"
-}
-/**
- * Denotes the objects received by callback functions for page events.
- *
- * See {@link PageEmittedEvents} for more detail on the events and when they are
- * emitted.
- *
- * @public
- */
-export interface PageEventObject {
-    close: never;
-    console: ConsoleMessage;
-    dialog: Dialog;
-    domcontentloaded: never;
-    error: Error;
-    frameattached: Frame;
-    framedetached: Frame;
-    framenavigated: Frame;
-    load: never;
-    metrics: {
-        title: string;
-        metrics: Metrics;
-    };
-    pageerror: Error;
-    popup: Page;
-    request: HTTPRequest;
-    response: HTTPResponse;
-    requestfailed: HTTPRequest;
-    requestfinished: HTTPRequest;
-    requestservedfromcache: HTTPRequest;
-    workercreated: WebWorker;
-    workerdestroyed: WebWorker;
-}
-/**
- * Page provides methods to interact with a single tab or
- * {@link https://developer.chrome.com/extensions/background_pages | extension background page}
- * in Chromium.
- *
- * :::note
- *
- * One Browser instance might have multiple Page instances.
- *
- * :::
- *
- * @example
- * This example creates a page, navigates it to a URL, and then saves a screenshot:
- *
- * ```ts
- * const puppeteer = require('puppeteer');
- *
- * (async () => {
- *   const browser = await puppeteer.launch();
- *   const page = await browser.newPage();
- *   await page.goto('https://example.com');
- *   await page.screenshot({path: 'screenshot.png'});
- *   await browser.close();
- * })();
- * ```
- *
- * The Page class extends from Puppeteer's {@link EventEmitter} class and will
- * emit various events which are documented in the {@link PageEmittedEvents} enum.
- *
- * @example
- * This example logs a message for a single page `load` event:
- *
- * ```ts
- * page.once('load', () => console.log('Page loaded!'));
- * ```
- *
- * To unsubscribe from events use the {@link Page.off} method:
- *
- * ```ts
- * function logRequest(interceptedRequest) {
- *   console.log('A request was made:', interceptedRequest.url());
- * }
- * page.on('request', logRequest);
- * // Sometime later...
- * page.off('request', logRequest);
- * ```
- *
- * @public
- */
-export declare class Page extends EventEmitter {
+export declare class CDPPage extends Page {
     #private;
     /**
      * @internal
      */
-    static _create(client: CDPSession, target: Target, ignoreHTTPSErrors: boolean, defaultViewport: Viewport | null, screenshotTaskQueue: TaskQueue): Promise<Page>;
+    static _create(client: CDPSession, target: Target, ignoreHTTPSErrors: boolean, defaultViewport: Viewport | null, screenshotTaskQueue: TaskQueue): Promise<CDPPage>;
     /**
      * @internal
      */
@@ -422,20 +60,6 @@ export declare class Page extends EventEmitter {
      * @returns `true` if the page has JavaScript enabled, `false` otherwise.
      */
     isJavaScriptEnabled(): boolean;
-    /**
-     * Listen to page events.
-     *
-     * :::note
-     *
-     * This method exists to define event typings and handle proper wireup of
-     * cooperative request interception. Actual event listening and dispatching is
-     * delegated to {@link EventEmitter}.
-     *
-     * :::
-     */
-    on<K extends keyof PageEventObject>(eventName: K, handler: (event: PageEventObject[K]) => void): EventEmitter;
-    once<K extends keyof PageEventObject>(eventName: K, handler: (event: PageEventObject[K]) => void): EventEmitter;
-    off<K extends keyof PageEventObject>(eventName: K, handler: (event: PageEventObject[K]) => void): EventEmitter;
     /**
      * This method is typically coupled with an action that triggers file
      * choosing.
@@ -568,37 +192,7 @@ export declare class Page extends EventEmitter {
      * on the page, which can then be used to simulate drag-and-drop.
      */
     setDragInterception(enabled: boolean): Promise<void>;
-    /**
-     * @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.
-     * @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();
-     * })();
-     * ```
-     *
-     * @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).
-     */
     emulateNetworkConditions(networkConditions: NetworkConditions | null): Promise<void>;
     /**
      * This setting will change the default maximum navigation time for the
@@ -622,6 +216,10 @@ export declare class Page extends EventEmitter {
      * @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`.
@@ -701,11 +299,6 @@ export declare class Page extends EventEmitter {
      * 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
@@ -890,27 +483,23 @@ export declare class Page extends EventEmitter {
      * 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>>;
     /**
      * The method adds a function called `name` on the page's `window` object.
      * When called, the function executes `puppeteerFunction` in node.js and
@@ -1347,38 +936,6 @@ export declare class Page extends EventEmitter {
      * Brings page to front (activates tab).
      */
     bringToFront(): Promise<void>;
-    /**
-     * Emulates given device metrics and user agent.
-     *
-     * @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.
-     * @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();
-     * })();
-     * ```
-     *
-     * @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>;
     /**
      * @param enabled - Whether or not to enable JavaScript on the page.
      * @returns
@@ -1678,13 +1235,13 @@ export declare class Page extends EventEmitter {
      *
      * // 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);
      * ```
@@ -1908,7 +1465,7 @@ export declare class Page extends EventEmitter {
         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.
      *
@@ -1978,7 +1535,7 @@ export declare class Page extends EventEmitter {
      *   (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
@@ -2089,26 +1646,8 @@ export declare class Page extends EventEmitter {
      * ```
      *
      * @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>>>>;
 }
 //# sourceMappingURL=Page.d.ts.map