diff --git a/docs-src/api-body.md b/docs-src/api-body.md
index c66f4fd4c3..f996d2c5cf 100644
--- a/docs-src/api-body.md
+++ b/docs-src/api-body.md
@@ -1,4 +1,4 @@
-### class: Browser
+# class: Browser
* extends: [EventEmitter](https://nodejs.org/api/events.html#events_class_eventemitter)
A Browser is created when Playwright connects to a browser instance, either through [browserType.launch()]() or
@@ -24,13 +24,13 @@ being connected to or launched.
-#### event Browser.disconnected
+## event: Browser.disconnected
Emitted when Browser gets disconnected from the browser application. This might happen because of one of the following:
* Browser application is closed or crashed.
* The [browser.close()]() method was called.
-#### method Browser.close
+## method: Browser.close
- returns: <[Promise]>
In case this browser is obtained using [browserType.launch()](), closes the browser and all of its pages (if any were
@@ -41,7 +41,7 @@ and disconnects from the browser server.
The [Browser] object itself is considered to be disposed and cannot be used anymore.
-#### method Browser.contexts
+## method: Browser.contexts
- returns: <[Array]<[BrowserContext]>>
Returns an array of all open browser contexts. In a newly created browser, this will return zero browser contexts.
@@ -54,16 +54,12 @@ const context = await browser.newContext();
console.log(browser.contexts().length); // prints `1`
```
-#### method Browser.isConnected
+## method: Browser.isConnected
- returns: <[boolean]>
Indicates that the browser is connected.
-#### method Browser.newContext
-- `options` <[Object]>
- - %%-shared-context-params-%%-as-is
- - %%-context-option-proxy-%%
- - %%-context-option-storage-state-%%
+## method: Browser.newContext
- returns: <[Promise]<[BrowserContext]>>
Creates a new browser context. It won't share cookies/cache with other browser contexts.
@@ -79,11 +75,11 @@ Creates a new browser context. It won't share cookies/cache with other browser c
})();
```
-#### method Browser.newPage
-- `options` <[Object]>
- - %%-shared-context-params-%%-as-is
- - %%-context-option-proxy-%%
- - %%-context-option-storage-state-%%
+### option: Browser.newContext.-inline- = %%-shared-context-params-list-%%
+### option: Browser.newContext.proxy = %%-context-option-proxy-%%
+### option: Browser.newContext.storageState = %%-context-option-storage-state-%%
+
+## method: Browser.newPage
- returns: <[Promise]<[Page]>>
Creates a new page in a new browser context. Closing this page will close the context as well.
@@ -92,12 +88,16 @@ This is a convenience API that should only be used for the single-page scenarios
testing frameworks should explicitly create [browser.newContext()]() followed by the [browserContext.newPage()]() to
control their exact life times.
-#### method Browser.version
+### option: Browser.newPage.-inline- = %%-shared-context-params-list-%%
+### option: Browser.newPage.proxy = %%-context-option-proxy-%%
+### option: Browser.newPage.storageState = %%-context-option-storage-state-%%
+
+## method: Browser.version
- returns: <[string]>
Returns the browser version.
-### class: BrowserContext
+# class: BrowserContext
* extends: [EventEmitter](https://nodejs.org/api/events.html#events_class_eventemitter)
BrowserContexts provide a way to operate multiple independent browser sessions.
@@ -121,14 +121,14 @@ await context.close();
-#### event BrowserContext.close
+## event: BrowserContext.close
Emitted when Browser context gets closed. This might happen because of one of the following:
* Browser context is closed.
* Browser application is closed or crashed.
* The [browser.close()]() method was called.
-#### event BrowserContext.page
+## event: BrowserContext.page
- <[Page]>
The event is emitted when a new Page is created in the BrowserContext. The page may still be loading. The event will
@@ -149,7 +149,14 @@ console.log(await page.evaluate('location.href'));
> **NOTE** Use [page.waitForLoadState()]() to wait until the page gets to a particular state (you should not need it in
most cases).
-#### method BrowserContext.addCookies
+## method: BrowserContext.addCookies
+- returns: <[Promise]>
+
+```js
+await browserContext.addCookies([cookieObject1, cookieObject2]);
+```
+
+### param: BrowserContext.addCookies.cookies
- `cookies` <[Array]<[Object]>>
- `name` <[string]> **required**
- `value` <[string]> **required**
@@ -160,22 +167,14 @@ most cases).
- `httpOnly` <[boolean]>
- `secure` <[boolean]>
- `sameSite` <"Strict"|"Lax"|"None">
-- returns: <[Promise]>
-```js
-await browserContext.addCookies([cookieObject1, cookieObject2]);
-```
-
-#### method BrowserContext.addInitScript
-- `script` <[function]|[string]|[Object]> Script to be evaluated in all pages in the browser context.
- - `path` <[string]> Path to the JavaScript file. If `path` is a relative path, then it is resolved relative to [current working directory](https://nodejs.org/api/process.html#process_process_cwd).
- - `content` <[string]> Raw script content.
-- `arg` <[Serializable]> Optional argument to pass to `script` (only supported when passing a function).
+## method: BrowserContext.addInitScript
- returns: <[Promise]>
Adds a script which would be evaluated in one of the following scenarios:
* Whenever a page is created in the browser context or is navigated.
-* Whenever a child frame is attached or navigated in any page in the browser context. In this case, the script is evaluated in the context of the newly attached frame.
+* Whenever a child frame is attached or navigated in any page in the browser context. In this case, the script is
+ evaluated in the context of the newly attached frame.
The script is evaluated after the document was created but before any of its scripts were run. This is useful to amend
the JavaScript environment, e.g. to seed `Math.random`.
@@ -197,15 +196,29 @@ await browserContext.addInitScript({
> **NOTE** The order of evaluation of multiple scripts installed via [browserContext.addInitScript()]() and
[page.addInitScript()]() is not defined.
-#### method BrowserContext.browser
-- returns: <[null]|[Browser]> Returns the browser instance of the context. If it was launched as a persistent context null gets returned.
+### param: BrowserContext.addInitScript.script
+- `script` <[function]|[string]|[Object]>
+ - `path` <[string]> Path to the JavaScript file. If `path` is a relative path, then it is resolved relative to
+ [current working directory](https://nodejs.org/api/process.html#process_process_cwd).
+ - `content` <[string]> Raw script content.
-#### method BrowserContext.clearCookies
+Script to be evaluated in all pages in the browser context.
+
+### param: BrowserContext.addInitScript.arg
+- `arg` <[Serializable]>
+
+Optional argument to pass to `script` (only supported when passing a function).
+
+## method: BrowserContext.browser
+- returns: <[null]|[Browser]> Returns the browser instance of the context. If it was launched as a persistent context
+ null gets returned.
+
+## method: BrowserContext.clearCookies
- returns: <[Promise]>
Clears context cookies.
-#### method BrowserContext.clearPermissions
+## method: BrowserContext.clearPermissions
- returns: <[Promise]>
Clears all permission overrides for the browser context.
@@ -217,15 +230,14 @@ await context.grantPermissions(['clipboard-read']);
context.clearPermissions();
```
-#### method BrowserContext.close
+## method: BrowserContext.close
- returns: <[Promise]>
Closes the browser context. All the pages that belong to the browser context will be closed.
> **NOTE** the default browser context cannot be closed.
-#### method BrowserContext.cookies
-- `urls` <[string]|[Array]<[string]>> Optional list of URLs.
+## method: BrowserContext.cookies
- returns: <[Promise]<[Array]<[Object]>>>
- `name` <[string]>
- `value` <[string]>
@@ -239,11 +251,12 @@ Closes the browser context. All the pages that belong to the browser context wil
If no URLs are specified, this method returns all cookies. If URLs are specified, only cookies that affect those URLs
are returned.
-#### method BrowserContext.exposeBinding
-- `name` <[string]> Name of the function on the window object.
-- `playwrightBinding` <[function]> Callback function that will be called in the Playwright's context.
-- `options` <[Object]>
- - `handle` <[boolean]> Whether to pass the argument as a handle, instead of passing by value. When passing a handle, only one argument is supported. When passing by value, multiple arguments are supported.
+### param: BrowserContext.cookies.urls
+- `urls` <[string]|[Array]<[string]>>
+
+Optional list of URLs.
+
+## method: BrowserContext.exposeBinding
- returns: <[Promise]>
The method adds a function called `name` on the `window` object of every frame in every page in the context. When
@@ -293,9 +306,23 @@ await page.setContent(`
`);
```
-#### method BrowserContext.exposeFunction
-- `name` <[string]> Name of the function on the window object.
-- `playwrightFunction` <[function]> Callback function that will be called in the Playwright's context.
+### param: BrowserContext.exposeBinding.name
+- `name` <[string]>
+
+Name of the function on the window object.
+
+### param: BrowserContext.exposeBinding.playwrightBinding
+- `playwrightBinding` <[function]>
+
+Callback function that will be called in the Playwright's context.
+
+### option: BrowserContext.exposeBinding.handle
+- `handle` <[boolean]>
+
+Whether to pass the argument as a handle, instead of passing by value. When passing a handle, only one argument is
+supported. When passing by value, multiple arguments are supported.
+
+## method: BrowserContext.exposeFunction
- returns: <[Promise]>
The method adds a function called `name` on the `window` object of every frame in every page in the context. When
@@ -330,8 +357,24 @@ const crypto = require('crypto');
})();
```
-#### method BrowserContext.grantPermissions
-- `permissions` <[Array]<[string]>> A permission or an array of permissions to grant. Permissions can be one of the following values:
+### param: BrowserContext.exposeFunction.name
+- `name` <[string]>
+
+Name of the function on the window object.
+
+### param: BrowserContext.exposeFunction.playwrightFunction
+- `playwrightFunction` <[function]>
+
+Callback function that will be called in the Playwright's context.
+
+## method: BrowserContext.grantPermissions
+- returns: <[Promise]>
+
+Grants specified permissions to the browser context. Only grants corresponding permissions to the given origin if
+specified.
+
+### param: BrowserContext.grantPermissions.permissions
+- `permissions` <[Array]<[string]>>
- `'geolocation'`
- `'midi'`
- `'midi-sysex'` (system-exclusive midi)
@@ -348,24 +391,24 @@ const crypto = require('crypto');
- `'clipboard-read'`
- `'clipboard-write'`
- `'payment-handler'`
-- `options` <[Object]>
- - `origin` <[string]> The [origin] to grant permissions to, e.g. "https://example.com".
-- returns: <[Promise]>
-Grants specified permissions to the browser context. Only grants corresponding permissions to the given origin if
-specified.
+A permission or an array of permissions to grant. Permissions can be one of the following values:
-#### method BrowserContext.newPage
+### option: BrowserContext.grantPermissions.origin
+- `origin` <[string]>
+
+The [origin] to grant permissions to, e.g. "https://example.com".
+
+## method: BrowserContext.newPage
- returns: <[Promise]<[Page]>>
Creates a new page in the browser context.
-#### method BrowserContext.pages
-- returns: <[Array]<[Page]>> All open pages in the context. Non visible pages, such as `"background_page"`, will not be listed here. You can find them using [chromiumBrowserContext.backgroundPages()]().
+## method: BrowserContext.pages
+- returns: <[Array]<[Page]>> All open pages in the context. Non visible pages, such as `"background_page"`, will not be
+ listed here. You can find them using [chromiumBrowserContext.backgroundPages()]().
-#### method BrowserContext.route
-- `url` <[string]|[RegExp]|[function]\([URL]\):[boolean]> A glob pattern, regex pattern or predicate receiving [URL] to match while routing.
-- `handler` <[function]\([Route], [Request]\)> handler function to route the request.
+## method: BrowserContext.route
- returns: <[Promise]>
Routing provides the capability to modify network requests that are made by any page in the browser context. Once route
@@ -396,8 +439,17 @@ handlers.
> **NOTE** Enabling routing disables http cache.
-#### method BrowserContext.setDefaultNavigationTimeout
-- `timeout` <[number]> Maximum navigation time in milliseconds
+### param: BrowserContext.route.url
+- `url` <[string]|[RegExp]|[function]\([URL]\):[boolean]>
+
+A glob pattern, regex pattern or predicate receiving [URL] to match while routing.
+
+### param: BrowserContext.route.handler
+- `handler` <[function]\([Route], [Request]\)>
+
+handler function to route the request.
+
+## method: BrowserContext.setDefaultNavigationTimeout
This setting will change the default maximum navigation time for the following methods and related shortcuts:
* [page.goBack()]()
@@ -410,16 +462,24 @@ This setting will change the default maximum navigation time for the following m
> **NOTE** [page.setDefaultNavigationTimeout()]() and [page.setDefaultTimeout()]() take priority over
[browserContext.setDefaultNavigationTimeout()]().
-#### method BrowserContext.setDefaultTimeout
-- `timeout` <[number]> Maximum time in milliseconds
+### param: BrowserContext.setDefaultNavigationTimeout.timeout
+- `timeout` <[number]>
+
+Maximum navigation time in milliseconds
+
+## method: BrowserContext.setDefaultTimeout
This setting will change the default maximum time for all the methods accepting `timeout` option.
> **NOTE** [page.setDefaultNavigationTimeout()](), [page.setDefaultTimeout()]() and
[browserContext.setDefaultNavigationTimeout()]() take priority over [browserContext.setDefaultTimeout()]().
-#### method BrowserContext.setExtraHTTPHeaders
-- `headers` <[Object]<[string], [string]>> An object containing additional HTTP headers to be sent with every request. All header values must be strings.
+### param: BrowserContext.setDefaultTimeout.timeout
+- `timeout` <[number]>
+
+Maximum time in milliseconds
+
+## method: BrowserContext.setExtraHTTPHeaders
- returns: <[Promise]>
The extra HTTP headers will be sent with every request initiated by any page in the context. These headers are merged
@@ -428,11 +488,12 @@ page-specific header value will be used instead of the browser context header va
> **NOTE** `browserContext.setExtraHTTPHeaders` does not guarantee the order of headers in the outgoing requests.
-#### method BrowserContext.setGeolocation
-- `geolocation` <[null]|[Object]>
- - `latitude` <[number]> Latitude between -90 and 90. **required**
- - `longitude` <[number]> Longitude between -180 and 180. **required**
- - `accuracy` <[number]> Non-negative accuracy value. Defaults to `0`.
+### param: BrowserContext.setExtraHTTPHeaders.headers
+- `headers` <[Object]<[string], [string]>>
+
+An object containing additional HTTP headers to be sent with every request. All header values must be strings.
+
+## method: BrowserContext.setGeolocation
- returns: <[Promise]>
Sets the context's geolocation. Passing `null` or `undefined` emulates position unavailable.
@@ -444,10 +505,13 @@ await browserContext.setGeolocation({latitude: 59.95, longitude: 30.31667});
> **NOTE** Consider using [browserContext.grantPermissions()]() to grant permissions for the browser context pages to
read its geolocation.
-#### method BrowserContext.setHTTPCredentials
-- `httpCredentials` <[null]|[Object]>
- - `username` <[string]> **required**
- - `password` <[string]> **required**
+### param: BrowserContext.setGeolocation.geolocation
+- `geolocation` <[null]|[Object]>
+ - `latitude` <[number]> Latitude between -90 and 90. **required**
+ - `longitude` <[number]> Longitude between -180 and 180. **required**
+ - `accuracy` <[number]> Non-negative accuracy value. Defaults to `0`.
+
+## method: BrowserContext.setHTTPCredentials
- returns: <[Promise]>
Provide credentials for [HTTP authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication).
@@ -456,11 +520,20 @@ Provide credentials for [HTTP authentication](https://developer.mozilla.org/en-U
`null` to disable authentication will be unreliable. To remove or replace credentials, create a new browser context
instead.
-#### method BrowserContext.setOffline
-- `offline` <[boolean]> Whether to emulate network being offline for the browser context.
+### param: BrowserContext.setHTTPCredentials.httpCredentials
+- `httpCredentials` <[null]|[Object]>
+ - `username` <[string]> **required**
+ - `password` <[string]> **required**
+
+## method: BrowserContext.setOffline
- returns: <[Promise]>
-#### method BrowserContext.storageState
+### param: BrowserContext.setOffline.offline
+- `offline` <[boolean]>
+
+Whether to emulate network being offline for the browser context.
+
+## method: BrowserContext.storageState
- returns: <[Promise]<[Object]>>
- `cookies` <[Array]<[Object]>>
- `name` <[string]>
@@ -479,19 +552,23 @@ instead.
Returns storage state for this browser context, contains current cookies and local storage snapshot.
-#### method BrowserContext.unroute
-- `url` <[string]|[RegExp]|[function]\([URL]\):[boolean]> A glob pattern, regex pattern or predicate receiving [URL] used to register a routing with [browserContext.route()]().
-- `handler` <[function]\([Route], [Request]\)> Optional handler function used to register a routing with [browserContext.route()]().
+## method: BrowserContext.unroute
- returns: <[Promise]>
Removes a route created with [browserContext.route()](). When `handler` is not specified, removes all routes for the
`url`.
-#### method BrowserContext.waitForEvent
-- `event` <[string]> Event name, same one would pass into `browserContext.on(event)`.
-- `optionsOrPredicate` <[Function]|[Object]> Either a predicate that receives an event or an options object. Optional.
- - `predicate` <[Function]> receives the event data and resolves to truthy value when the waiting should resolve.
- - %%-wait-for-timeout-%%
+### param: BrowserContext.unroute.url
+- `url` <[string]|[RegExp]|[function]\([URL]\):[boolean]>
+
+A glob pattern, regex pattern or predicate receiving [URL] used to register a routing with [browserContext.route()]().
+
+### param: BrowserContext.unroute.handler
+- `handler` <[function]\([Route], [Request]\)>
+
+Optional handler function used to register a routing with [browserContext.route()]().
+
+## method: BrowserContext.waitForEvent
- returns: <[Promise]<[Object]>> Promise which resolves to the event data value.
Waits for event to fire and passes its value into the predicate function. Resolves when the predicate returns truthy
@@ -502,7 +579,21 @@ const context = await browser.newContext();
await context.grantPermissions(['geolocation']);
```
-### class: Page
+### param: BrowserContext.waitForEvent.event
+- `event` <[string]>
+
+Event name, same one would pass into `browserContext.on(event)`.
+
+### param: BrowserContext.waitForEvent.optionsOrPredicate
+- `optionsOrPredicate` <[Function]|[Object]>
+ - `predicate` <[Function]> receives the event data and resolves to truthy value when the waiting should resolve.
+ - `timeout` <[number]> maximum time to wait for in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable
+ timeout. The default value can be changed by using the
+ [browserContext.setDefaultTimeout(timeout)](#browsercontextsetdefaulttimeouttimeout).
+
+Either a predicate that receives an event or an options object. Optional.
+
+# class: Page
* extends: [EventEmitter](https://nodejs.org/api/events.html#events_class_eventemitter)
Page provides methods to interact with a single tab in a [Browser], or an [extension background
@@ -548,11 +639,11 @@ page.removeListener('request', logRequest);
-#### event Page.close
+## event: Page.close
Emitted when the page closes.
-#### event Page.console
+## event: Page.console
- <[ConsoleMessage]>
Emitted when JavaScript within the page calls one of console API methods, e.g. `console.log` or `console.dir`. Also
@@ -570,7 +661,7 @@ page.on('console', msg => {
page.evaluate(() => console.log('hello', 5, {foo: 'bar'}));
```
-#### event Page.crash
+## event: Page.crash
Emitted when the page crashes. Browser pages might crash if they try to allocate too much memory. When the page crashes,
ongoing and subsequent operations will throw.
@@ -601,18 +692,18 @@ await new Promise((resolve, reject) => {
});
```
-#### event Page.dialog
+## event: Page.dialog
- <[Dialog]>
Emitted when a JavaScript dialog appears, such as `alert`, `prompt`, `confirm` or `beforeunload`. Playwright can respond
to the dialog via [dialog.accept()]() or [dialog.dismiss()]() methods.
-#### event Page.domcontentloaded
+## event: Page.domcontentloaded
Emitted when the JavaScript [`DOMContentLoaded`](https://developer.mozilla.org/en-US/docs/Web/Events/DOMContentLoaded)
event is dispatched.
-#### event Page.download
+## event: Page.download
- <[Download]>
Emitted when attachment download started. User can access basic file operations on downloaded content via the passed
@@ -622,7 +713,7 @@ Emitted when attachment download started. User can access basic file operations
downloaded content. If `acceptDownloads` is not set or set to `false`, download events are emitted, but the actual
download is not performed and user has no access to the downloaded files.
-#### event Page.filechooser
+## event: Page.filechooser
- <[FileChooser]>
Emitted when a file chooser is supposed to appear, such as after clicking the ``. Playwright can
@@ -634,31 +725,31 @@ page.on('filechooser', async (fileChooser) => {
});
```
-#### event Page.frameattached
+## event: Page.frameattached
- <[Frame]>
Emitted when a frame is attached.
-#### event Page.framedetached
+## event: Page.framedetached
- <[Frame]>
Emitted when a frame is detached.
-#### event Page.framenavigated
+## event: Page.framenavigated
- <[Frame]>
Emitted when a frame is navigated to a new url.
-#### event Page.load
+## event: Page.load
Emitted when the JavaScript [`load`](https://developer.mozilla.org/en-US/docs/Web/Events/load) event is dispatched.
-#### event Page.pageerror
+## event: Page.pageerror
- <[Error]> The exception message
Emitted when an uncaught exception happens within the page.
-#### event Page.popup
+## event: Page.popup
- <[Page]> Page corresponding to "popup" window
Emitted when the page opens a new tab or window. This event is emitted in addition to the [browserContext.on('page')](),
@@ -679,13 +770,13 @@ console.log(await popup.evaluate('location.href'));
> **NOTE** Use [page.waitForLoadState()]() to wait until the page gets to a particular state (you should not need it in
most cases).
-#### event Page.request
+## event: Page.request
- <[Request]>
Emitted when a page issues a request. The [request] object is read-only. In order to intercept and mutate requests, see
[page.route()]() or [browserContext.route()]().
-#### event Page.requestfailed
+## event: Page.requestfailed
- <[Request]>
Emitted when a request fails, for example by timing out.
@@ -693,31 +784,30 @@ Emitted when a request fails, for example by timing out.
> **NOTE** HTTP Error responses, such as 404 or 503, are still successful responses from HTTP standpoint, so request
will complete with [page.on('requestfinished')]() event and not with [page.on('requestfailed')]().
-#### event Page.requestfinished
+## event: Page.requestfinished
- <[Request]>
Emitted when a request finishes successfully after downloading the response body. For a successful response, the
sequence of events is `request`, `response` and `requestfinished`.
-#### event Page.response
+## event: Page.response
- <[Response]>
Emitted when [response] status and headers are received for a request. For a successful response, the sequence of events
is `request`, `response` and `requestfinished`.
-#### event Page.websocket
+## event: Page.websocket
- <[WebSocket]> websocket
Emitted when <[WebSocket]> request is sent.
-#### event Page.worker
+## event: Page.worker
- <[Worker]>
Emitted when a dedicated [WebWorker](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API) is spawned by the
page.
-#### method Page.$
-- %%-query-selector-%%
+## method: Page.$
- returns: <[Promise]<[null]|[ElementHandle]>>
The method finds an element matching the specified selector within the page. If no elements match the selector, the
@@ -725,8 +815,9 @@ return value resolves to `null`.
Shortcut for main frame's [frame.$()]().
-#### method Page.$$
-- %%-query-selector-%%
+### param: Page.$.selector = %%-query-selector-%%
+
+## method: Page.$$
- returns: <[Promise]<[Array]<[ElementHandle]>>>
The method finds all elements matching the specified selector within the page. If no elements match the selector, the
@@ -734,10 +825,9 @@ return value resolves to `[]`.
Shortcut for main frame's [frame.$$()]().
-#### method Page.$eval
-- %%-query-selector-%%
-- `pageFunction` <[function]\([Element]\)> Function to be evaluated in browser context
-- `arg` <[EvaluationArgument]> Optional argument to pass to `pageFunction`
+### param: Page.$$.selector = %%-query-selector-%%
+
+## method: Page.$eval
- returns: <[Promise]<[Serializable]>> Promise which resolves to the return value of `pageFunction`
The method finds an element matching the specified selector within the page and passes it as a first argument to
@@ -755,10 +845,19 @@ const html = await page.$eval('.main-container', (e, suffix) => e.outerHTML + su
Shortcut for main frame's [frame.$eval()]().
-#### method Page.$$eval
-- %%-query-selector-%%
-- `pageFunction` <[function]\([Array]<[Element]>\)> Function to be evaluated in browser context
-- `arg` <[EvaluationArgument]> Optional argument to pass to `pageFunction`
+### param: Page.$eval.selector = %%-query-selector-%%
+
+### param: Page.$eval.pageFunction
+- `pageFunction` <[function]\([Element]\)>
+
+Function to be evaluated in browser context
+
+### param: Page.$eval.arg
+- `arg` <[EvaluationArgument]>
+
+Optional argument to pass to `pageFunction`
+
+## method: Page.$$eval
- returns: <[Promise]<[Serializable]>> Promise which resolves to the return value of `pageFunction`
The method finds all elements matching the specified selector within the page and passes an array of matched elements as
@@ -772,19 +871,28 @@ Examples:
const divsCounts = await page.$$eval('div', (divs, min) => divs.length >= min, 10);
```
-#### namespace Page.accessibility
+### param: Page.$$eval.selector = %%-query-selector-%%
+
+### param: Page.$$eval.pageFunction
+- `pageFunction` <[function]\([Array]<[Element]>\)>
+
+Function to be evaluated in browser context
+
+### param: Page.$$eval.arg
+- `arg` <[EvaluationArgument]>
+
+Optional argument to pass to `pageFunction`
+
+## namespace: Page.accessibility
- returns: <[Accessibility]>
-#### method Page.addInitScript
-- `script` <[function]|[string]|[Object]> Script to be evaluated in the page.
- - `path` <[string]> Path to the JavaScript file. If `path` is a relative path, then it is resolved relative to [current working directory](https://nodejs.org/api/process.html#process_process_cwd).
- - `content` <[string]> Raw script content.
-- `arg` <[Serializable]> Optional argument to pass to `script` (only supported when passing a function).
+## method: Page.addInitScript
- returns: <[Promise]>
Adds a script which would be evaluated in one of the following scenarios:
* Whenever the page is navigated.
-* Whenever the child frame is attached or navigated. In this case, the script is evaluated in the context of the newly attached frame.
+* Whenever the child frame is attached or navigated. In this case, the script is evaluated in the context of the newly
+ attached frame.
The script is evaluated after the document was created but before any of its scripts were run. This is useful to amend
the JavaScript environment, e.g. to seed `Math.random`.
@@ -803,47 +911,66 @@ await page.addInitScript(preloadFile);
> **NOTE** The order of evaluation of multiple scripts installed via [browserContext.addInitScript()]() and
[page.addInitScript()]() is not defined.
-#### method Page.addScriptTag
-- `script` <[Object]>
- - `url` <[string]> URL of a script to be added.
- - `path` <[string]> Path to the JavaScript file to be injected into frame. If `path` is a relative path, then it is resolved relative to [current working directory](https://nodejs.org/api/process.html#process_process_cwd).
- - `content` <[string]> Raw JavaScript content to be injected into frame.
- - `type` <[string]> Script type. Use 'module' in order to load a Javascript ES6 module. See [script](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script) for more details.
-- returns: <[Promise]<[ElementHandle]>> which resolves to the added tag when the script's onload fires or when the script content was injected into frame.
+### param: Page.addInitScript.script
+- `script` <[function]|[string]|[Object]>
+ - `path` <[string]> Path to the JavaScript file. If `path` is a relative path, then it is resolved relative to
+ [current working directory](https://nodejs.org/api/process.html#process_process_cwd).
+ - `content` <[string]> Raw script content.
+
+Script to be evaluated in the page.
+
+### param: Page.addInitScript.arg
+- `arg` <[Serializable]>
+
+Optional argument to pass to `script` (only supported when passing a function).
+
+## method: Page.addScriptTag
+- returns: <[Promise]<[ElementHandle]>> which resolves to the added tag when the script's onload fires or when the
+ script content was injected into frame.
Adds a `