@types/k6 0.44.2 → 0.44.3

k6/experimental/browser/page.d.ts

@@ -6,1345 +6,1383 @@ import {
     KeyboardModifier,
     MouseButton,
     ScreenshotOptions,
-    NavigationOptions } from "./";
-import { Touchscreen } from "./touchscreen";
-import { Response } from "./response";
-import { Locator } from "./locator";
-import { JSHandle } from "./js_handle";
-import { Keyboard } from "./keyboard";
-import { Mouse } from "./mouse";
-import { ElementHandle } from "./element_handle";
-import { Frame } from "./frame";
-import { Worker } from "./worker";
+    NavigationOptions,
+} from './';
+import { Touchscreen } from './touchscreen';
+import { Response } from './response';
+import { Locator } from './locator';
+import { JSHandle } from './js_handle';
+import { Keyboard } from './keyboard';
+import { Mouse } from './mouse';
+import { ElementHandle } from './element_handle';
+import { Frame } from './frame';
+import { Worker } from './worker';
 
 /**
  * Page provides methods to interact with a single tab in a running web browser
  * instance. One instance of the browser can have many page instances.
  */
 export class Page {
-  /**
-   * Activates the browser tab so that it comes into focus and actions can be
-   * performed against it.
-   */
-  bringToFront(): void;
-
-  /**
-   * **NOTE** Use locator-based `locator.check([options])` instead.
-   *
-   * This method is used to select an input checkbox.
-   * @param selector A selector to search for an element. If there are multiple
-   * elements satisfying the selector, the first will be used.
-   * @param options
-   */
-  check(selector: string, options?: {
     /**
-     * Setting this to `true` will bypass the actionability checks (visible,
-     * stable, enabled). Defaults to `false`.
+     * Activates the browser tab so that it comes into focus and actions can be
+     * performed against it.
      */
-    force?: boolean;
+    bringToFront(): void;
 
     /**
-     * If set to `true` and a navigation occurs from performing this action, it
-     * will not wait for it to complete. Defaults to `false`.
-     */
-    noWaitAfter?: boolean;
-
-    /**
-     * A point to use relative to the top left corner of the element. If not
-     * supplied, a visible point of the element is used.
-     */
-    position?: {
-      x: number;
-
-      y: number;
-    };
-
-    /**
-     * When `true`, the call requires selector to resolve to a single element.
-     * If given selector resolves to more than one element, the call throws
-     * an exception. Defaults to `false`.
-     */
-    strict?: boolean;
-
-    /**
-     * Maximum time in milliseconds. Defaults to `30` seconds. Default is
-     * overridden by the `setDefaultTimeout` option on `BrowserContext` or
-     * `page` methods.
+     * **NOTE** Use locator-based `locator.check([options])` instead.
      *
-     * Setting the value to `0` will disable the timeout.
-     */
-    timeout?: number;
-
-    /**
-     * Setting this to `true` will perform the actionability checks without
-     * performing the action. Useful to wait until the element is ready for the
-     * action without performing it. Defaults to `false`.
-     */
-    trial?: boolean;
-  }): void;
-
-  /**
-   * **NOTE** Use locator-based `locator.click([options])` instead.
-   *
-   * This method clicks an element matching `selector`.
-   * @param selector A selector to search for an element. If there are multiple
-   * elements satisfying the selector, the first will be used.
-   * @param options
-   */
-  click(selector: string, options?: {
-    /**
-     * The mouse button (`left`, `middle` or `right`) to use during the action.
-     * Defaults to `left`.
-     */
-    button?: MouseButton;
-
-    /**
-     * The number of times the action is performed. Defaults to `1`.
-     */
-    clickCount?: number;
-
-    /**
-     * Milliseconds to wait between `mousedown` and `mouseup`. Defaults to `0`.
-     */
-    delay?: number;
-
-    /**
-     * Setting this to `true` will bypass the actionability checks (`visible`,
-     * `stable`, `enabled`). Defaults to `false`.
-     */
-    force?: boolean;
-
-    /**
-     * `Alt`, `Control`, `Meta` or `Shift` modifiers keys pressed during the
-     * action. If not specified, currently pressed modifiers are used,
-     * otherwise defaults to `null`.
-     */
-    modifiers?: KeyboardModifier[];
-
-    /**
-     * If set to `true` and a navigation occurs from performing this action, it
-     * will not wait for it to complete. Defaults to `false`.
-     */
-    noWaitAfter?: boolean;
-
-    /**
-     * A point to use relative to the top left corner of the element. If not
-     * supplied, a visible point of the element is used.
-     */
-    position?: {
-      x: number;
-
-      y: number;
-    };
-
-    /**
-     * When `true`, the call requires selector to resolve to a single element.
-     * If given selector resolves to more than one element, the call throws
-     * an exception. Defaults to `false`.
-     */
-    strict?: boolean;
-
-    /**
-     * Maximum time in milliseconds. Defaults to `30` seconds. Default is
-     * overridden by the `setDefaultTimeout` option on `BrowserContext` or
-     * `page` methods.
+     * This method is used to select an input checkbox.
+     * @param selector A selector to search for an element. If there are multiple
+     * elements satisfying the selector, the first will be used.
+     * @param options
+     */
+    check(
+        selector: string,
+        options?: {
+            /**
+             * Setting this to `true` will bypass the actionability checks (visible,
+             * stable, enabled). Defaults to `false`.
+             */
+            force?: boolean;
+
+            /**
+             * If set to `true` and a navigation occurs from performing this action, it
+             * will not wait for it to complete. Defaults to `false`.
+             */
+            noWaitAfter?: boolean;
+
+            /**
+             * A point to use relative to the top left corner of the element. If not
+             * supplied, a visible point of the element is used.
+             */
+            position?: {
+                x: number;
+
+                y: number;
+            };
+
+            /**
+             * When `true`, the call requires selector to resolve to a single element.
+             * If given selector resolves to more than one element, the call throws
+             * an exception. Defaults to `false`.
+             */
+            strict?: boolean;
+
+            /**
+             * Maximum time in milliseconds. Defaults to `30` seconds. Default is
+             * overridden by the `setDefaultTimeout` option on `BrowserContext` or
+             * `page` methods.
+             *
+             * Setting the value to `0` will disable the timeout.
+             */
+            timeout?: number;
+
+            /**
+             * Setting this to `true` will perform the actionability checks without
+             * performing the action. Useful to wait until the element is ready for the
+             * action without performing it. Defaults to `false`.
+             */
+            trial?: boolean;
+        },
+    ): void;
+
+    /**
+     * **NOTE** Use locator-based `locator.click([options])` instead.
      *
-     * Setting the value to `0` will disable the timeout.
-     */
-    timeout?: number;
-
-    /**
-     * Setting this to `true` will perform the actionability checks without
-     * performing the action. Useful to wait until the element is ready for the
-     * action without performing it. Defaults to `false`.
-     */
-    trial?: boolean;
-  }): Promise<void>;
-
-  /**
-   * This will close the tab that this page is associated with.
-   */
-  close(): void;
-
-  /**
-   * Gets the HTML contents of the page.
-   */
-  content(): string;
-
-  /**
-   * Gets the `BrowserContext` that the page belongs to.
-   */
-  context(): BrowserContext;
-
-  /**
-   * **NOTE** Use locator-based `locator.dblclick([options])` instead.
-   *
-   * Mouse double clicks an element matching provided selector.
-   * @param selector A selector to search for an element. If there are multiple
-   * elements satisfying the selector, the first will be used.
-   * @param options
-   */
-  dblclick(selector: string, options?: {
-    /**
-     * The mouse button (`left`, `middle` or `right`) to use during the action.
-     * Defaults to `left`.
-     */
-    button?: MouseButton;
-
-    /**
-     * Milliseconds to wait between `mousedown` and `mouseup`. Defaults to `0`.
-     */
-    delay?: number;
-
-    /**
-     * Setting this to `true` will bypass the actionability checks (`visible`,
-     * `stable`, `enabled`). Defaults to `false`.
-     */
-    force?: boolean;
-
-    /**
-     * `Alt`, `Control`, `Meta` or `Shift` modifiers keys pressed during the
-     * action. If not specified, currently pressed modifiers are used,
-     * otherwise defaults to `null`.
-     */
-    modifiers?: KeyboardModifier[];
-
-    /**
-     * If set to `true` and a navigation occurs from performing this action, it
-     * will not wait for it to complete. Defaults to `false`.
-     */
-    noWaitAfter?: boolean;
-
-    /**
-     * A point to use relative to the top left corner of the element. If not
-     * supplied, a visible point of the element is used.
-     */
-    position?: {
-      x: number;
-
-      y: number;
-    };
-
-    /**
-     * When `true`, the call requires selector to resolve to a single element.
-     * If given selector resolves to more than one element, the call throws
-     * an exception. Defaults to `false`.
-     */
-    strict?: boolean;
-
-    /**
-     * Maximum time in milliseconds. Defaults to `30` seconds. Default is
-     * overridden by the `setDefaultTimeout` option on `BrowserContext` or
-     * `page` methods.
+     * This method clicks an element matching `selector`.
+     * @param selector A selector to search for an element. If there are multiple
+     * elements satisfying the selector, the first will be used.
+     * @param options
+     */
+    click(
+        selector: string,
+        options?: {
+            /**
+             * The mouse button (`left`, `middle` or `right`) to use during the action.
+             * Defaults to `left`.
+             */
+            button?: MouseButton;
+
+            /**
+             * The number of times the action is performed. Defaults to `1`.
+             */
+            clickCount?: number;
+
+            /**
+             * Milliseconds to wait between `mousedown` and `mouseup`. Defaults to `0`.
+             */
+            delay?: number;
+
+            /**
+             * Setting this to `true` will bypass the actionability checks (`visible`,
+             * `stable`, `enabled`). Defaults to `false`.
+             */
+            force?: boolean;
+
+            /**
+             * `Alt`, `Control`, `Meta` or `Shift` modifiers keys pressed during the
+             * action. If not specified, currently pressed modifiers are used,
+             * otherwise defaults to `null`.
+             */
+            modifiers?: KeyboardModifier[];
+
+            /**
+             * If set to `true` and a navigation occurs from performing this action, it
+             * will not wait for it to complete. Defaults to `false`.
+             */
+            noWaitAfter?: boolean;
+
+            /**
+             * A point to use relative to the top left corner of the element. If not
+             * supplied, a visible point of the element is used.
+             */
+            position?: {
+                x: number;
+
+                y: number;
+            };
+
+            /**
+             * When `true`, the call requires selector to resolve to a single element.
+             * If given selector resolves to more than one element, the call throws
+             * an exception. Defaults to `false`.
+             */
+            strict?: boolean;
+
+            /**
+             * Maximum time in milliseconds. Defaults to `30` seconds. Default is
+             * overridden by the `setDefaultTimeout` option on `BrowserContext` or
+             * `page` methods.
+             *
+             * Setting the value to `0` will disable the timeout.
+             */
+            timeout?: number;
+
+            /**
+             * Setting this to `true` will perform the actionability checks without
+             * performing the action. Useful to wait until the element is ready for the
+             * action without performing it. Defaults to `false`.
+             */
+            trial?: boolean;
+        },
+    ): Promise<void>;
+
+    /**
+     * This will close the tab that this page is associated with.
+     */
+    close(): void;
+
+    /**
+     * Gets the HTML contents of the page.
+     */
+    content(): string;
+
+    /**
+     * Gets the `BrowserContext` that the page belongs to.
+     */
+    context(): BrowserContext;
+
+    /**
+     * **NOTE** Use locator-based `locator.dblclick([options])` instead.
      *
-     * Setting the value to `0` will disable the timeout.
-     */
-    timeout?: number;
-
-    /**
-     * Setting this to `true` will perform the actionability checks without
-     * performing the action. Useful to wait until the element is ready for the
-     * action without performing it. Defaults to `false`.
-     */
-    trial?: boolean;
-  }): void;
-
-  /**
-   * **NOTE** Use locator-based locator.dispatchEvent([options]) instead.
-   *
-   * @param selector A selector to search for an element. If there are multiple
-   * elements satisfying the selector, the first will be used.
-   * @param type DOM event type: `"click"` etc.
-   * @param eventInit Optional event-specific initialization properties.
-   * @param options
-   */
-  dispatchEvent(selector: string, type: string, eventInit?: EvaluationArgument, options?: {
-    /**
-     * When `true`, the call requires selector to resolve to a single element.
-     * If given selector resolves to more than one element, the call throws
-     * an exception. Defaults to `false`.
-     */
-    strict?: boolean;
-
-    /**
-     * Maximum time in milliseconds. Defaults to `30` seconds. Default is
-     * overridden by the `setDefaultTimeout` option on `BrowserContext` or
-     * `page` methods.
+     * Mouse double clicks an element matching provided selector.
+     * @param selector A selector to search for an element. If there are multiple
+     * elements satisfying the selector, the first will be used.
+     * @param options
+     */
+    dblclick(
+        selector: string,
+        options?: {
+            /**
+             * The mouse button (`left`, `middle` or `right`) to use during the action.
+             * Defaults to `left`.
+             */
+            button?: MouseButton;
+
+            /**
+             * Milliseconds to wait between `mousedown` and `mouseup`. Defaults to `0`.
+             */
+            delay?: number;
+
+            /**
+             * Setting this to `true` will bypass the actionability checks (`visible`,
+             * `stable`, `enabled`). Defaults to `false`.
+             */
+            force?: boolean;
+
+            /**
+             * `Alt`, `Control`, `Meta` or `Shift` modifiers keys pressed during the
+             * action. If not specified, currently pressed modifiers are used,
+             * otherwise defaults to `null`.
+             */
+            modifiers?: KeyboardModifier[];
+
+            /**
+             * If set to `true` and a navigation occurs from performing this action, it
+             * will not wait for it to complete. Defaults to `false`.
+             */
+            noWaitAfter?: boolean;
+
+            /**
+             * A point to use relative to the top left corner of the element. If not
+             * supplied, a visible point of the element is used.
+             */
+            position?: {
+                x: number;
+
+                y: number;
+            };
+
+            /**
+             * When `true`, the call requires selector to resolve to a single element.
+             * If given selector resolves to more than one element, the call throws
+             * an exception. Defaults to `false`.
+             */
+            strict?: boolean;
+
+            /**
+             * Maximum time in milliseconds. Defaults to `30` seconds. Default is
+             * overridden by the `setDefaultTimeout` option on `BrowserContext` or
+             * `page` methods.
+             *
+             * Setting the value to `0` will disable the timeout.
+             */
+            timeout?: number;
+
+            /**
+             * Setting this to `true` will perform the actionability checks without
+             * performing the action. Useful to wait until the element is ready for the
+             * action without performing it. Defaults to `false`.
+             */
+            trial?: boolean;
+        },
+    ): void;
+
+    /**
+     * **NOTE** Use locator-based locator.dispatchEvent([options]) instead.
      *
-     * Setting the value to `0` will disable the timeout.
-     */
-    timeout?: number;
-  }): void;
-
-  /**
-   * This method changes the `CSS media type` through the `media` argument,
-   * and/or the `'prefers-colors-scheme'` media feature, using the `colorScheme`
-   * argument.
-   * @param options
-   */
-  emulateMedia(options?: {
-    /**
-     * Emulates `'prefers-colors-scheme'` media feature, supported values are
-     * `'light'`, `'dark'`, and `'no-preference'`.
-     */
-    colorScheme?: "light"|"dark"|"no-preference";
-
-    /**
-     * Changes the CSS media type of the page. The only allowed values are
-     * `'screen'`, and `'print'`.
-     */
-    media?: "screen"|"print";
-
-    /**
-     * Emulates `'prefers-reduced-motion'` media feature, supported values are
-     * `'reduce'`, `'no-preference'`.
-     */
-    reducedMotion?: "reduce"|"no-preference";
-  }): void;
-
-  /**
-   * This emulates your website with the specified vision deficiency type.
-   * The supported types are:
-   * - none: default.
-   * - blurredVision: where vision is less precise.
-   * - protanopia: the inability to perceive any red light.
-   * - deuteranopia: the inability to perceive any green light.
-   * - tritanopia: the inability to perceive any blue light.
-   * - achromatopsia: the inability to perceive any color except for shades of
-   * grey (extremely rare).
-   * @param type
-   */
-  emulateVisionDeficiency(
-    type: "none"|"blurredVision"|"deuteranopia"|"protanopia"|"tritanopia"|"achromatopsia"
-  ): void;
-
-  /**
-   * Returns the value of the `pageFunction` invocation.
-   *
-   * A string can also be passed in instead of a function.
-   *
-   * @param pageFunction Function to be evaluated in the page context.
-   * @param arg Optional argument to pass to `pageFunction`.
-   */
-  evaluate<R, Arg>(pageFunction: PageFunction<Arg, R>, arg?: Arg): R;
-
-  /**
-   * Returns the value of the `pageFunction` invocation as a [JSHandle].
-   *
-   * The only difference between page.evaluate(pageFunction[, arg]) and
-   * page.evaluateHandle(pageFunction[, arg]) is that
-   * page.evaluateHandle(pageFunction[, arg])returns [JSHandle].
-   *
-   * @param pageFunction Function to be evaluated in the page context.
-   * @param arg Optional argument to pass to `pageFunction`.
-   */
-  evaluateHandle<R, Arg>(pageFunction: PageFunction<Arg, R>, arg?: Arg): JSHandle<R>;
-
-  /**
-   * **NOTE** Use locator-based `locator.fill(value[, options])` instead.
-   *
-   * Fill an `input`, `textarea` or `[contenteditable]` element with the
-   * provided value.
-   *
-   * @param selector A selector to search for an element. If there are multiple
-   * elements satisfying the selector, the first will be used.
-   * @param value Value to fill for the `<input>`, `<textarea>` or
-   * `[contenteditable]` element.
-   * @param options
-   */
-  fill(selector: string, value: string, options?: {
-    /**
-     * Setting this to `true` will bypass the actionability checks (`visible`,
-     * `stable`, `enabled`). Defaults to `false`.
-     */
-    force?: boolean;
-
-    /**
-     * If set to `true` and a navigation occurs from performing this action, it
-     * will not wait for it to complete. Defaults to `false`.
-     */
-    noWaitAfter?: boolean;
-
-    /**
-     * When `true`, the call requires selector to resolve to a single element.
-     * If given selector resolves to more than one element, the call throws
-     * an exception. Defaults to `false`.
-     */
-    strict?: boolean;
-
-    /**
-     * Maximum time in milliseconds. Defaults to `30` seconds. Default is
-     * overridden by the `setDefaultTimeout` option on `BrowserContext` or
-     * `page` methods.
+     * @param selector A selector to search for an element. If there are multiple
+     * elements satisfying the selector, the first will be used.
+     * @param type DOM event type: `"click"` etc.
+     * @param eventInit Optional event-specific initialization properties.
+     * @param options
+     */
+    dispatchEvent(
+        selector: string,
+        type: string,
+        eventInit?: EvaluationArgument,
+        options?: {
+            /**
+             * When `true`, the call requires selector to resolve to a single element.
+             * If given selector resolves to more than one element, the call throws
+             * an exception. Defaults to `false`.
+             */
+            strict?: boolean;
+
+            /**
+             * Maximum time in milliseconds. Defaults to `30` seconds. Default is
+             * overridden by the `setDefaultTimeout` option on `BrowserContext` or
+             * `page` methods.
+             *
+             * Setting the value to `0` will disable the timeout.
+             */
+            timeout?: number;
+        },
+    ): void;
+
+    /**
+     * This method changes the `CSS media type` through the `media` argument,
+     * and/or the `'prefers-colors-scheme'` media feature, using the `colorScheme`
+     * argument.
+     * @param options
+     */
+    emulateMedia(options?: {
+        /**
+         * Emulates `'prefers-colors-scheme'` media feature, supported values are
+         * `'light'`, `'dark'`, and `'no-preference'`.
+         */
+        colorScheme?: 'light' | 'dark' | 'no-preference';
+
+        /**
+         * Changes the CSS media type of the page. The only allowed values are
+         * `'screen'`, and `'print'`.
+         */
+        media?: 'screen' | 'print';
+
+        /**
+         * Emulates `'prefers-reduced-motion'` media feature, supported values are
+         * `'reduce'`, `'no-preference'`.
+         */
+        reducedMotion?: 'reduce' | 'no-preference';
+    }): void;
+
+    /**
+     * This emulates your website with the specified vision deficiency type.
+     * The supported types are:
+     * - none: default.
+     * - blurredVision: where vision is less precise.
+     * - protanopia: the inability to perceive any red light.
+     * - deuteranopia: the inability to perceive any green light.
+     * - tritanopia: the inability to perceive any blue light.
+     * - achromatopsia: the inability to perceive any color except for shades of
+     * grey (extremely rare).
+     * @param type
+     */
+    emulateVisionDeficiency(
+        type: 'none' | 'blurredVision' | 'deuteranopia' | 'protanopia' | 'tritanopia' | 'achromatopsia',
+    ): void;
+
+    /**
+     * Returns the value of the `pageFunction` invocation.
      *
-     * Setting the value to `0` will disable the timeout.
-     */
-    timeout?: number;
-  }): void;
-
-  /**
-   * **NOTE** Use locator-based `locator.focus([options])` instead.
-   *
-   * This method fetches an element with `selector` and focuses it.
-   *
-   * @param selector A selector to search for an element. If there are multiple
-   * elements satisfying the selector, the first will be used.
-   * @param options
-   */
-  focus(selector: string, options?: {
-    /**
-     * When `true`, the call requires selector to resolve to a single element.
-     * If given selector resolves to more than one element, the call throws
-     * an exception. Defaults to `false`.
-     */
-    strict?: boolean;
-
-    /**
-     * Maximum time in milliseconds. Defaults to `30` seconds. Default is
-     * overridden by the `setDefaultTimeout` option on `BrowserContext` or
-     * `page` methods.
+     * A string can also be passed in instead of a function.
      *
-     * Setting the value to `0` will disable the timeout.
+     * @param pageFunction Function to be evaluated in the page context.
+     * @param arg Optional argument to pass to `pageFunction`.
      */
-    timeout?: number;
-  }): void;
-
-  /**
-   * Frames returns an array of frames on the page.
-   */
-  frames(): Frame[];
-
-  /**
-   * **NOTE** Use locator-based locator.getAttribute(name[, options]) instead.
-   *
-   * Returns the element attribute value for the given attribute name.
-   *
-   * @param selector A selector to search for an element. If there are multiple
-   * elements satisfying the selector, the first will be used.
-   * @param name Attribute name to get the value for.
-   * @param options
-   */
-  getAttribute(selector: string, name: string, options?: {
-    /**
-     * When `true`, the call requires selector to resolve to a single element.
-     * If given selector resolves to more than one element, the call throws
-     * an exception. Defaults to `false`.
-     */
-    strict?: boolean;
+    evaluate<R, Arg>(pageFunction: PageFunction<Arg, R>, arg?: Arg): R;
 
     /**
-     * Maximum time in milliseconds. Defaults to `30` seconds. Default is
-     * overridden by the `setDefaultTimeout` option on `BrowserContext` or
-     * `page` methods.
+     * Returns the value of the `pageFunction` invocation as a [JSHandle].
      *
-     * Setting the value to `0` will disable the timeout.
-     */
-    timeout?: number;
-  }): null|string;
-
-  /**
-   * Navigates to the specified url and returns the main resource response.
-   *
-   * navigating to `about:blank` or navigation to the same URL with a different
-   * hash, will succeed and return `null`.
-   *
-   * @param url URL to navigate page to. The url should include scheme, e.g.
-   * `https://`.
-   * @param options
-   */
-  goto(url: string, options?: NavigationOptions): Promise<null|Response>;
-
-  /**
-   * **NOTE** Use locator-based locator.hover([options]) instead.
-   *
-   * This method hovers over an element matching `selector`.
-   *
-   * @param selector A selector to search for an element. If there are multiple
-   * elements satisfying the selector, the first will be used.
-   * @param options
-   */
-  hover(selector: string, options?: {
-    /**
-     * Setting this to `true` will bypass the actionability checks (`visible`,
-     * `stable`, `enabled`). Defaults to `false`.
-     */
-    force?: boolean;
-
-    /**
-     * `Alt`, `Control`, `Meta` or `Shift` modifiers keys pressed during the
-     * action. If not specified, currently pressed modifiers are used,
-     * otherwise defaults to `null`.
-     */
-    modifiers?: KeyboardModifier[];
-
-    /**
-     * If set to `true` and a navigation occurs from performing this action, it
-     * will not wait for it to complete. Defaults to `false`.
-     */
-    noWaitAfter?: boolean;
-
-    /**
-     * A point to use relative to the top left corner of the element. If not
-     * supplied, a visible point of the element is used.
-     */
-    position?: {
-      x: number;
-
-      y: number;
-    };
-
-    /**
-     * When `true`, the call requires selector to resolve to a single element.
-     * If given selector resolves to more than one element, the call throws
-     * an exception. Defaults to `false`.
-     */
-    strict?: boolean;
-
-    /**
-     * Maximum time in milliseconds. Defaults to `30` seconds. Default is
-     * overridden by the `setDefaultTimeout` option on `BrowserContext` or
-     * `page` methods.
+     * The only difference between page.evaluate(pageFunction[, arg]) and
+     * page.evaluateHandle(pageFunction[, arg]) is that
+     * page.evaluateHandle(pageFunction[, arg])returns [JSHandle].
      *
-     * Setting the value to `0` will disable the timeout.
+     * @param pageFunction Function to be evaluated in the page context.
+     * @param arg Optional argument to pass to `pageFunction`.
      */
-    timeout?: number;
+    evaluateHandle<R, Arg>(pageFunction: PageFunction<Arg, R>, arg?: Arg): JSHandle<R>;
 
     /**
-     * Setting this to `true` will perform the actionability checks without
-     * performing the action. Useful to wait until the element is ready for the
-     * action without performing it. Defaults to `false`.
-     */
-    trial?: boolean;
-  }): void;
-
-  /**
-   * **NOTE** Use locator-based locator.innerHTML([options]) instead.
-   *
-   * Returns `element.innerHTML`.
-   *
-   * @param selector A selector to search for an element. If there are multiple
-   * elements satisfying the selector, the first will be used.
-   * @param options
-   */
-  innerHTML(selector: string, options?: {
-    /**
-     * When `true`, the call requires selector to resolve to a single element.
-     * If given selector resolves to more than one element, the call throws
-     * an exception. Defaults to `false`.
-     */
-    strict?: boolean;
-
-    /**
-     * Maximum time in milliseconds. Defaults to `30` seconds. Default is
-     * overridden by the `setDefaultTimeout` option on `BrowserContext` or
-     * `page` methods.
+     * **NOTE** Use locator-based `locator.fill(value[, options])` instead.
      *
-     * Setting the value to `0` will disable the timeout.
-     */
-    timeout?: number;
-  }): string;
-
-  /**
-   * **NOTE** Use locator-based locator.innerText([options]) instead.
-   *
-   * Returns `element.innerText`.
-   *
-   * @param selector A selector to search for an element. If there are multiple
-   * elements satisfying the selector, the first will be used.
-   * @param options
-   */
-  innerText(selector: string, options?: {
-    /**
-     * When `true`, the call requires selector to resolve to a single element.
-     * If given selector resolves to more than one element, the call throws
-     * an exception. Defaults to `false`.
-     */
-    strict?: boolean;
-
-    /**
-     * Maximum time in milliseconds. Defaults to `30` seconds. Default is
-     * overridden by the `setDefaultTimeout` option on `BrowserContext` or
-     * `page` methods.
+     * Fill an `input`, `textarea` or `[contenteditable]` element with the
+     * provided value.
      *
-     * Setting the value to `0` will disable the timeout.
-     */
-    timeout?: number;
-  }): string;
-
-  /**
-   * **NOTE** Use locator-based locator.inputValue([options]) instead.
-   *
-   * Returns `input.value` for the selected `<input>` or `<textarea>` or
-   * `<select>` element.
-   *
-   * @param selector A selector to search for an element. If there are multiple
-   * elements satisfying the selector, the first will be used.
-   * @param options
-   */
-  inputValue(selector: string, options?: {
-    /**
-     * When `true`, the call requires selector to resolve to a single element.
-     * If given selector resolves to more than one element, the call throws
-     * an exception. Defaults to `false`.
-     */
-    strict?: boolean;
-
-    /**
-     * Maximum time in milliseconds. Defaults to `30` seconds. Default is
-     * overridden by the `setDefaultTimeout` option on `BrowserContext` or
-     * `page` methods.
+     * @param selector A selector to search for an element. If there are multiple
+     * elements satisfying the selector, the first will be used.
+     * @param value Value to fill for the `<input>`, `<textarea>` or
+     * `[contenteditable]` element.
+     * @param options
+     */
+    fill(
+        selector: string,
+        value: string,
+        options?: {
+            /**
+             * Setting this to `true` will bypass the actionability checks (`visible`,
+             * `stable`, `enabled`). Defaults to `false`.
+             */
+            force?: boolean;
+
+            /**
+             * If set to `true` and a navigation occurs from performing this action, it
+             * will not wait for it to complete. Defaults to `false`.
+             */
+            noWaitAfter?: boolean;
+
+            /**
+             * When `true`, the call requires selector to resolve to a single element.
+             * If given selector resolves to more than one element, the call throws
+             * an exception. Defaults to `false`.
+             */
+            strict?: boolean;
+
+            /**
+             * Maximum time in milliseconds. Defaults to `30` seconds. Default is
+             * overridden by the `setDefaultTimeout` option on `BrowserContext` or
+             * `page` methods.
+             *
+             * Setting the value to `0` will disable the timeout.
+             */
+            timeout?: number;
+        },
+    ): void;
+
+    /**
+     * **NOTE** Use locator-based `locator.focus([options])` instead.
      *
-     * Setting the value to `0` will disable the timeout.
-     */
-    timeout?: number;
-  }): string;
-
-  /**
-   * **NOTE** Use locator-based locator.isChecked([options]) instead.
-   *
-   * Checks to see if the `checkbox` `input` type is selected or not.
-   *
-   * @param selector A selector to search for an element. If there are multiple
-   * elements satisfying the selector, the first will be used.
-   * @param options
-   */
-  isChecked(selector: string, options?: {
-    /**
-     * When `true`, the call requires selector to resolve to a single element.
-     * If given selector resolves to more than one element, the call throws
-     * an exception. Defaults to `false`.
-     */
-    strict?: boolean;
-
-    /**
-     * Maximum time in milliseconds. Defaults to `30` seconds. Default is
-     * overridden by the `setDefaultTimeout` option on `BrowserContext` or
-     * `page` methods.
+     * This method fetches an element with `selector` and focuses it.
      *
-     * Setting the value to `0` will disable the timeout.
-     */
-    timeout?: number;
-  }): boolean;
-
-  /**
-   * Indicates that the page has been closed.
-   */
-  isClosed(): boolean;
-
-  /**
-   * **NOTE** Use locator-based locator.isDisabled([options]) instead.
-   *
-   * Returns whether the element is disabled.
-   *
-   * @param selector A selector to search for an element. If there are multiple
-   * elements satisfying the selector, the first will be used.
-   * @param options
-   */
-  isDisabled(selector: string, options?: {
-    /**
-     * When `true`, the call requires selector to resolve to a single element.
-     * If given selector resolves to more than one element, the call throws
-     * an exception. Defaults to `false`.
-     */
-    strict?: boolean;
-
-    /**
-     * Maximum time in milliseconds. Defaults to `30` seconds. Default is
-     * overridden by the `setDefaultTimeout` option on `BrowserContext` or
-     * `page` methods.
+     * @param selector A selector to search for an element. If there are multiple
+     * elements satisfying the selector, the first will be used.
+     * @param options
+     */
+    focus(
+        selector: string,
+        options?: {
+            /**
+             * When `true`, the call requires selector to resolve to a single element.
+             * If given selector resolves to more than one element, the call throws
+             * an exception. Defaults to `false`.
+             */
+            strict?: boolean;
+
+            /**
+             * Maximum time in milliseconds. Defaults to `30` seconds. Default is
+             * overridden by the `setDefaultTimeout` option on `BrowserContext` or
+             * `page` methods.
+             *
+             * Setting the value to `0` will disable the timeout.
+             */
+            timeout?: number;
+        },
+    ): void;
+
+    /**
+     * Frames returns an array of frames on the page.
+     */
+    frames(): Frame[];
+
+    /**
+     * **NOTE** Use locator-based locator.getAttribute(name[, options]) instead.
      *
-     * Setting the value to `0` will disable the timeout.
-     */
-    timeout?: number;
-  }): boolean;
-
-  /**
-   * **NOTE** Use locator-based locator.isEditable([options]) instead.
-   *
-   * Returns whether the element is editable.
-   *
-   * @param selector A selector to search for an element. If there are multiple
-   * elements satisfying the selector, the first will be used.
-   * @param options
-   */
-  isEditable(selector: string, options?: {
-    /**
-     * When `true`, the call requires selector to resolve to a single element.
-     * If given selector resolves to more than one element, the call throws
-     * an exception. Defaults to `false`.
-     */
-    strict?: boolean;
-
-    /**
-     * Maximum time in milliseconds. Defaults to `30` seconds. Default is
-     * overridden by the `setDefaultTimeout` option on `BrowserContext` or
-     * `page` methods.
+     * Returns the element attribute value for the given attribute name.
      *
-     * Setting the value to `0` will disable the timeout.
-     */
-    timeout?: number;
-  }): boolean;
-
-  /**
-   * **NOTE** Use locator-based locator.isEnabled([options]) instead.
-   *
-   * Returns whether the element is enabled.
-   *
-   * @param selector A selector to search for an element. If there are multiple
-   * elements satisfying the selector, the first will be used.
-   * @param options
-   */
-  isEnabled(selector: string, options?: {
-    /**
-     * When `true`, the call requires selector to resolve to a single element.
-     * If given selector resolves to more than one element, the call throws
-     * an exception. Defaults to `false`.
-     */
-    strict?: boolean;
-
-    /**
-     * Maximum time in milliseconds. Defaults to `30` seconds. Default is
-     * overridden by the `setDefaultTimeout` option on `BrowserContext` or
-     * `page` methods.
+     * @param selector A selector to search for an element. If there are multiple
+     * elements satisfying the selector, the first will be used.
+     * @param name Attribute name to get the value for.
+     * @param options
+     */
+    getAttribute(
+        selector: string,
+        name: string,
+        options?: {
+            /**
+             * When `true`, the call requires selector to resolve to a single element.
+             * If given selector resolves to more than one element, the call throws
+             * an exception. Defaults to `false`.
+             */
+            strict?: boolean;
+
+            /**
+             * Maximum time in milliseconds. Defaults to `30` seconds. Default is
+             * overridden by the `setDefaultTimeout` option on `BrowserContext` or
+             * `page` methods.
+             *
+             * Setting the value to `0` will disable the timeout.
+             */
+            timeout?: number;
+        },
+    ): null | string;
+
+    /**
+     * Navigates to the specified url and returns the main resource response.
      *
-     * Setting the value to `0` will disable the timeout.
-     */
-    timeout?: number;
-  }): boolean;
-
-  /**
-   * **NOTE** Use locator-based locator.isHidden([options]) instead.
-   *
-   * Returns whether the element is hidden.
-   *
-   * @param selector A selector to search for an element. If there are multiple
-   * elements satisfying the selector, the first will be used.
-   * @param options
-   */
-  isHidden(selector: string, options?: {
-    /**
-     * When `true`, the call requires selector to resolve to a single element.
-     * If given selector resolves to more than one element, the call throws
-     * an exception. Defaults to `false`.
-     */
-    strict?: boolean;
-
-    /**
-     * Maximum time in milliseconds. Defaults to `30` seconds. Default is
-     * overridden by the `setDefaultTimeout` option on `BrowserContext` or
-     * `page` methods.
+     * navigating to `about:blank` or navigation to the same URL with a different
+     * hash, will succeed and return `null`.
      *
-     * Setting the value to `0` will disable the timeout.
+     * @param url URL to navigate page to. The url should include scheme, e.g.
+     * `https://`.
+     * @param options
      */
-    timeout?: number;
-  }): boolean;
-
-  /**
-   * **NOTE** Use locator-based locator.isVisible([options]) instead.
-   *
-   * Returns whether the element is visible.
-   *
-   * @param selector A selector to search for an element. If there are multiple
-   * elements satisfying the selector, the first will be used.
-   * @param options
-   */
-  isVisible(selector: string, options?: {
-    /**
-     * When `true`, the call requires selector to resolve to a single element.
-     * If given selector resolves to more than one element, the call throws
-     * an exception. Defaults to `false`.
-     */
-    strict?: boolean;
+    goto(url: string, options?: NavigationOptions): Promise<null | Response>;
 
     /**
-     * Maximum time in milliseconds. Defaults to `30` seconds. Default is
-     * overridden by the `setDefaultTimeout` option on `BrowserContext` or
-     * `page` methods.
+     * **NOTE** Use locator-based locator.hover([options]) instead.
      *
-     * Setting the value to `0` will disable the timeout.
-     */
-    timeout?: number;
-  }): boolean;
-
-  /**
-   * Returns the keyboard instance to interact with a virtual keyboard on the
-   * page.
-   */
-  keyboard: Keyboard;
-
-  /**
-   * The method returns an element locator. Locators resolve to the element
-   * when the action takes place, which means locators can span over navigations
-   * where the underlying dom changes.
-   *
-   * @param selector A selector to use when resolving DOM element.
-   */
-  locator(selector: string): Locator;
-
-  /**
-   * The page's main frame. Page is made up of frames in a hierarchical. At the
-   * top is mainFrame. A page is guaranteed to have a mainFrame.
-   */
-  mainFrame(): Frame;
-
-  /**
-   * Returns the mouse instance to interact with a virtual mouse on the page.
-   */
-  mouse: Mouse;
-
-  /**
-   * Returns the page that opened the current page. The first page that is
-   * navigated to will have a null opener.
-   */
-  opener(): Page | null;
-
-  /**
-   * **NOTE** Use locator-based locator.press(key[, options]) instead.
-   *
-   * Focuses the element, and then uses keyboard.down(key) and
-   * keyboard.up(key).
-   *
-   * A superset of the `key` values can be found [here](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key/Key_Values).
-   *
-   * Following modification shortcuts are also supported: `Shift`, `Control`,
-   * `Alt`, `Meta`, `ShiftLeft`.
-   *
-   * Holding down `Shift` will type the text that corresponds to the `key` in
-   * the upper case.
-   *
-   * If `key` is a single character, it is case-sensitive, so the values `a`
-   * and `A` will generate different respective texts.
-   *
-   * Shortcuts such as `key: "Control+o"` or `key: "Control+Shift+T"` are
-   * supported as well. When specified with the modifier, modifier is pressed
-   * and being held while the subsequent key is being pressed.
-   *
-   * @param selector A selector to search for an element. If there are multiple
-   * elements satisfying the selector, the first will be used.
-   * @param key Name of the key to press or a character to generate, such as
-   * `ArrowLeft` or `a`.
-   * @param options
-   */
-  press(selector: string, key: string, options?: {
-    /**
-     * Milliseconds to wait between `mousedown` and `mouseup`. Defaults to `0`.
-     */
-    delay?: number;
-
-    /**
-     * If set to `true` and a navigation occurs from performing this action, it
-     * will not wait for it to complete. Defaults to `false`.
-     */
-    noWaitAfter?: boolean;
-
-    /**
-     * When `true`, the call requires selector to resolve to a single element.
-     * If given selector resolves to more than one element, the call throws
-     * an exception. Defaults to `false`.
-     */
-    strict?: boolean;
-
-    /**
-     * Maximum time in milliseconds. Defaults to `30` seconds. Default is
-     * overridden by the `setDefaultTimeout` option on `BrowserContext` or
-     * `page` methods.
+     * This method hovers over an element matching `selector`.
      *
-     * Setting the value to `0` will disable the timeout.
-     */
-    timeout?: number;
-  }): void;
-
-  /**
-   * This reloads the current page Returns the main resource response.
-   *
-   * @param options
-   */
-  reload(options?: {
-    /**
-     * Maximum operation time in milliseconds. Defaults to `30` seconds. The
-     * default value can be changed via the
-     * browserContext.setDefaultNavigationTimeout(timeout),
-     * browserContext.setDefaultTimeout(timeout),
-     * page.setDefaultNavigationTimeout(timeout) or
-     * page.setDefaultTimeout(timeout) methods.
+     * @param selector A selector to search for an element. If there are multiple
+     * elements satisfying the selector, the first will be used.
+     * @param options
+     */
+    hover(
+        selector: string,
+        options?: {
+            /**
+             * Setting this to `true` will bypass the actionability checks (`visible`,
+             * `stable`, `enabled`). Defaults to `false`.
+             */
+            force?: boolean;
+
+            /**
+             * `Alt`, `Control`, `Meta` or `Shift` modifiers keys pressed during the
+             * action. If not specified, currently pressed modifiers are used,
+             * otherwise defaults to `null`.
+             */
+            modifiers?: KeyboardModifier[];
+
+            /**
+             * If set to `true` and a navigation occurs from performing this action, it
+             * will not wait for it to complete. Defaults to `false`.
+             */
+            noWaitAfter?: boolean;
+
+            /**
+             * A point to use relative to the top left corner of the element. If not
+             * supplied, a visible point of the element is used.
+             */
+            position?: {
+                x: number;
+
+                y: number;
+            };
+
+            /**
+             * When `true`, the call requires selector to resolve to a single element.
+             * If given selector resolves to more than one element, the call throws
+             * an exception. Defaults to `false`.
+             */
+            strict?: boolean;
+
+            /**
+             * Maximum time in milliseconds. Defaults to `30` seconds. Default is
+             * overridden by the `setDefaultTimeout` option on `BrowserContext` or
+             * `page` methods.
+             *
+             * Setting the value to `0` will disable the timeout.
+             */
+            timeout?: number;
+
+            /**
+             * Setting this to `true` will perform the actionability checks without
+             * performing the action. Useful to wait until the element is ready for the
+             * action without performing it. Defaults to `false`.
+             */
+            trial?: boolean;
+        },
+    ): void;
+
+    /**
+     * **NOTE** Use locator-based locator.innerHTML([options]) instead.
      *
-     * Setting the value to `0` will disable the timeout.
+     * Returns `element.innerHTML`.
      *
-     */
-    timeout?: number;
-
-    /**
-     * When to consider operation succeeded, defaults to `load`. Events can be
-     * either:
-     * - `'domcontentloaded'` - consider operation to be finished when the
-     * `DOMContentLoaded` event is fired.
-     * - `'load'` - consider operation to be finished when the `load` event is
-     * fired.
-     * - `'networkidle'` - **DISCOURAGED** consider operation to be finished
-     * when there are no network connections for at least `500` ms. Don't use
-     * this method for testing especially with chatty websites where the event
-     * may never fire, rely on web assertions to assess readiness instead.
-     */
-    waitUntil?: "load"|"domcontentloaded"|"networkidle";
-  }): null | Response;
-
-  /**
-   * Returns the buffer with the captured screenshot from the browser.
-   *
-   * @param options
-   */
-  screenshot(options?: {
-    /**
-     * An object which specifies clipping of the resulting image.
-     */
-    clip?: {
-      /**
-       * x-coordinate of top-left corner of clip area
-       */
-      x: number;
-
-      /**
-       * y-coordinate of top-left corner of clip area
-       */
-      y: number;
-
-      /**
-       * width of clipping area
-       */
-      width: number;
-
-      /**
-       * height of clipping area
-       */
-      height: number;
-    };
-
-    /**
-     * When true, takes a screenshot of the full scrollable page, instead of
-     * the currently visible viewport. Defaults to `false`.
-     */
-    fullPage?: boolean;
-   } & ScreenshotOptions): ArrayBuffer;
-
-  /**
-   * **NOTE** Use locator-based locator.selectOption(values[, options]) instead.
-   *
-   * This select one or more options which match the values from a <select>
-   * element.
-   *
-   * @param selector A selector to search for an element. If there are multiple
-   * elements satisfying the selector, the first will be used.
-   * @param values Options to select. If the select has multiple attribute, all
-   * matching options are selected, otherwise only the first option matching
-   * one of the passed options is selected. Object can be made up of keys with
-   * value, label or index.
-   * @param options
-   */
-  selectOption(selector: string, values: string|ElementHandle|SelectOptionsObject|string[]|ElementHandle[]|SelectOptionsObject[], options?: {
-    /**
-     * Setting this to `true` will bypass the actionability checks (visible,
-     * stable, enabled). Defaults to `false`.
-     */
-    force?: boolean;
-
-    /**
-     * If set to `true` and a navigation occurs from performing this action, it
-     * will not wait for it to complete. Defaults to `false`.
-     */
-    noWaitAfter?: boolean;
-
-    /**
-     * When `true`, the call requires selector to resolve to a single element.
-     * If given selector resolves to more than one element, the call throws
-     * an exception. Defaults to `false`.
-     */
-    strict?: boolean;
-
-    /**
-     * Maximum time in milliseconds. Defaults to `30` seconds. Default is
-     * overridden by the `setDefaultTimeout` option on `BrowserContext` or
-     * `page` methods.
+     * @param selector A selector to search for an element. If there are multiple
+     * elements satisfying the selector, the first will be used.
+     * @param options
+     */
+    innerHTML(
+        selector: string,
+        options?: {
+            /**
+             * When `true`, the call requires selector to resolve to a single element.
+             * If given selector resolves to more than one element, the call throws
+             * an exception. Defaults to `false`.
+             */
+            strict?: boolean;
+
+            /**
+             * Maximum time in milliseconds. Defaults to `30` seconds. Default is
+             * overridden by the `setDefaultTimeout` option on `BrowserContext` or
+             * `page` methods.
+             *
+             * Setting the value to `0` will disable the timeout.
+             */
+            timeout?: number;
+        },
+    ): string;
+
+    /**
+     * **NOTE** Use locator-based locator.innerText([options]) instead.
      *
-     * Setting the value to `0` will disable the timeout.
-     */
-    timeout?: number;
-  }): string[];
-
-  /**
-   * Set the supplied html string to the current page.
-   *
-   * @param html HTML markup to assign to the page.
-   * @param options
-   */
-  setContent(html: string, options?: {
-    /**
-     * Maximum operation time in milliseconds. Defaults to `30` seconds. The
-     * default value can be changed via the
-     * browserContext.setDefaultNavigationTimeout(timeout),
-     * browserContext.setDefaultTimeout(timeout),
-     * page.setDefaultNavigationTimeout(timeout) or
-     * page.setDefaultTimeout(timeout) methods.
+     * Returns `element.innerText`.
      *
-     * Setting the value to `0` will disable the timeout.
+     * @param selector A selector to search for an element. If there are multiple
+     * elements satisfying the selector, the first will be used.
+     * @param options
+     */
+    innerText(
+        selector: string,
+        options?: {
+            /**
+             * When `true`, the call requires selector to resolve to a single element.
+             * If given selector resolves to more than one element, the call throws
+             * an exception. Defaults to `false`.
+             */
+            strict?: boolean;
+
+            /**
+             * Maximum time in milliseconds. Defaults to `30` seconds. Default is
+             * overridden by the `setDefaultTimeout` option on `BrowserContext` or
+             * `page` methods.
+             *
+             * Setting the value to `0` will disable the timeout.
+             */
+            timeout?: number;
+        },
+    ): string;
+
+    /**
+     * **NOTE** Use locator-based locator.inputValue([options]) instead.
      *
+     * Returns `input.value` for the selected `<input>` or `<textarea>` or
+     * `<select>` element.
+     *
+     * @param selector A selector to search for an element. If there are multiple
+     * elements satisfying the selector, the first will be used.
+     * @param options
+     */
+    inputValue(
+        selector: string,
+        options?: {
+            /**
+             * When `true`, the call requires selector to resolve to a single element.
+             * If given selector resolves to more than one element, the call throws
+             * an exception. Defaults to `false`.
+             */
+            strict?: boolean;
+
+            /**
+             * Maximum time in milliseconds. Defaults to `30` seconds. Default is
+             * overridden by the `setDefaultTimeout` option on `BrowserContext` or
+             * `page` methods.
+             *
+             * Setting the value to `0` will disable the timeout.
+             */
+            timeout?: number;
+        },
+    ): string;
+
+    /**
+     * **NOTE** Use locator-based locator.isChecked([options]) instead.
+     *
+     * Checks to see if the `checkbox` `input` type is selected or not.
+     *
+     * @param selector A selector to search for an element. If there are multiple
+     * elements satisfying the selector, the first will be used.
+     * @param options
+     */
+    isChecked(
+        selector: string,
+        options?: {
+            /**
+             * When `true`, the call requires selector to resolve to a single element.
+             * If given selector resolves to more than one element, the call throws
+             * an exception. Defaults to `false`.
+             */
+            strict?: boolean;
+
+            /**
+             * Maximum time in milliseconds. Defaults to `30` seconds. Default is
+             * overridden by the `setDefaultTimeout` option on `BrowserContext` or
+             * `page` methods.
+             *
+             * Setting the value to `0` will disable the timeout.
+             */
+            timeout?: number;
+        },
+    ): boolean;
+
+    /**
+     * Indicates that the page has been closed.
+     */
+    isClosed(): boolean;
+
+    /**
+     * **NOTE** Use locator-based locator.isDisabled([options]) instead.
+     *
+     * Returns whether the element is disabled.
+     *
+     * @param selector A selector to search for an element. If there are multiple
+     * elements satisfying the selector, the first will be used.
+     * @param options
+     */
+    isDisabled(
+        selector: string,
+        options?: {
+            /**
+             * When `true`, the call requires selector to resolve to a single element.
+             * If given selector resolves to more than one element, the call throws
+             * an exception. Defaults to `false`.
+             */
+            strict?: boolean;
+
+            /**
+             * Maximum time in milliseconds. Defaults to `30` seconds. Default is
+             * overridden by the `setDefaultTimeout` option on `BrowserContext` or
+             * `page` methods.
+             *
+             * Setting the value to `0` will disable the timeout.
+             */
+            timeout?: number;
+        },
+    ): boolean;
+
+    /**
+     * **NOTE** Use locator-based locator.isEditable([options]) instead.
+     *
+     * Returns whether the element is editable.
+     *
+     * @param selector A selector to search for an element. If there are multiple
+     * elements satisfying the selector, the first will be used.
+     * @param options
+     */
+    isEditable(
+        selector: string,
+        options?: {
+            /**
+             * When `true`, the call requires selector to resolve to a single element.
+             * If given selector resolves to more than one element, the call throws
+             * an exception. Defaults to `false`.
+             */
+            strict?: boolean;
+
+            /**
+             * Maximum time in milliseconds. Defaults to `30` seconds. Default is
+             * overridden by the `setDefaultTimeout` option on `BrowserContext` or
+             * `page` methods.
+             *
+             * Setting the value to `0` will disable the timeout.
+             */
+            timeout?: number;
+        },
+    ): boolean;
+
+    /**
+     * **NOTE** Use locator-based locator.isEnabled([options]) instead.
+     *
+     * Returns whether the element is enabled.
+     *
+     * @param selector A selector to search for an element. If there are multiple
+     * elements satisfying the selector, the first will be used.
+     * @param options
+     */
+    isEnabled(
+        selector: string,
+        options?: {
+            /**
+             * When `true`, the call requires selector to resolve to a single element.
+             * If given selector resolves to more than one element, the call throws
+             * an exception. Defaults to `false`.
+             */
+            strict?: boolean;
+
+            /**
+             * Maximum time in milliseconds. Defaults to `30` seconds. Default is
+             * overridden by the `setDefaultTimeout` option on `BrowserContext` or
+             * `page` methods.
+             *
+             * Setting the value to `0` will disable the timeout.
+             */
+            timeout?: number;
+        },
+    ): boolean;
+
+    /**
+     * **NOTE** Use locator-based locator.isHidden([options]) instead.
+     *
+     * Returns whether the element is hidden.
+     *
+     * @param selector A selector to search for an element. If there are multiple
+     * elements satisfying the selector, the first will be used.
+     * @param options
+     */
+    isHidden(
+        selector: string,
+        options?: {
+            /**
+             * When `true`, the call requires selector to resolve to a single element.
+             * If given selector resolves to more than one element, the call throws
+             * an exception. Defaults to `false`.
+             */
+            strict?: boolean;
+
+            /**
+             * Maximum time in milliseconds. Defaults to `30` seconds. Default is
+             * overridden by the `setDefaultTimeout` option on `BrowserContext` or
+             * `page` methods.
+             *
+             * Setting the value to `0` will disable the timeout.
+             */
+            timeout?: number;
+        },
+    ): boolean;
+
+    /**
+     * **NOTE** Use locator-based locator.isVisible([options]) instead.
+     *
+     * Returns whether the element is visible.
+     *
+     * @param selector A selector to search for an element. If there are multiple
+     * elements satisfying the selector, the first will be used.
+     * @param options
+     */
+    isVisible(
+        selector: string,
+        options?: {
+            /**
+             * When `true`, the call requires selector to resolve to a single element.
+             * If given selector resolves to more than one element, the call throws
+             * an exception. Defaults to `false`.
+             */
+            strict?: boolean;
+
+            /**
+             * Maximum time in milliseconds. Defaults to `30` seconds. Default is
+             * overridden by the `setDefaultTimeout` option on `BrowserContext` or
+             * `page` methods.
+             *
+             * Setting the value to `0` will disable the timeout.
+             */
+            timeout?: number;
+        },
+    ): boolean;
+
+    /**
+     * Returns the keyboard instance to interact with a virtual keyboard on the
+     * page.
+     */
+    keyboard: Keyboard;
+
+    /**
+     * The method returns an element locator. Locators resolve to the element
+     * when the action takes place, which means locators can span over navigations
+     * where the underlying dom changes.
+     *
+     * @param selector A selector to use when resolving DOM element.
      */
-    timeout?: number;
-
-    /**
-     * When to consider operation succeeded, defaults to `load`. Events can be
-     * either:
-     * - `'domcontentloaded'` - consider operation to be finished when the
-     * `DOMContentLoaded` event is fired.
-     * - `'load'` - consider operation to be finished when the `load` event is
-     * fired.
-     * - `'networkidle'` - **DISCOURAGED** consider operation to be finished
-     * when there are no network connections for at least `500` ms. Don't use
-     * this method for testing especially with chatty websites where the event
-     * may never fire, rely on web assertions to assess readiness instead.
-     */
-    waitUntil?: "load"|"domcontentloaded"|"networkidle";
-  }): void;
-
-  /**
-   * This setting will change the navigation timeout for the following methods:
-   * - page.goto(url[, options])
-   * - page.reload([options])
-   * - page.setContent(html[, options])
-   * - page.waitForNavigation([options])
-   *
-   * @param timeout in milliseconds
-   */
-  setDefaultNavigationTimeout(timeout: number): void;
-
-  /**
-   * This setting will change the timeout for all the methods accepting a
-   * `timeout` option.
-   *
-   * @param timeout in milliseconds
-   */
-  setDefaultTimeout(timeout: number): void;
-
-  /**
-   * This sets extra HTTP headers which will be sent with subsequent
-   * HTTP requests.
-   *
-   * @param headers An object containing the additional HTTP headers.
-   * All header values must be strings.
-   */
-  setExtraHTTPHeaders(headers: { [key: string]: string; }): void;
-
-  /**
-   * This will update the page's width and height.
-   *
-   * @param viewportSize
-   */
-  setViewportSize(viewportSize: {
-    /**
-     * page width in pixels.
-     */
-    width: number;
-
-    /**
-     * page height in pixels.
-     */
-    height: number;
-  }): void;
-
-  /**
-   * **NOTE** Use locator-based locator.tap([options]) instead.
-   *
-   * Tap the first element that matches the selector.
-   *
-   * @param selector A selector to search for an element. If there are multiple
-   * elements satisfying the selector, the first will be used.
-   * @param options
-   */
-  tap(selector: string, options?: {
-    /**
-     * Setting this to `true` will bypass the actionability checks (visible,
-     * stable, enabled). Defaults to `false`.
-     */
-    force?: boolean;
-
-    /**
-     * `Alt`, `Control`, `Meta` or `Shift` modifiers keys pressed during the
-     * action. If not specified, currently pressed modifiers are used,
-     * otherwise defaults to `null`.
-     */
-    modifiers?: KeyboardModifier[];
+    locator(selector: string): Locator;
 
     /**
-     * If set to `true` and a navigation occurs from performing this action, it
-     * will not wait for it to complete. Defaults to `false`.
+     * The page's main frame. Page is made up of frames in a hierarchical. At the
+     * top is mainFrame. A page is guaranteed to have a mainFrame.
      */
-    noWaitAfter?: boolean;
+    mainFrame(): Frame;
 
     /**
-     * A point to use relative to the top left corner of the element. If not
-     * supplied, a visible point of the element is used.
+     * Returns the mouse instance to interact with a virtual mouse on the page.
      */
-    position?: {
-      x: number;
-
-      y: number;
-    };
+    mouse: Mouse;
 
     /**
-     * When `true`, the call requires selector to resolve to a single element.
-     * If given selector resolves to more than one element, the call throws
-     * an exception. Defaults to `false`.
+     * Returns the page that opened the current page. The first page that is
+     * navigated to will have a null opener.
      */
-    strict?: boolean;
+    opener(): Page | null;
 
     /**
-     * Maximum time in milliseconds. Defaults to `30` seconds. Default is
-     * overridden by the `setDefaultTimeout` option on `BrowserContext` or
-     * `page` methods.
+     * **NOTE** Use locator-based locator.press(key[, options]) instead.
+     *
+     * Focuses the element, and then uses keyboard.down(key) and
+     * keyboard.up(key).
      *
-     * Setting the value to `0` will disable the timeout.
+     * A superset of the `key` values can be found [here](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key/Key_Values).
+     *
+     * Following modification shortcuts are also supported: `Shift`, `Control`,
+     * `Alt`, `Meta`, `ShiftLeft`.
+     *
+     * Holding down `Shift` will type the text that corresponds to the `key` in
+     * the upper case.
+     *
+     * If `key` is a single character, it is case-sensitive, so the values `a`
+     * and `A` will generate different respective texts.
+     *
+     * Shortcuts such as `key: "Control+o"` or `key: "Control+Shift+T"` are
+     * supported as well. When specified with the modifier, modifier is pressed
+     * and being held while the subsequent key is being pressed.
+     *
+     * @param selector A selector to search for an element. If there are multiple
+     * elements satisfying the selector, the first will be used.
+     * @param key Name of the key to press or a character to generate, such as
+     * `ArrowLeft` or `a`.
+     * @param options
+     */
+    press(
+        selector: string,
+        key: string,
+        options?: {
+            /**
+             * Milliseconds to wait between `mousedown` and `mouseup`. Defaults to `0`.
+             */
+            delay?: number;
+
+            /**
+             * If set to `true` and a navigation occurs from performing this action, it
+             * will not wait for it to complete. Defaults to `false`.
+             */
+            noWaitAfter?: boolean;
+
+            /**
+             * When `true`, the call requires selector to resolve to a single element.
+             * If given selector resolves to more than one element, the call throws
+             * an exception. Defaults to `false`.
+             */
+            strict?: boolean;
+
+            /**
+             * Maximum time in milliseconds. Defaults to `30` seconds. Default is
+             * overridden by the `setDefaultTimeout` option on `BrowserContext` or
+             * `page` methods.
+             *
+             * Setting the value to `0` will disable the timeout.
+             */
+            timeout?: number;
+        },
+    ): void;
+
+    /**
+     * This reloads the current page Returns the main resource response.
+     *
+     * @param options
+     */
+    reload(options?: {
+        /**
+         * Maximum operation time in milliseconds. Defaults to `30` seconds. The
+         * default value can be changed via the
+         * browserContext.setDefaultNavigationTimeout(timeout),
+         * browserContext.setDefaultTimeout(timeout),
+         * page.setDefaultNavigationTimeout(timeout) or
+         * page.setDefaultTimeout(timeout) methods.
+         *
+         * Setting the value to `0` will disable the timeout.
+         *
+         */
+        timeout?: number;
+
+        /**
+         * When to consider operation succeeded, defaults to `load`. Events can be
+         * either:
+         * - `'domcontentloaded'` - consider operation to be finished when the
+         * `DOMContentLoaded` event is fired.
+         * - `'load'` - consider operation to be finished when the `load` event is
+         * fired.
+         * - `'networkidle'` - **DISCOURAGED** consider operation to be finished
+         * when there are no network connections for at least `500` ms. Don't use
+         * this method for testing especially with chatty websites where the event
+         * may never fire, rely on web assertions to assess readiness instead.
+         */
+        waitUntil?: 'load' | 'domcontentloaded' | 'networkidle';
+    }): null | Response;
+
+    /**
+     * Returns the buffer with the captured screenshot from the browser.
+     *
+     * @param options
+     */
+    screenshot(
+        options?: {
+            /**
+             * An object which specifies clipping of the resulting image.
+             */
+            clip?: {
+                /**
+                 * x-coordinate of top-left corner of clip area
+                 */
+                x: number;
+
+                /**
+                 * y-coordinate of top-left corner of clip area
+                 */
+                y: number;
+
+                /**
+                 * width of clipping area
+                 */
+                width: number;
+
+                /**
+                 * height of clipping area
+                 */
+                height: number;
+            };
+
+            /**
+             * When true, takes a screenshot of the full scrollable page, instead of
+             * the currently visible viewport. Defaults to `false`.
+             */
+            fullPage?: boolean;
+        } & ScreenshotOptions,
+    ): ArrayBuffer;
+
+    /**
+     * **NOTE** Use locator-based locator.selectOption(values[, options]) instead.
+     *
+     * This select one or more options which match the values from a <select>
+     * element.
+     *
+     * @param selector A selector to search for an element. If there are multiple
+     * elements satisfying the selector, the first will be used.
+     * @param values Options to select. If the select has multiple attribute, all
+     * matching options are selected, otherwise only the first option matching
+     * one of the passed options is selected. Object can be made up of keys with
+     * value, label or index.
+     * @param options
+     */
+    selectOption(
+        selector: string,
+        values: string | ElementHandle | SelectOptionsObject | string[] | ElementHandle[] | SelectOptionsObject[],
+        options?: {
+            /**
+             * Setting this to `true` will bypass the actionability checks (visible,
+             * stable, enabled). Defaults to `false`.
+             */
+            force?: boolean;
+
+            /**
+             * If set to `true` and a navigation occurs from performing this action, it
+             * will not wait for it to complete. Defaults to `false`.
+             */
+            noWaitAfter?: boolean;
+
+            /**
+             * When `true`, the call requires selector to resolve to a single element.
+             * If given selector resolves to more than one element, the call throws
+             * an exception. Defaults to `false`.
+             */
+            strict?: boolean;
+
+            /**
+             * Maximum time in milliseconds. Defaults to `30` seconds. Default is
+             * overridden by the `setDefaultTimeout` option on `BrowserContext` or
+             * `page` methods.
+             *
+             * Setting the value to `0` will disable the timeout.
+             */
+            timeout?: number;
+        },
+    ): string[];
+
+    /**
+     * Set the supplied html string to the current page.
+     *
+     * @param html HTML markup to assign to the page.
+     * @param options
+     */
+    setContent(
+        html: string,
+        options?: {
+            /**
+             * Maximum operation time in milliseconds. Defaults to `30` seconds. The
+             * default value can be changed via the
+             * browserContext.setDefaultNavigationTimeout(timeout),
+             * browserContext.setDefaultTimeout(timeout),
+             * page.setDefaultNavigationTimeout(timeout) or
+             * page.setDefaultTimeout(timeout) methods.
+             *
+             * Setting the value to `0` will disable the timeout.
+             *
+             */
+            timeout?: number;
+
+            /**
+             * When to consider operation succeeded, defaults to `load`. Events can be
+             * either:
+             * - `'domcontentloaded'` - consider operation to be finished when the
+             * `DOMContentLoaded` event is fired.
+             * - `'load'` - consider operation to be finished when the `load` event is
+             * fired.
+             * - `'networkidle'` - **DISCOURAGED** consider operation to be finished
+             * when there are no network connections for at least `500` ms. Don't use
+             * this method for testing especially with chatty websites where the event
+             * may never fire, rely on web assertions to assess readiness instead.
+             */
+            waitUntil?: 'load' | 'domcontentloaded' | 'networkidle';
+        },
+    ): void;
+
+    /**
+     * This setting will change the navigation timeout for the following methods:
+     * - page.goto(url[, options])
+     * - page.reload([options])
+     * - page.setContent(html[, options])
+     * - page.waitForNavigation([options])
+     *
+     * @param timeout in milliseconds
      */
-    timeout?: number;
+    setDefaultNavigationTimeout(timeout: number): void;
 
     /**
-     * Setting this to `true` will perform the actionability checks without
-     * performing the action. Useful to wait until the element is ready for the
-     * action without performing it. Defaults to `false`.
-     */
-    trial?: boolean;
-  }): void;
-
-  /**
-   * **NOTE** Use locator-based locator.textContent([options]) instead.
-   *
-   * Returns `element.textContent`.
-   *
-   * @param selector A selector to search for an element. If there are multiple
-   * elements satisfying the selector, the first will be used.
-   * @param options
-   */
-  textContent(selector: string, options?: {
-    /**
-     * When `true`, the call requires selector to resolve to a single element.
-     * If given selector resolves to more than one element, the call throws
-     * an exception. Defaults to `false`.
+     * This setting will change the timeout for all the methods accepting a
+     * `timeout` option.
+     *
+     * @param timeout in milliseconds
      */
-    strict?: boolean;
+    setDefaultTimeout(timeout: number): void;
 
     /**
-     * Maximum time in milliseconds. Defaults to `30` seconds. Default is
-     * overridden by the `setDefaultTimeout` option on `BrowserContext` or
-     * `page` methods.
+     * This sets extra HTTP headers which will be sent with subsequent
+     * HTTP requests.
      *
-     * Setting the value to `0` will disable the timeout.
+     * @param headers An object containing the additional HTTP headers.
+     * All header values must be strings.
      */
-    timeout?: number;
-  }): string;
-
-  /**
-   * Returns the page's title.
-   */
-  title(): string;
-
-  /**
-   * Returns the touchscreen instance to interact with a virtual touchscreen on
-   * the page.
-   */
-  touchscreen: Touchscreen;
-
-  /**
-   * **NOTE** Use locator-based locator.type(text[, options]) instead.
-   *
-   * Type the `text` in the first element found that matches the selector.
-   *
-   * @param selector A selector to search for an element. If there are multiple
-   * elements satisfying the selector, the first will be used.
-   * @param text The text to type into the element.
-   * @param options
-   */
-  type(selector: string, text: string, options?: {
-    /**
-     * Milliseconds to wait between `mousedown` and `mouseup`. Defaults to `0`.
-     */
-    delay?: number;
+    setExtraHTTPHeaders(headers: { [key: string]: string }): void;
 
     /**
-     * If set to `true` and a navigation occurs from performing this action, it
-     * will not wait for it to complete. Defaults to `false`.
+     * This will update the page's width and height.
+     *
+     * @param viewportSize
      */
-    noWaitAfter?: boolean;
+    setViewportSize(viewportSize: {
+        /**
+         * page width in pixels.
+         */
+        width: number;
 
-    /**
-     * When `true`, the call requires selector to resolve to a single element.
-     * If given selector resolves to more than one element, the call throws
-     * an exception. Defaults to `false`.
-     */
-    strict?: boolean;
+        /**
+         * page height in pixels.
+         */
+        height: number;
+    }): void;
 
     /**
-     * Maximum time in milliseconds. Defaults to `30` seconds. Default is
-     * overridden by the `setDefaultTimeout` option on `BrowserContext` or
-     * `page` methods.
+     * **NOTE** Use locator-based locator.tap([options]) instead.
      *
-     * Setting the value to `0` will disable the timeout.
-     */
-    timeout?: number;
-  }): void;
-
-  /**
-   * **NOTE** Use locator-based `locator.uncheck([options])` instead.
-   *
-   * This method is used to unselect an input checkbox.
-   *
-   * @param selector A selector to search for an element. If there are multiple
-   * elements satisfying the selector, the first will be used.
-   * @param options
-   */
-  uncheck(selector: string, options?: {
-    /**
-     * Setting this to `true` will bypass the actionability checks (visible,
-     * stable, enabled). Defaults to `false`.
+     * Tap the first element that matches the selector.
+     *
+     * @param selector A selector to search for an element. If there are multiple
+     * elements satisfying the selector, the first will be used.
+     * @param options
+     */
+    tap(
+        selector: string,
+        options?: {
+            /**
+             * Setting this to `true` will bypass the actionability checks (visible,
+             * stable, enabled). Defaults to `false`.
+             */
+            force?: boolean;
+
+            /**
+             * `Alt`, `Control`, `Meta` or `Shift` modifiers keys pressed during the
+             * action. If not specified, currently pressed modifiers are used,
+             * otherwise defaults to `null`.
+             */
+            modifiers?: KeyboardModifier[];
+
+            /**
+             * If set to `true` and a navigation occurs from performing this action, it
+             * will not wait for it to complete. Defaults to `false`.
+             */
+            noWaitAfter?: boolean;
+
+            /**
+             * A point to use relative to the top left corner of the element. If not
+             * supplied, a visible point of the element is used.
+             */
+            position?: {
+                x: number;
+
+                y: number;
+            };
+
+            /**
+             * When `true`, the call requires selector to resolve to a single element.
+             * If given selector resolves to more than one element, the call throws
+             * an exception. Defaults to `false`.
+             */
+            strict?: boolean;
+
+            /**
+             * Maximum time in milliseconds. Defaults to `30` seconds. Default is
+             * overridden by the `setDefaultTimeout` option on `BrowserContext` or
+             * `page` methods.
+             *
+             * Setting the value to `0` will disable the timeout.
+             */
+            timeout?: number;
+
+            /**
+             * Setting this to `true` will perform the actionability checks without
+             * performing the action. Useful to wait until the element is ready for the
+             * action without performing it. Defaults to `false`.
+             */
+            trial?: boolean;
+        },
+    ): void;
+
+    /**
+     * **NOTE** Use locator-based locator.textContent([options]) instead.
+     *
+     * Returns `element.textContent`.
+     *
+     * @param selector A selector to search for an element. If there are multiple
+     * elements satisfying the selector, the first will be used.
+     * @param options
      */
-    force?: boolean;
+    textContent(
+        selector: string,
+        options?: {
+            /**
+             * When `true`, the call requires selector to resolve to a single element.
+             * If given selector resolves to more than one element, the call throws
+             * an exception. Defaults to `false`.
+             */
+            strict?: boolean;
 
-    /**
-     * If set to `true` and a navigation occurs from performing this action, it
-     * will not wait for it to complete. Defaults to `false`.
-     */
-    noWaitAfter?: boolean;
+            /**
+             * Maximum time in milliseconds. Defaults to `30` seconds. Default is
+             * overridden by the `setDefaultTimeout` option on `BrowserContext` or
+             * `page` methods.
+             *
+             * Setting the value to `0` will disable the timeout.
+             */
+            timeout?: number;
+        },
+    ): string;
 
     /**
-     * A point to use relative to the top left corner of the element. If not
-     * supplied, a visible point of the element is used.
+     * Returns the page's title.
      */
-    position?: {
-      x: number;
-
-      y: number;
-    };
+    title(): string;
 
     /**
-     * When `true`, the call requires selector to resolve to a single element.
-     * If given selector resolves to more than one element, the call throws
-     * an exception. Defaults to `false`.
+     * Returns the touchscreen instance to interact with a virtual touchscreen on
+     * the page.
      */
-    strict?: boolean;
+    touchscreen: Touchscreen;
 
     /**
-     * Maximum time in milliseconds. Defaults to `30` seconds. Default is
-     * overridden by the `setDefaultTimeout` option on `BrowserContext` or
-     * `page` methods.
+     * **NOTE** Use locator-based locator.type(text[, options]) instead.
      *
-     * Setting the value to `0` will disable the timeout.
-     */
-    timeout?: number;
-
-    /**
-     * Setting this to `true` will perform the actionability checks without
-     * performing the action. Useful to wait until the element is ready for the
-     * action without performing it. Defaults to `false`.
-     */
-    trial?: boolean;
-  }): void;
-
-  /**
-   * Returns the page's URL.
-   */
-  url(): string;
-
-  /**
-   * Returns the page's size (width and height).
-   */
-  viewportSize(): {
-    /**
-     * page width in pixels.
-     */
-    width: number;
-
-    /**
-     * page height in pixels.
-     */
-    height: number;
-  };
-
-  /**
-   * Returns when the `pageFunction` returns a truthy value.
-   *
-   * @param pageFunction Function to be evaluated in the page context.
-   * @param arg Optional argument to pass to `pageFunction`.
-   * @param options
-   */
-  waitForFunction<R, Arg>(pageFunction: PageFunction<Arg, R>, options?: {
-    /**
-     * If `polling` is `'raf'`, then `pageFunction` is constantly executed in
-     * `requestAnimationFrame` callback. If `polling` is a number, then it is
-     * treated as an interval in milliseconds at which the function would be
-     * executed. Defaults to `raf`.
-     */
-    polling?: number|"raf";
-
-    /**
-     * Maximum time in milliseconds. Defaults to `30` seconds. Default is
-     * overridden by the `setDefaultTimeout` option on `BrowserContext` or
-     * `page` methods.
+     * Type the `text` in the first element found that matches the selector.
      *
-     * Setting the value to `0` will disable the timeout.
-     */
-    timeout?: number;
-  }, arg?: Arg): Promise<JSHandle<R>>;
-
-  /**
-   * This waits for the given load state to be reached. It will immediately
-   * unblock if that lifecycle event has already been received.
-   *
-   * @param state Optional load state to wait for, defaults to `load`:
-   * - `'domcontentloaded'` - consider operation to be finished when the
-   * `DOMContentLoaded` event is fired.
-   * - `'load'` - consider operation to be finished when the `load` event is
-   * fired.
-   * - `'networkidle'` - **DISCOURAGED** consider operation to be finished
-   * when there are no network connections for at least `500` ms. Don't use
-   * this method for testing especially with chatty websites where the event
-   * may never fire, rely on web assertions to assess readiness instead.
-   * @param options
-   */
-  waitForLoadState(state?: "load"|"domcontentloaded"|"networkidle", options?: {
-    /**
-     * Maximum operation time in milliseconds. Defaults to `30` seconds. The
-     * default value can be changed via the
-     * browserContext.setDefaultNavigationTimeout(timeout),
-     * browserContext.setDefaultTimeout(timeout),
-     * page.setDefaultNavigationTimeout(timeout) or
-     * page.setDefaultTimeout(timeout) methods.
+     * @param selector A selector to search for an element. If there are multiple
+     * elements satisfying the selector, the first will be used.
+     * @param text The text to type into the element.
+     * @param options
+     */
+    type(
+        selector: string,
+        text: string,
+        options?: {
+            /**
+             * Milliseconds to wait between `mousedown` and `mouseup`. Defaults to `0`.
+             */
+            delay?: number;
+
+            /**
+             * If set to `true` and a navigation occurs from performing this action, it
+             * will not wait for it to complete. Defaults to `false`.
+             */
+            noWaitAfter?: boolean;
+
+            /**
+             * When `true`, the call requires selector to resolve to a single element.
+             * If given selector resolves to more than one element, the call throws
+             * an exception. Defaults to `false`.
+             */
+            strict?: boolean;
+
+            /**
+             * Maximum time in milliseconds. Defaults to `30` seconds. Default is
+             * overridden by the `setDefaultTimeout` option on `BrowserContext` or
+             * `page` methods.
+             *
+             * Setting the value to `0` will disable the timeout.
+             */
+            timeout?: number;
+        },
+    ): void;
+
+    /**
+     * **NOTE** Use locator-based `locator.uncheck([options])` instead.
      *
-     * Setting the value to `0` will disable the timeout.
+     * This method is used to unselect an input checkbox.
      *
-     */
-    timeout?: number;
-  }): void;
-
-  /**
-   * Waits for the given navigation lifecycle event to occur and returns the main
-   * resource response.
-   *
-   * @param options
-   */
-  waitForNavigation(options?: {
+     * @param selector A selector to search for an element. If there are multiple
+     * elements satisfying the selector, the first will be used.
+     * @param options
+     */
+    uncheck(
+        selector: string,
+        options?: {
+            /**
+             * Setting this to `true` will bypass the actionability checks (visible,
+             * stable, enabled). Defaults to `false`.
+             */
+            force?: boolean;
+
+            /**
+             * If set to `true` and a navigation occurs from performing this action, it
+             * will not wait for it to complete. Defaults to `false`.
+             */
+            noWaitAfter?: boolean;
+
+            /**
+             * A point to use relative to the top left corner of the element. If not
+             * supplied, a visible point of the element is used.
+             */
+            position?: {
+                x: number;
+
+                y: number;
+            };
+
+            /**
+             * When `true`, the call requires selector to resolve to a single element.
+             * If given selector resolves to more than one element, the call throws
+             * an exception. Defaults to `false`.
+             */
+            strict?: boolean;
+
+            /**
+             * Maximum time in milliseconds. Defaults to `30` seconds. Default is
+             * overridden by the `setDefaultTimeout` option on `BrowserContext` or
+             * `page` methods.
+             *
+             * Setting the value to `0` will disable the timeout.
+             */
+            timeout?: number;
+
+            /**
+             * Setting this to `true` will perform the actionability checks without
+             * performing the action. Useful to wait until the element is ready for the
+             * action without performing it. Defaults to `false`.
+             */
+            trial?: boolean;
+        },
+    ): void;
+
+    /**
+     * Returns the page's URL.
+     */
+    url(): string;
+
+    /**
+     * Returns the page's size (width and height).
+     */
+    viewportSize(): {
+        /**
+         * page width in pixels.
+         */
+        width: number;
+
+        /**
+         * page height in pixels.
+         */
+        height: number;
+    };
+
     /**
-     * Maximum operation time in milliseconds. Defaults to `30` seconds. The
-     * default value can be changed via the
-     * browserContext.setDefaultNavigationTimeout(timeout),
-     * browserContext.setDefaultTimeout(timeout),
-     * page.setDefaultNavigationTimeout(timeout) or
-     * page.setDefaultTimeout(timeout) methods.
+     * Returns when the `pageFunction` returns a truthy value.
      *
-     * Setting the value to `0` will disable the timeout.
+     * @param pageFunction Function to be evaluated in the page context.
+     * @param arg Optional argument to pass to `pageFunction`.
+     * @param options
+     */
+    waitForFunction<R, Arg>(
+        pageFunction: PageFunction<Arg, R>,
+        options?: {
+            /**
+             * If `polling` is `'raf'`, then `pageFunction` is constantly executed in
+             * `requestAnimationFrame` callback. If `polling` is a number, then it is
+             * treated as an interval in milliseconds at which the function would be
+             * executed. Defaults to `raf`.
+             */
+            polling?: number | 'raf';
+
+            /**
+             * Maximum time in milliseconds. Defaults to `30` seconds. Default is
+             * overridden by the `setDefaultTimeout` option on `BrowserContext` or
+             * `page` methods.
+             *
+             * Setting the value to `0` will disable the timeout.
+             */
+            timeout?: number;
+        },
+        arg?: Arg,
+    ): Promise<JSHandle<R>>;
+
+    /**
+     * This waits for the given load state to be reached. It will immediately
+     * unblock if that lifecycle event has already been received.
      *
-     */
-    timeout?: number;
-
-    /**
-     * When to consider operation succeeded, defaults to `load`. Events can be
-     * either:
+     * @param state Optional load state to wait for, defaults to `load`:
      * - `'domcontentloaded'` - consider operation to be finished when the
      * `DOMContentLoaded` event is fired.
      * - `'load'` - consider operation to be finished when the `load` event is
@@ -1353,80 +1391,134 @@ export class Page {
      * when there are no network connections for at least `500` ms. Don't use
      * this method for testing especially with chatty websites where the event
      * may never fire, rely on web assertions to assess readiness instead.
+     * @param options
+     */
+    waitForLoadState(
+        state?: 'load' | 'domcontentloaded' | 'networkidle',
+        options?: {
+            /**
+             * Maximum operation time in milliseconds. Defaults to `30` seconds. The
+             * default value can be changed via the
+             * browserContext.setDefaultNavigationTimeout(timeout),
+             * browserContext.setDefaultTimeout(timeout),
+             * page.setDefaultNavigationTimeout(timeout) or
+             * page.setDefaultTimeout(timeout) methods.
+             *
+             * Setting the value to `0` will disable the timeout.
+             *
+             */
+            timeout?: number;
+        },
+    ): void;
+
+    /**
+     * Waits for the given navigation lifecycle event to occur and returns the main
+     * resource response.
+     *
+     * @param options
+     */
+    waitForNavigation(options?: {
+        /**
+         * Maximum operation time in milliseconds. Defaults to `30` seconds. The
+         * default value can be changed via the
+         * browserContext.setDefaultNavigationTimeout(timeout),
+         * browserContext.setDefaultTimeout(timeout),
+         * page.setDefaultNavigationTimeout(timeout) or
+         * page.setDefaultTimeout(timeout) methods.
+         *
+         * Setting the value to `0` will disable the timeout.
+         *
+         */
+        timeout?: number;
+
+        /**
+         * When to consider operation succeeded, defaults to `load`. Events can be
+         * either:
+         * - `'domcontentloaded'` - consider operation to be finished when the
+         * `DOMContentLoaded` event is fired.
+         * - `'load'` - consider operation to be finished when the `load` event is
+         * fired.
+         * - `'networkidle'` - **DISCOURAGED** consider operation to be finished
+         * when there are no network connections for at least `500` ms. Don't use
+         * this method for testing especially with chatty websites where the event
+         * may never fire, rely on web assertions to assess readiness instead.
+         */
+        waitUntil?: 'load' | 'domcontentloaded' | 'networkidle';
+    }): Promise<null | Response>;
+
+    /**
+     * **NOTE** Use web assertions that assert visibility or a locator-based
+     * locator.waitFor([options]) instead.
+     *
+     * Returns when element specified by selector satisfies `state` option.
+     *
+     * @param selector A selector to query for.
+     * @param options
+     */
+    waitForSelector(
+        selector: string,
+        options?: {
+            /**
+             * Defaults to `'visible'`. Can be either:
+             * - `'attached'` - wait for element to be present in DOM.
+             * - `'detached'` - wait for element to not be present in DOM.
+             * - `'visible'` - wait for element to have non-empty bounding box and no
+             * `visibility:hidden`.
+             * - `'hidden'` - wait for element to be either detached from DOM, or have
+             * an empty bounding box or `visibility:hidden`.
+             */
+            state?: 'attached' | 'detached' | 'visible' | 'hidden';
+
+            /**
+             * When `true`, the call requires selector to resolve to a single element.
+             * If given selector resolves to more than one element, the call throws
+             * an exception. Defaults to `false`.
+             */
+            strict?: boolean;
+
+            /**
+             * Maximum time in milliseconds. Defaults to `30` seconds. Default is
+             * overridden by the `setDefaultTimeout` option on `BrowserContext` or
+             * `page` methods.
+             *
+             * Setting the value to `0` will disable the timeout.
+             */
+            timeout?: number;
+        },
+    ): ElementHandle;
+
+    /**
+     * **NOTE** Never wait for timeout in production, use this only for debugging.
+     * Tests that wait for time are inherently flaky. Use `Locator` actions and
+     * web assertions that wait automatically.
+     *
+     * Waits for the given `timeout` in milliseconds.
+     *
+     * @param timeout A timeout to wait for
      */
-    waitUntil?: "load"|"domcontentloaded"|"networkidle";
-  }): Promise<null|Response>;
-
-  /**
-   * **NOTE** Use web assertions that assert visibility or a locator-based
-   * locator.waitFor([options]) instead.
-   *
-   * Returns when element specified by selector satisfies `state` option.
-   *
-   * @param selector A selector to query for.
-   * @param options
-   */
-  waitForSelector(selector: string, options?: {
+    waitForTimeout(timeout: number): void;
+
     /**
-     * Defaults to `'visible'`. Can be either:
-     * - `'attached'` - wait for element to be present in DOM.
-     * - `'detached'` - wait for element to not be present in DOM.
-     * - `'visible'` - wait for element to have non-empty bounding box and no
-     * `visibility:hidden`.
-     * - `'hidden'` - wait for element to be either detached from DOM, or have
-     * an empty bounding box or `visibility:hidden`.
+     * This method returns all of the dedicated WebWorkers associated with the page.
      */
-    state?: "attached"|"detached"|"visible"|"hidden";
+    workers(): Worker[];
 
     /**
-     * When `true`, the call requires selector to resolve to a single element.
-     * If given selector resolves to more than one element, the call throws
-     * an exception. Defaults to `false`.
+     * **NOTE** Use locator-based page.locator(selector[, options]) instead.
+     *
+     * The method finds an element matching the specified selector within the page.
+     * If no elements match the selector, the return value resolves to `null`.
+     * To wait for an element on the page, use locator.waitFor([options]).
+     * @param selector A selector to query for.
      */
-    strict?: boolean;
+    $(selector: string): ElementHandle;
 
     /**
-     * Maximum time in milliseconds. Defaults to `30` seconds. Default is
-     * overridden by the `setDefaultTimeout` option on `BrowserContext` or
-     * `page` methods.
+     * **NOTE** Use locator-based page.locator(selector[, options]) instead.
      *
-     * Setting the value to `0` will disable the timeout.
+     * The method finds all elements matching the specified selector within the
+     * page. If no elements match the selector, the return value resolves to `[]`.
+     * @param selector A selector to query for.
      */
-    timeout?: number;
-  }): ElementHandle;
-
-  /**
-   * **NOTE** Never wait for timeout in production, use this only for debugging.
-   * Tests that wait for time are inherently flaky. Use `Locator` actions and
-   * web assertions that wait automatically.
-   *
-   * Waits for the given `timeout` in milliseconds.
-   *
-   * @param timeout A timeout to wait for
-   */
-  waitForTimeout(timeout: number): void;
-
-  /**
-   * This method returns all of the dedicated WebWorkers associated with the page.
-   */
-  workers(): Worker[];
-
-  /**
-   * **NOTE** Use locator-based page.locator(selector[, options]) instead.
-   *
-   * The method finds an element matching the specified selector within the page.
-   * If no elements match the selector, the return value resolves to `null`.
-   * To wait for an element on the page, use locator.waitFor([options]).
-   * @param selector A selector to query for.
-   */
-  $(selector: string): ElementHandle;
-
-  /**
-   * **NOTE** Use locator-based page.locator(selector[, options]) instead.
-   *
-   * The method finds all elements matching the specified selector within the
-   * page. If no elements match the selector, the return value resolves to `[]`.
-   * @param selector A selector to query for.
-   */
-  $$(selector: string): ElementHandle[];
+    $$(selector: string): ElementHandle[];
 }