diff --git a/.release-please-manifest.json b/.release-please-manifest.json index a5c0526bed5..81a41a65663 100644 --- a/.release-please-manifest.json +++ b/.release-please-manifest.json @@ -1,3 +1,3 @@ { - ".": "16.1.0" + ".": "16.1.1" } diff --git a/CHANGELOG.md b/CHANGELOG.md index e25ce083c5a..09e10a02f0b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,20 @@ All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines. +## [16.1.1](https://github.com/puppeteer/puppeteer/compare/v16.1.0...v16.1.1) (2022-08-16) + + +### Bug Fixes + +* custom sessions should not emit targetcreated events ([#8788](https://github.com/puppeteer/puppeteer/issues/8788)) ([3fad05d](https://github.com/puppeteer/puppeteer/commit/3fad05d333b79f41a7b58582c4ca493200bb5a79)), closes [#8787](https://github.com/puppeteer/puppeteer/issues/8787) +* deprecate `ExecutionContext` ([#8792](https://github.com/puppeteer/puppeteer/issues/8792)) ([b5da718](https://github.com/puppeteer/puppeteer/commit/b5da718e2e4a2004a36cf23cad555e1fc3b50333)) +* deprecate `root` in `WaitForSelectorOptions` ([#8795](https://github.com/puppeteer/puppeteer/issues/8795)) ([65a5ce8](https://github.com/puppeteer/puppeteer/commit/65a5ce8464c56fcc55e5ac3ed490f31311bbe32a)) +* deprecate `waitForTimeout` ([#8793](https://github.com/puppeteer/puppeteer/issues/8793)) ([8f612d5](https://github.com/puppeteer/puppeteer/commit/8f612d5ff855d48ae4b38bdaacf2a8fbda8e9ce8)) +* make sure there is a check for targets when timeout=0 ([#8765](https://github.com/puppeteer/puppeteer/issues/8765)) ([c23cdb7](https://github.com/puppeteer/puppeteer/commit/c23cdb73a7b113c1dd29f7e4a7a61326422c4080)), closes [#8763](https://github.com/puppeteer/puppeteer/issues/8763) +* resolve navigation flakiness ([#8768](https://github.com/puppeteer/puppeteer/issues/8768)) ([2580347](https://github.com/puppeteer/puppeteer/commit/2580347b50091d172b2a5591138a2e41ede072fe)), closes [#8644](https://github.com/puppeteer/puppeteer/issues/8644) +* specify Puppeteer version for Chromium 105.0.5173.0 ([#8766](https://github.com/puppeteer/puppeteer/issues/8766)) ([b5064b7](https://github.com/puppeteer/puppeteer/commit/b5064b7b8bd3bd9eb481b6807c65d9d06d23b9dd)) +* use targetFilter in puppeteer.launch ([#8774](https://github.com/puppeteer/puppeteer/issues/8774)) ([ee2540b](https://github.com/puppeteer/puppeteer/commit/ee2540baefeced44f6b336f2b979af5c3a4cb040)), closes [#8772](https://github.com/puppeteer/puppeteer/issues/8772) + ## [16.1.0](https://github.com/puppeteer/puppeteer/compare/v16.0.0...v16.1.0) (2022-08-06) diff --git a/package-lock.json b/package-lock.json index 8f1320d7199..1bb30341d34 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "puppeteer", - "version": "16.1.0", + "version": "16.1.1", "lockfileVersion": 2, "requires": true, "packages": { "": { "name": "puppeteer", - "version": "16.1.0", + "version": "16.1.1", "hasInstallScript": true, "license": "Apache-2.0", "dependencies": { diff --git a/package.json b/package.json index 149d2836969..ba862a62d16 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "puppeteer", - "version": "16.1.0", + "version": "16.1.1", "description": "A high-level API to control headless Chrome over the DevTools Protocol", "keywords": [ "puppeteer", diff --git a/src/generated/version.ts b/src/generated/version.ts index de9ae093d71..938769692d3 100644 --- a/src/generated/version.ts +++ b/src/generated/version.ts @@ -1,4 +1,4 @@ /** * @internal */ -export const packageVersion = '16.1.0'; +export const packageVersion = '16.1.1'; diff --git a/versions.js b/versions.js index b372ed7b468..7a07926b3ae 100644 --- a/versions.js +++ b/versions.js @@ -16,7 +16,7 @@ const versionsPerRelease = new Map([ // This is a mapping from Chromium version => Puppeteer version. - // In Chromium roll patches, use 'NEXT' for the Puppeteer version. + // In Chromium roll patches, use 'v16.1.1' for the Puppeteer version. ['105.0.5173.0', 'v15.5.0'], ['104.0.5109.0', 'v15.1.0'], ['103.0.5059.0', 'v14.2.0'], diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.connect.md b/website/versioned_docs/version-16.1.0/api/puppeteer.connect.md deleted file mode 100644 index 9201297ab5c..00000000000 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.connect.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -sidebar_label: connect ---- - -# connect variable - -**Signature:** - -```typescript -connect: (options: import("./types.js").ConnectOptions) => Promise -``` diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.__eval.md b/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.__eval.md deleted file mode 100644 index 837be87b467..00000000000 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.__eval.md +++ /dev/null @@ -1,57 +0,0 @@ ---- -sidebar_label: ElementHandle.$$eval ---- - -# ElementHandle.$$eval() method - -This method runs `document.querySelectorAll` within the element and passes it as the first argument to `pageFunction`. If there's no element matching `selector`, the method throws an error. - -If `pageFunction` returns a Promise, then `frame.$$eval` would wait for the promise to resolve and return its value. - -**Signature:** - -```typescript -class ElementHandle { - $$eval< - Selector extends string, - Params extends unknown[], - Func extends EvaluateFunc< - [Array>, ...Params] - > = EvaluateFunc<[Array>, ...Params]> - >( - selector: Selector, - pageFunction: Func | string, - ...args: Params - ): Promise>>; -} -``` - -## Parameters - -| Parameter | Type | Description | -| ------------ | -------------- | ----------- | -| selector | Selector | | -| pageFunction | Func \| string | | -| args | Params | | - -**Returns:** - -Promise<Awaited<ReturnType<Func>>> - -## Example 1 - -```html -
-
Hello!
-
Hi!
-
-``` - -## Example 2 - -```ts -const feedHandle = await page.$('.feed'); -expect( - await feedHandle.$$eval('.tweet', nodes => nodes.map(n => n.innerText)) -).toEqual(['Hello!', 'Hi!']); -``` diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle._eval.md b/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle._eval.md deleted file mode 100644 index f67319183bb..00000000000 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle._eval.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -sidebar_label: ElementHandle.$eval ---- - -# ElementHandle.$eval() method - -This method runs `document.querySelector` within the element and passes it as the first argument to `pageFunction`. If there's no element matching `selector`, the method throws an error. - -If `pageFunction` returns a Promise, then `frame.$eval` would wait for the promise to resolve and return its value. - -**Signature:** - -```typescript -class ElementHandle { - $eval< - Selector extends string, - Params extends unknown[], - Func extends EvaluateFunc< - [ElementHandle>, ...Params] - > = EvaluateFunc<[ElementHandle>, ...Params]> - >( - selector: Selector, - pageFunction: Func | string, - ...args: Params - ): Promise>>; -} -``` - -## Parameters - -| Parameter | Type | Description | -| ------------ | -------------- | ----------- | -| selector | Selector | | -| pageFunction | Func \| string | | -| args | Params | | - -**Returns:** - -Promise<Awaited<ReturnType<Func>>> - -## Example - -```ts -const tweetHandle = await page.$('.tweet'); -expect(await tweetHandle.$eval('.like', node => node.innerText)).toBe('100'); -expect(await tweetHandle.$eval('.retweets', node => node.innerText)).toBe('10'); -``` diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.waitforselector.md b/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.waitforselector.md deleted file mode 100644 index 22617c4b184..00000000000 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.waitforselector.md +++ /dev/null @@ -1,43 +0,0 @@ ---- -sidebar_label: ElementHandle.waitForSelector ---- - -# ElementHandle.waitForSelector() method - -Wait for the `selector` to appear within the element. If at the moment of calling the method the `selector` already exists, the method will return immediately. If the `selector` doesn't appear after the `timeout` milliseconds of waiting, the function will throw. - -This method does not work across navigations or if the element is detached from DOM. - -**Signature:** - -```typescript -class ElementHandle { - waitForSelector( - selector: Selector, - options?: Exclude - ): Promise> | null>; -} -``` - -## Parameters - -| Parameter | Type | Description | -| --------- | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | -| selector | Selector | A [selector](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors) of an element to wait for | -| options | Exclude<[WaitForSelectorOptions](./puppeteer.waitforselectoroptions.md), 'root'> | (Optional) Optional waiting parameters | - -**Returns:** - -Promise<[ElementHandle](./puppeteer.elementhandle.md)<[NodeFor](./puppeteer.nodefor.md)<Selector>> \| null> - -Promise which resolves when element specified by selector string is added to DOM. Resolves to `null` if waiting for hidden: `true` and selector is not found in DOM. - -## Remarks - -The optional parameters in `options` are: - -- `visible`: wait for the selected element to be present in DOM and to be visible, i.e. to not have `display: none` or `visibility: hidden` CSS properties. Defaults to `false`. - -- `hidden`: wait for the selected element to not be found in the DOM or to be hidden, i.e. have `display: none` or `visibility: hidden` CSS properties. Defaults to `false`. - -- `timeout`: maximum time to wait in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout. The default value can be changed by using the [Page.setDefaultTimeout()](./puppeteer.page.setdefaulttimeout.md) method. diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.executioncontext.evaluatehandle.md b/website/versioned_docs/version-16.1.0/api/puppeteer.executioncontext.evaluatehandle.md deleted file mode 100644 index 103b8d7e1ff..00000000000 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.executioncontext.evaluatehandle.md +++ /dev/null @@ -1,65 +0,0 @@ ---- -sidebar_label: ExecutionContext.evaluateHandle ---- - -# ExecutionContext.evaluateHandle() method - -**Signature:** - -```typescript -class ExecutionContext { - evaluateHandle< - Params extends unknown[], - Func extends EvaluateFunc = EvaluateFunc - >( - pageFunction: Func | string, - ...args: Params - ): Promise>>>; -} -``` - -## Parameters - -| Parameter | Type | Description | -| ------------ | -------------- | --------------------------------------------------------------- | -| pageFunction | Func \| string | a function to be evaluated in the executionContext | -| args | Params | argument to pass to the page function | - -**Returns:** - -Promise<[HandleFor](./puppeteer.handlefor.md)<Awaited<ReturnType<Func>>>> - -A promise that resolves to the return value of the given function as an in-page object (a [JSHandle](./puppeteer.jshandle.md)). - -## Remarks - -The only difference between `executionContext.evaluate` and `executionContext.evaluateHandle` is that `executionContext.evaluateHandle` returns an in-page object (a [JSHandle](./puppeteer.jshandle.md)). If the function passed to the `executionContext.evaluateHandle` returns a Promise, then `executionContext.evaluateHandle` would wait for the promise to resolve and return its value. - -## Example 1 - -```ts -const context = await page.mainFrame().executionContext(); -const aHandle = await context.evaluateHandle(() => Promise.resolve(self)); -aHandle; // Handle for the global object. -``` - -## Example 2 - -A string can also be passed in instead of a function. - -```ts -// Handle for the '3' * object. -const aHandle = await context.evaluateHandle('1 + 2'); -``` - -## Example 3 - -JSHandle instances can be passed as arguments to the `executionContext.* evaluateHandle`: - -```ts -const aHandle = await context.evaluateHandle(() => document.body); -const resultHandle = await context.evaluateHandle(body => body.innerHTML, * aHandle); -console.log(await resultHandle.jsonValue()); // prints body's innerHTML -await aHandle.dispose(); -await resultHandle.dispose(); -``` diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.executioncontext.md b/website/versioned_docs/version-16.1.0/api/puppeteer.executioncontext.md deleted file mode 100644 index a0e5999b0d7..00000000000 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.executioncontext.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -sidebar_label: ExecutionContext ---- - -# ExecutionContext class - -This class represents a context for JavaScript execution. A \[Page\] might have many execution contexts: - each [frame](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe) has "default" execution context that is always created after frame is attached to DOM. This context is returned by the [Frame.executionContext()](./puppeteer.frame.executioncontext.md) method. - [Extension](https://developer.chrome.com/extensions)'s content scripts create additional execution contexts. - -Besides pages, execution contexts can be found in [workers](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API). - -**Signature:** - -```typescript -export declare class ExecutionContext -``` - -## Remarks - -The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `ExecutionContext` class. - -## Methods - -| Method | Modifiers | Description | -| ------------------------------------------------------------------------------------ | --------- | -------------------------------------------------------------------------------------------- | -| [evaluate(pageFunction, args)](./puppeteer.executioncontext.evaluate.md) | | | -| [evaluateHandle(pageFunction, args)](./puppeteer.executioncontext.evaluatehandle.md) | | | -| [frame()](./puppeteer.executioncontext.frame.md) | | | -| [queryObjects(prototypeHandle)](./puppeteer.executioncontext.queryobjects.md) | | This method iterates the JavaScript heap and finds all the objects with the given prototype. | diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.__eval.md b/website/versioned_docs/version-16.1.0/api/puppeteer.frame.__eval.md deleted file mode 100644 index 6db54e4ed69..00000000000 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.__eval.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -sidebar_label: Frame.$$eval ---- - -# Frame.$$eval() method - -**Signature:** - -```typescript -class Frame { - $$eval< - Selector extends string, - Params extends unknown[], - Func extends EvaluateFunc< - [Array>, ...Params] - > = EvaluateFunc<[Array>, ...Params]> - >( - selector: Selector, - pageFunction: Func | string, - ...args: Params - ): Promise>>; -} -``` - -## Parameters - -| Parameter | Type | Description | -| ------------ | -------------- | --------------------------------------------------------- | -| selector | Selector | the selector to query for | -| pageFunction | Func \| string | the function to be evaluated in the frame's context | -| args | Params | additional arguments to pass to pageFunction | - -**Returns:** - -Promise<Awaited<ReturnType<Func>>> - -## Remarks - -This method runs `Array.from(document.querySelectorAll(selector))` within the frame and passes it as the first argument to `pageFunction`. - -If `pageFunction` returns a Promise, then `frame.$$eval` would wait for the promise to resolve and return its value. - -## Example - -```ts -const divsCounts = await frame.$$eval('div', divs => divs.length); -``` diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.frame._eval.md b/website/versioned_docs/version-16.1.0/api/puppeteer.frame._eval.md deleted file mode 100644 index 28ead092bb7..00000000000 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.frame._eval.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -sidebar_label: Frame.$eval ---- - -# Frame.$eval() method - -**Signature:** - -```typescript -class Frame { - $eval< - Selector extends string, - Params extends unknown[], - Func extends EvaluateFunc< - [ElementHandle>, ...Params] - > = EvaluateFunc<[ElementHandle>, ...Params]> - >( - selector: Selector, - pageFunction: Func | string, - ...args: Params - ): Promise>>; -} -``` - -## Parameters - -| Parameter | Type | Description | -| ------------ | -------------- | --------------------------------------------------------- | -| selector | Selector | the selector to query for | -| pageFunction | Func \| string | the function to be evaluated in the frame's context | -| args | Params | additional arguments to pass to pageFunction | - -**Returns:** - -Promise<Awaited<ReturnType<Func>>> - -## Remarks - -This method runs `document.querySelector` within the frame and passes it as the first argument to `pageFunction`. - -If `pageFunction` returns a Promise, then `frame.$eval` would wait for the promise to resolve and return its value. - -## Example - -```ts -const searchValue = await frame.$eval('#search', el => el.value); -``` diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.click.md b/website/versioned_docs/version-16.1.0/api/puppeteer.frame.click.md deleted file mode 100644 index fe3a8f06a80..00000000000 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.click.md +++ /dev/null @@ -1,46 +0,0 @@ ---- -sidebar_label: Frame.click ---- - -# Frame.click() method - -This method clicks the first element found that matches `selector`. - -**Signature:** - -```typescript -class Frame { - click( - selector: string, - options?: { - delay?: number; - button?: MouseButton; - clickCount?: number; - } - ): Promise; -} -``` - -## Parameters - -| Parameter | Type | Description | -| --------- | -------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | -| selector | string | the selector to search for to click. If there are multiple elements, the first will be clicked. | -| options | { delay?: number; button?: [MouseButton](./puppeteer.mousebutton.md); clickCount?: number; } | (Optional) | - -**Returns:** - -Promise<void> - -## Remarks - -This method scrolls the element into view if needed, and then uses [Page.mouse](./puppeteer.page.mouse.md) to click in the center of the element. If there's no element matching `selector`, the method throws an error. - -Bear in mind that if `click()` triggers a navigation event and there's a separate `page.waitForNavigation()` promise to be resolved, you may end up with a race condition that yields unexpected results. The correct pattern for click and wait for navigation is the following: - -```javascript -const [response] = await Promise.all([ - page.waitForNavigation(waitOptions), - frame.click(selector, clickOptions), -]); -``` diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.evaluate.md b/website/versioned_docs/version-16.1.0/api/puppeteer.frame.evaluate.md deleted file mode 100644 index 5e72e6e7ae1..00000000000 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.evaluate.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -sidebar_label: Frame.evaluate ---- - -# Frame.evaluate() method - -**Signature:** - -```typescript -class Frame { - evaluate< - Params extends unknown[], - Func extends EvaluateFunc = EvaluateFunc - >( - pageFunction: Func | string, - ...args: Params - ): Promise>>; -} -``` - -## Parameters - -| Parameter | Type | Description | -| ------------ | -------------- | ------------------------------------------ | -| pageFunction | Func \| string | a function that is run within the frame | -| args | Params | arguments to be passed to the pageFunction | - -**Returns:** - -Promise<Awaited<ReturnType<Func>>> - -## Remarks - -This method behaves identically to [Page.evaluate()](./puppeteer.page.evaluate.md) except it's run within the context of the `frame`, rather than the entire page. diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.evaluatehandle.md b/website/versioned_docs/version-16.1.0/api/puppeteer.frame.evaluatehandle.md deleted file mode 100644 index 2b4df04fdd3..00000000000 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.evaluatehandle.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -sidebar_label: Frame.evaluateHandle ---- - -# Frame.evaluateHandle() method - -**Signature:** - -```typescript -class Frame { - evaluateHandle< - Params extends unknown[], - Func extends EvaluateFunc = EvaluateFunc - >( - pageFunction: Func | string, - ...args: Params - ): Promise>>>; -} -``` - -## Parameters - -| Parameter | Type | Description | -| ------------ | -------------- | ------------------------------------------ | -| pageFunction | Func \| string | a function that is run within the frame | -| args | Params | arguments to be passed to the pageFunction | - -**Returns:** - -Promise<[HandleFor](./puppeteer.handlefor.md)<Awaited<ReturnType<Func>>>> - -## Remarks - -The only difference between [Frame.evaluate()](./puppeteer.frame.evaluate.md) and `frame.evaluateHandle` is that `evaluateHandle` will return the value wrapped in an in-page object. - -This method behaves identically to [Page.evaluateHandle()](./puppeteer.page.evaluatehandle.md) except it's run within the context of the `frame`, rather than the entire page. diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.focus.md b/website/versioned_docs/version-16.1.0/api/puppeteer.frame.focus.md deleted file mode 100644 index 9872157d009..00000000000 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.focus.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -sidebar_label: Frame.focus ---- - -# Frame.focus() method - -This method fetches an element with `selector` and focuses it. - -**Signature:** - -```typescript -class Frame { - focus(selector: string): Promise; -} -``` - -## Parameters - -| Parameter | Type | Description | -| --------- | ------ | ------------------------------------------------------------------------------------------------- | -| selector | string | the selector for the element to focus. If there are multiple elements, the first will be focused. | - -**Returns:** - -Promise<void> - -## Remarks - -If there's no element matching `selector`, the method throws an error. diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.hover.md b/website/versioned_docs/version-16.1.0/api/puppeteer.frame.hover.md deleted file mode 100644 index 6555d28991d..00000000000 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.hover.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -sidebar_label: Frame.hover ---- - -# Frame.hover() method - -This method fetches an element with `selector`, scrolls it into view if needed, and then uses [Page.mouse](./puppeteer.page.mouse.md) to hover over the center of the element. - -**Signature:** - -```typescript -class Frame { - hover(selector: string): Promise; -} -``` - -## Parameters - -| Parameter | Type | Description | -| --------- | ------ | ------------------------------------------------------------------------------------------------- | -| selector | string | the selector for the element to hover. If there are multiple elements, the first will be hovered. | - -**Returns:** - -Promise<void> - -## Remarks - -If there's no element matching `selector`, the method throws an diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.name.md b/website/versioned_docs/version-16.1.0/api/puppeteer.frame.name.md deleted file mode 100644 index cb6e657d39c..00000000000 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.name.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -sidebar_label: Frame.name ---- - -# Frame.name() method - -**Signature:** - -```typescript -class Frame { - name(): string; -} -``` - -**Returns:** - -string - -the frame's `name` attribute as specified in the tag. - -## Remarks - -If the name is empty, it returns the `id` attribute instead. - -Note: This value is calculated once when the frame is created, and will not update if the attribute is changed later. diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.tap.md b/website/versioned_docs/version-16.1.0/api/puppeteer.frame.tap.md deleted file mode 100644 index 30cf13faa6f..00000000000 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.tap.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -sidebar_label: Frame.tap ---- - -# Frame.tap() method - -This method fetches an element with `selector`, scrolls it into view if needed, and then uses [Page.touchscreen](./puppeteer.page.touchscreen.md) to tap in the center of the element. - -**Signature:** - -```typescript -class Frame { - tap(selector: string): Promise; -} -``` - -## Parameters - -| Parameter | Type | Description | -| --------- | ------ | -------------------- | -| selector | string | the selector to tap. | - -**Returns:** - -Promise<void> - -a promise that resolves when the element has been tapped. - -## Remarks - -If there's no element matching `selector`, the method throws an error. diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.jshandle.jsonvalue.md b/website/versioned_docs/version-16.1.0/api/puppeteer.jshandle.jsonvalue.md deleted file mode 100644 index 8c0feedc781..00000000000 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.jshandle.jsonvalue.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -sidebar_label: JSHandle.jsonValue ---- - -# JSHandle.jsonValue() method - -**Signature:** - -```typescript -class JSHandle { - jsonValue(): Promise; -} -``` - -**Returns:** - -Promise<T> - -Returns a JSON representation of the object.If the object has a `toJSON` function, it will not be called. - -## Remarks - -The JSON is generated by running [JSON.stringify](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify) on the object in page and consequent [JSON.parse](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/parse) in puppeteer. \*\*NOTE\*\* The method throws if the referenced object is not stringifiable. diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.jshandle.md b/website/versioned_docs/version-16.1.0/api/puppeteer.jshandle.md deleted file mode 100644 index c207f2c9b70..00000000000 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.jshandle.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -sidebar_label: JSHandle ---- - -# JSHandle class - -Represents an in-page JavaScript object. JSHandles can be created with the [page.evaluateHandle](./puppeteer.page.evaluatehandle.md) method. - -**Signature:** - -```typescript -export declare class JSHandle -``` - -## Remarks - -The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `JSHandle` class. - -## Example - -```ts -const windowHandle = await page.evaluateHandle(() => window); -``` - -JSHandle prevents the referenced JavaScript object from being garbage-collected unless the handle is [disposed](./puppeteer.jshandle.dispose.md). JSHandles are auto- disposed when their origin frame gets navigated or the parent context gets destroyed. - -JSHandle instances can be used as arguments for [Page.$eval()](./puppeteer.page._eval.md), [Page.evaluate()](./puppeteer.page.evaluate.md), and [Page.evaluateHandle()](./puppeteer.page.evaluatehandle.md). - -## Properties - -| Property | Modifiers | Type | Description | -| --------------------------------------------------------------------- | --------- | ---- | -------------------------------------------------------------------------------- | -| [\[\_\_JSHandleSymbol\]?](./puppeteer.jshandle.___jshandlesymbol_.md) | | T | (Optional) Used for nominally typing [JSHandle](./puppeteer.jshandle.md). | - -## Methods - -| Method | Modifiers | Description | -| ---------------------------------------------------------------------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [asElement()](./puppeteer.jshandle.aselement.md) | | | -| [dispose()](./puppeteer.jshandle.dispose.md) | | Stops referencing the element handle, and resolves when the object handle is successfully disposed of. | -| [evaluate(pageFunction, args)](./puppeteer.jshandle.evaluate.md) | | This method passes this handle as the first argument to pageFunction. If pageFunction returns a Promise, then handle.evaluate would wait for the promise to resolve and return its value. | -| [evaluateHandle(pageFunction, args)](./puppeteer.jshandle.evaluatehandle.md) | | This method passes this handle as the first argument to pageFunction. | -| [executionContext()](./puppeteer.jshandle.executioncontext.md) | | Returns the execution context the handle belongs to. | -| [getProperties()](./puppeteer.jshandle.getproperties.md) | | The method returns a map with property names as keys and JSHandle instances for the property values. | -| [getProperty(propertyName)](./puppeteer.jshandle.getproperty.md) | | Fetches a single property from the referenced object. | -| [getProperty(propertyName)](./puppeteer.jshandle.getproperty_1.md) | | | -| [jsonValue()](./puppeteer.jshandle.jsonvalue.md) | | | -| [remoteObject()](./puppeteer.jshandle.remoteobject.md) | | Provides access to \[Protocol.Runtime.RemoteObject\](https://chromedevtools.github.io/devtools-protocol/tot/Runtime/\#type-RemoteObject) backing this JSHandle. | -| [toString()](./puppeteer.jshandle.tostring.md) | | Returns a string representation of the JSHandle. | diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.launch.md b/website/versioned_docs/version-16.1.0/api/puppeteer.launch.md deleted file mode 100644 index 0124b8f4760..00000000000 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.launch.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -sidebar_label: launch ---- - -# launch variable - -**Signature:** - -```typescript -launch: (options?: import("./types.js").PuppeteerLaunchOptions) => Promise -``` diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.waitforselectoroptions.md b/website/versioned_docs/version-16.1.0/api/puppeteer.waitforselectoroptions.md deleted file mode 100644 index 26613cbf5f8..00000000000 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.waitforselectoroptions.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -sidebar_label: WaitForSelectorOptions ---- - -# WaitForSelectorOptions interface - -**Signature:** - -```typescript -export interface WaitForSelectorOptions -``` - -## Properties - -| Property | Modifiers | Type | Description | -| --------------------------------------------------------- | --------- | --------------------------------------------------------- | ----------------- | -| [hidden?](./puppeteer.waitforselectoroptions.hidden.md) | | boolean | (Optional) | -| [root?](./puppeteer.waitforselectoroptions.root.md) | | [ElementHandle](./puppeteer.elementhandle.md)<Node> | (Optional) | -| [timeout?](./puppeteer.waitforselectoroptions.timeout.md) | | number | (Optional) | -| [visible?](./puppeteer.waitforselectoroptions.visible.md) | | boolean | (Optional) | diff --git a/website/versioned_docs/version-16.1.0/api/index.md b/website/versioned_docs/version-16.1.1/api/index.md similarity index 90% rename from website/versioned_docs/version-16.1.0/api/index.md rename to website/versioned_docs/version-16.1.1/api/index.md index af448142dae..8a4e32d92b3 100644 --- a/website/versioned_docs/version-16.1.0/api/index.md +++ b/website/versioned_docs/version-16.1.1/api/index.md @@ -6,40 +6,40 @@ sidebar_label: API ## Classes -| Class | Description | -| --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [Accessibility](./puppeteer.accessibility.md) | The Accessibility class provides methods for inspecting Chromium's accessibility tree. The accessibility tree is used by assistive technology such as [screen readers](https://en.wikipedia.org/wiki/Screen_reader) or [switches](https://en.wikipedia.org/wiki/Switch_access). | -| [Browser](./puppeteer.browser.md) | A Browser is created when Puppeteer connects to a Chromium instance, either through [PuppeteerNode.launch()](./puppeteer.puppeteernode.launch.md) or [Puppeteer.connect()](./puppeteer.puppeteer.connect.md). | -| [BrowserContext](./puppeteer.browsercontext.md) | BrowserContexts provide a way to operate multiple independent browser sessions. When a browser is launched, it has a single BrowserContext used by default. The method [Browser.newPage](./puppeteer.browser.newpage.md) creates a page in the default browser context. | -| [BrowserFetcher](./puppeteer.browserfetcher.md) | BrowserFetcher can download and manage different versions of Chromium and Firefox. | -| [CDPSession](./puppeteer.cdpsession.md) | The CDPSession instances are used to talk raw Chrome Devtools Protocol. | -| [Connection](./puppeteer.connection.md) | | -| [ConsoleMessage](./puppeteer.consolemessage.md) | ConsoleMessage objects are dispatched by page via the 'console' event. | -| [Coverage](./puppeteer.coverage.md) | The Coverage class provides methods to gathers information about parts of JavaScript and CSS that were used by the page. | -| [CSSCoverage](./puppeteer.csscoverage.md) | | -| [CustomError](./puppeteer.customerror.md) | | -| [Dialog](./puppeteer.dialog.md) | Dialog instances are dispatched by the [Page](./puppeteer.page.md) via the dialog event. | -| [ElementHandle](./puppeteer.elementhandle.md) | ElementHandle represents an in-page DOM element. | -| [EventEmitter](./puppeteer.eventemitter.md) | The EventEmitter class that many Puppeteer classes extend. | -| [ExecutionContext](./puppeteer.executioncontext.md) |

This class represents a context for JavaScript execution. A \[Page\] might have many execution contexts: - each [frame](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe) has "default" execution context that is always created after frame is attached to DOM. This context is returned by the [Frame.executionContext()](./puppeteer.frame.executioncontext.md) method. - [Extension](https://developer.chrome.com/extensions)'s content scripts create additional execution contexts.

Besides pages, execution contexts can be found in [workers](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API).

| -| [FileChooser](./puppeteer.filechooser.md) | File choosers let you react to the page requesting for a file. | -| [Frame](./puppeteer.frame.md) | At every point of time, page exposes its current frame tree via the [page.mainFrame](./puppeteer.page.mainframe.md) and [frame.childFrames](./puppeteer.frame.childframes.md) methods. | -| [HTTPRequest](./puppeteer.httprequest.md) | Represents an HTTP request sent by a page. | -| [HTTPResponse](./puppeteer.httpresponse.md) | The HTTPResponse class represents responses which are received by the [Page](./puppeteer.page.md) class. | -| [JSCoverage](./puppeteer.jscoverage.md) | | -| [JSHandle](./puppeteer.jshandle.md) | Represents an in-page JavaScript object. JSHandles can be created with the [page.evaluateHandle](./puppeteer.page.evaluatehandle.md) method. | -| [Keyboard](./puppeteer.keyboard.md) | Keyboard provides an api for managing a virtual keyboard. The high level api is [Keyboard.type()](./puppeteer.keyboard.type.md), which takes raw characters and generates proper keydown, keypress/input, and keyup events on your page. | -| [Mouse](./puppeteer.mouse.md) | The Mouse class operates in main-frame CSS pixels relative to the top-left corner of the viewport. | -| [Page](./puppeteer.page.md) |

Page provides methods to interact with a single tab or [extension background page](https://developer.chrome.com/extensions/background_pages) in Chromium.

:::note

One Browser instance might have multiple Page instances.

:::

| -| [ProtocolError](./puppeteer.protocolerror.md) | ProtocolError is emitted whenever there is an error from the protocol. | -| [Puppeteer](./puppeteer.puppeteer.md) |

The main Puppeteer class.

IMPORTANT: if you are using Puppeteer in a Node environment, you will get an instance of [PuppeteerNode](./puppeteer.puppeteernode.md) when you import or require puppeteer. That class extends Puppeteer, so has all the methods documented below as well as all that are defined on [PuppeteerNode](./puppeteer.puppeteernode.md).

| -| [PuppeteerNode](./puppeteer.puppeteernode.md) |

Extends the main [Puppeteer](./puppeteer.puppeteer.md) class with Node specific behaviour for fetching and downloading browsers.

If you're using Puppeteer in a Node environment, this is the class you'll get when you run require('puppeteer') (or the equivalent ES import).

| -| [SecurityDetails](./puppeteer.securitydetails.md) | The SecurityDetails class represents the security details of a response that was received over a secure connection. | -| [Target](./puppeteer.target.md) | | -| [TimeoutError](./puppeteer.timeouterror.md) | TimeoutError is emitted whenever certain operations are terminated due to timeout. | -| [Touchscreen](./puppeteer.touchscreen.md) | The Touchscreen class exposes touchscreen events. | -| [Tracing](./puppeteer.tracing.md) | The Tracing class exposes the tracing audit interface. | -| [WebWorker](./puppeteer.webworker.md) | The WebWorker class represents a [WebWorker](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API). | +| Class | Description | +| --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [Accessibility](./puppeteer.accessibility.md) | The Accessibility class provides methods for inspecting Chromium's accessibility tree. The accessibility tree is used by assistive technology such as [screen readers](https://en.wikipedia.org/wiki/Screen_reader) or [switches](https://en.wikipedia.org/wiki/Switch_access). | +| [Browser](./puppeteer.browser.md) | A Browser is created when Puppeteer connects to a Chromium instance, either through [PuppeteerNode.launch()](./puppeteer.puppeteernode.launch.md) or [Puppeteer.connect()](./puppeteer.puppeteer.connect.md). | +| [BrowserContext](./puppeteer.browsercontext.md) | BrowserContexts provide a way to operate multiple independent browser sessions. When a browser is launched, it has a single BrowserContext used by default. The method [Browser.newPage](./puppeteer.browser.newpage.md) creates a page in the default browser context. | +| [BrowserFetcher](./puppeteer.browserfetcher.md) | BrowserFetcher can download and manage different versions of Chromium and Firefox. | +| [CDPSession](./puppeteer.cdpsession.md) | The CDPSession instances are used to talk raw Chrome Devtools Protocol. | +| [Connection](./puppeteer.connection.md) | | +| [ConsoleMessage](./puppeteer.consolemessage.md) | ConsoleMessage objects are dispatched by page via the 'console' event. | +| [Coverage](./puppeteer.coverage.md) | The Coverage class provides methods to gathers information about parts of JavaScript and CSS that were used by the page. | +| [CSSCoverage](./puppeteer.csscoverage.md) | | +| [CustomError](./puppeteer.customerror.md) | | +| [Dialog](./puppeteer.dialog.md) | Dialog instances are dispatched by the [Page](./puppeteer.page.md) via the dialog event. | +| [ElementHandle](./puppeteer.elementhandle.md) | ElementHandle represents an in-page DOM element. | +| [EventEmitter](./puppeteer.eventemitter.md) | The EventEmitter class that many Puppeteer classes extend. | +| [ExecutionContext](./puppeteer.executioncontext.md) | | +| [FileChooser](./puppeteer.filechooser.md) | File choosers let you react to the page requesting for a file. | +| [Frame](./puppeteer.frame.md) |

Represents a DOM frame.

To understand frames, you can think of frames as <iframe> elements. Just like iframes, frames can be nested, and when JavaScript is executed in a frame, the JavaScript does not effect frames inside the ambient frame the JavaScript executes in.

| +| [HTTPRequest](./puppeteer.httprequest.md) | Represents an HTTP request sent by a page. | +| [HTTPResponse](./puppeteer.httpresponse.md) | The HTTPResponse class represents responses which are received by the [Page](./puppeteer.page.md) class. | +| [JSCoverage](./puppeteer.jscoverage.md) | | +| [JSHandle](./puppeteer.jshandle.md) |

Represents a reference to a JavaScript object. Instances can be created using [Page.evaluateHandle()](./puppeteer.page.evaluatehandle.md).

Handles prevent the referenced JavaScript object from being garbage-collected unless the handle is purposely [disposed](./puppeteer.jshandle.dispose.md). JSHandles are auto-disposed when their associated frame is navigated away or the parent context gets destroyed.

Handles can be used as arguments for any evaluation function such as [Page.$eval()](./puppeteer.page._eval.md), [Page.evaluate()](./puppeteer.page.evaluate.md), and [Page.evaluateHandle()](./puppeteer.page.evaluatehandle.md). They are resolved to their referenced object.

| +| [Keyboard](./puppeteer.keyboard.md) | Keyboard provides an api for managing a virtual keyboard. The high level api is [Keyboard.type()](./puppeteer.keyboard.type.md), which takes raw characters and generates proper keydown, keypress/input, and keyup events on your page. | +| [Mouse](./puppeteer.mouse.md) | The Mouse class operates in main-frame CSS pixels relative to the top-left corner of the viewport. | +| [Page](./puppeteer.page.md) |

Page provides methods to interact with a single tab or [extension background page](https://developer.chrome.com/extensions/background_pages) in Chromium.

:::note

One Browser instance might have multiple Page instances.

:::

| +| [ProtocolError](./puppeteer.protocolerror.md) | ProtocolError is emitted whenever there is an error from the protocol. | +| [Puppeteer](./puppeteer.puppeteer.md) |

The main Puppeteer class.

IMPORTANT: if you are using Puppeteer in a Node environment, you will get an instance of [PuppeteerNode](./puppeteer.puppeteernode.md) when you import or require puppeteer. That class extends Puppeteer, so has all the methods documented below as well as all that are defined on [PuppeteerNode](./puppeteer.puppeteernode.md).

| +| [PuppeteerNode](./puppeteer.puppeteernode.md) |

Extends the main [Puppeteer](./puppeteer.puppeteer.md) class with Node specific behaviour for fetching and downloading browsers.

If you're using Puppeteer in a Node environment, this is the class you'll get when you run require('puppeteer') (or the equivalent ES import).

| +| [SecurityDetails](./puppeteer.securitydetails.md) | The SecurityDetails class represents the security details of a response that was received over a secure connection. | +| [Target](./puppeteer.target.md) | | +| [TimeoutError](./puppeteer.timeouterror.md) | TimeoutError is emitted whenever certain operations are terminated due to timeout. | +| [Touchscreen](./puppeteer.touchscreen.md) | The Touchscreen class exposes touchscreen events. | +| [Tracing](./puppeteer.tracing.md) | The Tracing class exposes the tracing audit interface. | +| [WebWorker](./puppeteer.webworker.md) | This class represents a [WebWorker](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API). | ## Enumerations diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.accessibility.md b/website/versioned_docs/version-16.1.1/api/puppeteer.accessibility.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.accessibility.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.accessibility.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.accessibility.snapshot.md b/website/versioned_docs/version-16.1.1/api/puppeteer.accessibility.snapshot.md similarity index 85% rename from website/versioned_docs/version-16.1.0/api/puppeteer.accessibility.snapshot.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.accessibility.snapshot.md index 9b0a2057a78..c8f7bf5bd32 100644 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.accessibility.snapshot.md +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.accessibility.snapshot.md @@ -28,7 +28,7 @@ An AXNode object representing the snapshot. ## Remarks -\*\*NOTE\*\* The Chromium accessibility tree contains nodes that go unused on most platforms and by most screen readers. Puppeteer will discard them as well for an easier to process tree, unless `interestingOnly` is set to `false`. +**NOTE** The Chromium accessibility tree contains nodes that go unused on most platforms and by most screen readers. Puppeteer will discard them as well for an easier to process tree, unless `interestingOnly` is set to `false`. ## Example 1 diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.actionresult.md b/website/versioned_docs/version-16.1.1/api/puppeteer.actionresult.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.actionresult.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.actionresult.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.awaitable.md b/website/versioned_docs/version-16.1.1/api/puppeteer.awaitable.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.awaitable.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.awaitable.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.boundingbox.height.md b/website/versioned_docs/version-16.1.1/api/puppeteer.boundingbox.height.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.boundingbox.height.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.boundingbox.height.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.boundingbox.md b/website/versioned_docs/version-16.1.1/api/puppeteer.boundingbox.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.boundingbox.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.boundingbox.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.boundingbox.width.md b/website/versioned_docs/version-16.1.1/api/puppeteer.boundingbox.width.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.boundingbox.width.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.boundingbox.width.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.boxmodel.border.md b/website/versioned_docs/version-16.1.1/api/puppeteer.boxmodel.border.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.boxmodel.border.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.boxmodel.border.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.boxmodel.content.md b/website/versioned_docs/version-16.1.1/api/puppeteer.boxmodel.content.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.boxmodel.content.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.boxmodel.content.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.boxmodel.height.md b/website/versioned_docs/version-16.1.1/api/puppeteer.boxmodel.height.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.boxmodel.height.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.boxmodel.height.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.boxmodel.margin.md b/website/versioned_docs/version-16.1.1/api/puppeteer.boxmodel.margin.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.boxmodel.margin.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.boxmodel.margin.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.boxmodel.md b/website/versioned_docs/version-16.1.1/api/puppeteer.boxmodel.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.boxmodel.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.boxmodel.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.boxmodel.padding.md b/website/versioned_docs/version-16.1.1/api/puppeteer.boxmodel.padding.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.boxmodel.padding.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.boxmodel.padding.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.boxmodel.width.md b/website/versioned_docs/version-16.1.1/api/puppeteer.boxmodel.width.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.boxmodel.width.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.boxmodel.width.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browser.browsercontexts.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browser.browsercontexts.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browser.browsercontexts.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browser.browsercontexts.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browser.close.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browser.close.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browser.close.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browser.close.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browser.createincognitobrowsercontext.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browser.createincognitobrowsercontext.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browser.createincognitobrowsercontext.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browser.createincognitobrowsercontext.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browser.defaultbrowsercontext.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browser.defaultbrowsercontext.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browser.defaultbrowsercontext.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browser.defaultbrowsercontext.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browser.disconnect.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browser.disconnect.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browser.disconnect.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browser.disconnect.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browser.isconnected.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browser.isconnected.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browser.isconnected.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browser.isconnected.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browser.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browser.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browser.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browser.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browser.newpage.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browser.newpage.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browser.newpage.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browser.newpage.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browser.pages.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browser.pages.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browser.pages.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browser.pages.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browser.process.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browser.process.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browser.process.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browser.process.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browser.target.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browser.target.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browser.target.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browser.target.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browser.targets.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browser.targets.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browser.targets.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browser.targets.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browser.useragent.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browser.useragent.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browser.useragent.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browser.useragent.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browser.version.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browser.version.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browser.version.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browser.version.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browser.waitfortarget.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browser.waitfortarget.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browser.waitfortarget.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browser.waitfortarget.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browser.wsendpoint.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browser.wsendpoint.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browser.wsendpoint.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browser.wsendpoint.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browserconnectoptions.defaultviewport.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browserconnectoptions.defaultviewport.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browserconnectoptions.defaultviewport.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browserconnectoptions.defaultviewport.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browserconnectoptions.ignorehttpserrors.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browserconnectoptions.ignorehttpserrors.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browserconnectoptions.ignorehttpserrors.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browserconnectoptions.ignorehttpserrors.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browserconnectoptions.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browserconnectoptions.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browserconnectoptions.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browserconnectoptions.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browserconnectoptions.slowmo.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browserconnectoptions.slowmo.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browserconnectoptions.slowmo.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browserconnectoptions.slowmo.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browserconnectoptions.targetfilter.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browserconnectoptions.targetfilter.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browserconnectoptions.targetfilter.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browserconnectoptions.targetfilter.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browsercontext.browser.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browsercontext.browser.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browsercontext.browser.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browsercontext.browser.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browsercontext.clearpermissionoverrides.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browsercontext.clearpermissionoverrides.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browsercontext.clearpermissionoverrides.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browsercontext.clearpermissionoverrides.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browsercontext.close.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browsercontext.close.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browsercontext.close.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browsercontext.close.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browsercontext.isincognito.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browsercontext.isincognito.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browsercontext.isincognito.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browsercontext.isincognito.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browsercontext.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browsercontext.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browsercontext.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browsercontext.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browsercontext.newpage.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browsercontext.newpage.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browsercontext.newpage.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browsercontext.newpage.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browsercontext.overridepermissions.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browsercontext.overridepermissions.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browsercontext.overridepermissions.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browsercontext.overridepermissions.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browsercontext.pages.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browsercontext.pages.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browsercontext.pages.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browsercontext.pages.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browsercontext.targets.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browsercontext.targets.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browsercontext.targets.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browsercontext.targets.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browsercontext.waitfortarget.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browsercontext.waitfortarget.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browsercontext.waitfortarget.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browsercontext.waitfortarget.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browsercontextemittedevents.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browsercontextemittedevents.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browsercontextemittedevents.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browsercontextemittedevents.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browsercontextoptions.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browsercontextoptions.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browsercontextoptions.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browsercontextoptions.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browsercontextoptions.proxybypasslist.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browsercontextoptions.proxybypasslist.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browsercontextoptions.proxybypasslist.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browsercontextoptions.proxybypasslist.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browsercontextoptions.proxyserver.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browsercontextoptions.proxyserver.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browsercontextoptions.proxyserver.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browsercontextoptions.proxyserver.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browseremittedevents.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browseremittedevents.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browseremittedevents.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browseremittedevents.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcher.candownload.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcher.candownload.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcher.candownload.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcher.candownload.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcher.download.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcher.download.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcher.download.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcher.download.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcher.host.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcher.host.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcher.host.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcher.host.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcher.localrevisions.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcher.localrevisions.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcher.localrevisions.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcher.localrevisions.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcher.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcher.md similarity index 94% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcher.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcher.md index 5c9c876f731..ac0019943a1 100644 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcher.md +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcher.md @@ -30,7 +30,7 @@ const browser = await puppeteer.launch({ }); ``` -\*\*NOTE\*\* BrowserFetcher is not designed to work concurrently with other instances of BrowserFetcher that share the same downloads directory. +**NOTE** BrowserFetcher is not designed to work concurrently with other instances of BrowserFetcher that share the same downloads directory. ## Methods diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcher.platform.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcher.platform.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcher.platform.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcher.platform.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcher.product.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcher.product.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcher.product.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcher.product.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcher.remove.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcher.remove.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcher.remove.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcher.remove.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcher.revisioninfo.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcher.revisioninfo.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcher.revisioninfo.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcher.revisioninfo.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcheroptions.host.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcheroptions.host.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcheroptions.host.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcheroptions.host.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcheroptions.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcheroptions.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcheroptions.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcheroptions.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcheroptions.path.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcheroptions.path.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcheroptions.path.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcheroptions.path.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcheroptions.platform.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcheroptions.platform.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcheroptions.platform.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcheroptions.platform.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcheroptions.product.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcheroptions.product.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcheroptions.product.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcheroptions.product.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcherrevisioninfo.executablepath.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcherrevisioninfo.executablepath.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcherrevisioninfo.executablepath.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcherrevisioninfo.executablepath.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcherrevisioninfo.folderpath.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcherrevisioninfo.folderpath.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcherrevisioninfo.folderpath.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcherrevisioninfo.folderpath.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcherrevisioninfo.local.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcherrevisioninfo.local.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcherrevisioninfo.local.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcherrevisioninfo.local.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcherrevisioninfo.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcherrevisioninfo.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcherrevisioninfo.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcherrevisioninfo.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcherrevisioninfo.product.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcherrevisioninfo.product.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcherrevisioninfo.product.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcherrevisioninfo.product.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcherrevisioninfo.revision.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcherrevisioninfo.revision.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcherrevisioninfo.revision.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcherrevisioninfo.revision.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcherrevisioninfo.url.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcherrevisioninfo.url.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browserfetcherrevisioninfo.url.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browserfetcherrevisioninfo.url.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browserlaunchargumentoptions.args.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browserlaunchargumentoptions.args.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browserlaunchargumentoptions.args.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browserlaunchargumentoptions.args.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browserlaunchargumentoptions.debuggingport.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browserlaunchargumentoptions.debuggingport.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browserlaunchargumentoptions.debuggingport.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browserlaunchargumentoptions.debuggingport.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browserlaunchargumentoptions.devtools.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browserlaunchargumentoptions.devtools.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browserlaunchargumentoptions.devtools.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browserlaunchargumentoptions.devtools.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browserlaunchargumentoptions.headless.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browserlaunchargumentoptions.headless.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browserlaunchargumentoptions.headless.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browserlaunchargumentoptions.headless.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browserlaunchargumentoptions.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browserlaunchargumentoptions.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browserlaunchargumentoptions.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browserlaunchargumentoptions.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.browserlaunchargumentoptions.userdatadir.md b/website/versioned_docs/version-16.1.1/api/puppeteer.browserlaunchargumentoptions.userdatadir.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.browserlaunchargumentoptions.userdatadir.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.browserlaunchargumentoptions.userdatadir.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.cdpsession.connection.md b/website/versioned_docs/version-16.1.1/api/puppeteer.cdpsession.connection.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.cdpsession.connection.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.cdpsession.connection.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.cdpsession.detach.md b/website/versioned_docs/version-16.1.1/api/puppeteer.cdpsession.detach.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.cdpsession.detach.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.cdpsession.detach.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.cdpsession.id.md b/website/versioned_docs/version-16.1.1/api/puppeteer.cdpsession.id.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.cdpsession.id.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.cdpsession.id.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.cdpsession.md b/website/versioned_docs/version-16.1.1/api/puppeteer.cdpsession.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.cdpsession.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.cdpsession.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.cdpsession.send.md b/website/versioned_docs/version-16.1.1/api/puppeteer.cdpsession.send.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.cdpsession.send.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.cdpsession.send.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.cdpsessiononmessageobject.error.md b/website/versioned_docs/version-16.1.1/api/puppeteer.cdpsessiononmessageobject.error.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.cdpsessiononmessageobject.error.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.cdpsessiononmessageobject.error.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.cdpsessiononmessageobject.id.md b/website/versioned_docs/version-16.1.1/api/puppeteer.cdpsessiononmessageobject.id.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.cdpsessiononmessageobject.id.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.cdpsessiononmessageobject.id.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.cdpsessiononmessageobject.md b/website/versioned_docs/version-16.1.1/api/puppeteer.cdpsessiononmessageobject.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.cdpsessiononmessageobject.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.cdpsessiononmessageobject.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.cdpsessiononmessageobject.method.md b/website/versioned_docs/version-16.1.1/api/puppeteer.cdpsessiononmessageobject.method.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.cdpsessiononmessageobject.method.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.cdpsessiononmessageobject.method.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.cdpsessiononmessageobject.params.md b/website/versioned_docs/version-16.1.1/api/puppeteer.cdpsessiononmessageobject.params.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.cdpsessiononmessageobject.params.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.cdpsessiononmessageobject.params.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.cdpsessiononmessageobject.result.md b/website/versioned_docs/version-16.1.1/api/puppeteer.cdpsessiononmessageobject.result.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.cdpsessiononmessageobject.result.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.cdpsessiononmessageobject.result.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.chromereleasechannel.md b/website/versioned_docs/version-16.1.1/api/puppeteer.chromereleasechannel.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.chromereleasechannel.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.chromereleasechannel.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.clearcustomqueryhandlers.md b/website/versioned_docs/version-16.1.1/api/puppeteer.clearcustomqueryhandlers.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.clearcustomqueryhandlers.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.clearcustomqueryhandlers.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.clickoptions.button.md b/website/versioned_docs/version-16.1.1/api/puppeteer.clickoptions.button.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.clickoptions.button.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.clickoptions.button.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.clickoptions.clickcount.md b/website/versioned_docs/version-16.1.1/api/puppeteer.clickoptions.clickcount.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.clickoptions.clickcount.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.clickoptions.clickcount.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.clickoptions.delay.md b/website/versioned_docs/version-16.1.1/api/puppeteer.clickoptions.delay.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.clickoptions.delay.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.clickoptions.delay.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.clickoptions.md b/website/versioned_docs/version-16.1.1/api/puppeteer.clickoptions.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.clickoptions.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.clickoptions.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.clickoptions.offset.md b/website/versioned_docs/version-16.1.1/api/puppeteer.clickoptions.offset.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.clickoptions.offset.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.clickoptions.offset.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.commoneventemitter.addlistener.md b/website/versioned_docs/version-16.1.1/api/puppeteer.commoneventemitter.addlistener.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.commoneventemitter.addlistener.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.commoneventemitter.addlistener.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.commoneventemitter.emit.md b/website/versioned_docs/version-16.1.1/api/puppeteer.commoneventemitter.emit.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.commoneventemitter.emit.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.commoneventemitter.emit.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.commoneventemitter.listenercount.md b/website/versioned_docs/version-16.1.1/api/puppeteer.commoneventemitter.listenercount.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.commoneventemitter.listenercount.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.commoneventemitter.listenercount.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.commoneventemitter.md b/website/versioned_docs/version-16.1.1/api/puppeteer.commoneventemitter.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.commoneventemitter.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.commoneventemitter.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.commoneventemitter.off.md b/website/versioned_docs/version-16.1.1/api/puppeteer.commoneventemitter.off.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.commoneventemitter.off.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.commoneventemitter.off.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.commoneventemitter.on.md b/website/versioned_docs/version-16.1.1/api/puppeteer.commoneventemitter.on.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.commoneventemitter.on.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.commoneventemitter.on.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.commoneventemitter.once.md b/website/versioned_docs/version-16.1.1/api/puppeteer.commoneventemitter.once.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.commoneventemitter.once.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.commoneventemitter.once.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.commoneventemitter.removealllisteners.md b/website/versioned_docs/version-16.1.1/api/puppeteer.commoneventemitter.removealllisteners.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.commoneventemitter.removealllisteners.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.commoneventemitter.removealllisteners.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.commoneventemitter.removelistener.md b/website/versioned_docs/version-16.1.1/api/puppeteer.commoneventemitter.removelistener.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.commoneventemitter.removelistener.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.commoneventemitter.removelistener.md diff --git a/website/versioned_docs/version-16.1.1/api/puppeteer.connect.md b/website/versioned_docs/version-16.1.1/api/puppeteer.connect.md new file mode 100644 index 00000000000..417bbdd4603 --- /dev/null +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.connect.md @@ -0,0 +1,12 @@ +--- +sidebar_label: connect +--- + +# connect variable + +**Signature:** + +```typescript +connect: (options: import('./types.js').ConnectOptions) => + Promise; +``` diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.connection._constructor_.md b/website/versioned_docs/version-16.1.1/api/puppeteer.connection._constructor_.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.connection._constructor_.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.connection._constructor_.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.connection.createsession.md b/website/versioned_docs/version-16.1.1/api/puppeteer.connection.createsession.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.connection.createsession.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.connection.createsession.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.connection.dispose.md b/website/versioned_docs/version-16.1.1/api/puppeteer.connection.dispose.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.connection.dispose.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.connection.dispose.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.connection.fromsession.md b/website/versioned_docs/version-16.1.1/api/puppeteer.connection.fromsession.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.connection.fromsession.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.connection.fromsession.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.connection.md b/website/versioned_docs/version-16.1.1/api/puppeteer.connection.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.connection.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.connection.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.connection.send.md b/website/versioned_docs/version-16.1.1/api/puppeteer.connection.send.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.connection.send.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.connection.send.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.connection.session.md b/website/versioned_docs/version-16.1.1/api/puppeteer.connection.session.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.connection.session.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.connection.session.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.connection.url.md b/website/versioned_docs/version-16.1.1/api/puppeteer.connection.url.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.connection.url.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.connection.url.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.connectioncallback.error.md b/website/versioned_docs/version-16.1.1/api/puppeteer.connectioncallback.error.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.connectioncallback.error.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.connectioncallback.error.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.connectioncallback.md b/website/versioned_docs/version-16.1.1/api/puppeteer.connectioncallback.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.connectioncallback.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.connectioncallback.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.connectioncallback.method.md b/website/versioned_docs/version-16.1.1/api/puppeteer.connectioncallback.method.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.connectioncallback.method.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.connectioncallback.method.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.connectioncallback.reject.md b/website/versioned_docs/version-16.1.1/api/puppeteer.connectioncallback.reject.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.connectioncallback.reject.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.connectioncallback.reject.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.connectioncallback.resolve.md b/website/versioned_docs/version-16.1.1/api/puppeteer.connectioncallback.resolve.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.connectioncallback.resolve.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.connectioncallback.resolve.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.connectiontransport.close.md b/website/versioned_docs/version-16.1.1/api/puppeteer.connectiontransport.close.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.connectiontransport.close.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.connectiontransport.close.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.connectiontransport.md b/website/versioned_docs/version-16.1.1/api/puppeteer.connectiontransport.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.connectiontransport.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.connectiontransport.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.connectiontransport.onclose.md b/website/versioned_docs/version-16.1.1/api/puppeteer.connectiontransport.onclose.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.connectiontransport.onclose.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.connectiontransport.onclose.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.connectiontransport.onmessage.md b/website/versioned_docs/version-16.1.1/api/puppeteer.connectiontransport.onmessage.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.connectiontransport.onmessage.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.connectiontransport.onmessage.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.connectiontransport.send.md b/website/versioned_docs/version-16.1.1/api/puppeteer.connectiontransport.send.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.connectiontransport.send.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.connectiontransport.send.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.connectoptions.browserurl.md b/website/versioned_docs/version-16.1.1/api/puppeteer.connectoptions.browserurl.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.connectoptions.browserurl.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.connectoptions.browserurl.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.connectoptions.browserwsendpoint.md b/website/versioned_docs/version-16.1.1/api/puppeteer.connectoptions.browserwsendpoint.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.connectoptions.browserwsendpoint.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.connectoptions.browserwsendpoint.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.connectoptions.md b/website/versioned_docs/version-16.1.1/api/puppeteer.connectoptions.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.connectoptions.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.connectoptions.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.connectoptions.transport.md b/website/versioned_docs/version-16.1.1/api/puppeteer.connectoptions.transport.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.connectoptions.transport.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.connectoptions.transport.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.consolemessage._constructor_.md b/website/versioned_docs/version-16.1.1/api/puppeteer.consolemessage._constructor_.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.consolemessage._constructor_.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.consolemessage._constructor_.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.consolemessage.args.md b/website/versioned_docs/version-16.1.1/api/puppeteer.consolemessage.args.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.consolemessage.args.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.consolemessage.args.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.consolemessage.location.md b/website/versioned_docs/version-16.1.1/api/puppeteer.consolemessage.location.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.consolemessage.location.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.consolemessage.location.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.consolemessage.md b/website/versioned_docs/version-16.1.1/api/puppeteer.consolemessage.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.consolemessage.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.consolemessage.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.consolemessage.stacktrace.md b/website/versioned_docs/version-16.1.1/api/puppeteer.consolemessage.stacktrace.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.consolemessage.stacktrace.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.consolemessage.stacktrace.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.consolemessage.text.md b/website/versioned_docs/version-16.1.1/api/puppeteer.consolemessage.text.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.consolemessage.text.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.consolemessage.text.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.consolemessage.type.md b/website/versioned_docs/version-16.1.1/api/puppeteer.consolemessage.type.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.consolemessage.type.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.consolemessage.type.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.consolemessagelocation.columnnumber.md b/website/versioned_docs/version-16.1.1/api/puppeteer.consolemessagelocation.columnnumber.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.consolemessagelocation.columnnumber.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.consolemessagelocation.columnnumber.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.consolemessagelocation.linenumber.md b/website/versioned_docs/version-16.1.1/api/puppeteer.consolemessagelocation.linenumber.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.consolemessagelocation.linenumber.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.consolemessagelocation.linenumber.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.consolemessagelocation.md b/website/versioned_docs/version-16.1.1/api/puppeteer.consolemessagelocation.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.consolemessagelocation.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.consolemessagelocation.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.consolemessagelocation.url.md b/website/versioned_docs/version-16.1.1/api/puppeteer.consolemessagelocation.url.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.consolemessagelocation.url.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.consolemessagelocation.url.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.consolemessagetype.md b/website/versioned_docs/version-16.1.1/api/puppeteer.consolemessagetype.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.consolemessagetype.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.consolemessagetype.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.continuerequestoverrides.headers.md b/website/versioned_docs/version-16.1.1/api/puppeteer.continuerequestoverrides.headers.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.continuerequestoverrides.headers.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.continuerequestoverrides.headers.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.continuerequestoverrides.md b/website/versioned_docs/version-16.1.1/api/puppeteer.continuerequestoverrides.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.continuerequestoverrides.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.continuerequestoverrides.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.continuerequestoverrides.method.md b/website/versioned_docs/version-16.1.1/api/puppeteer.continuerequestoverrides.method.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.continuerequestoverrides.method.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.continuerequestoverrides.method.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.continuerequestoverrides.postdata.md b/website/versioned_docs/version-16.1.1/api/puppeteer.continuerequestoverrides.postdata.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.continuerequestoverrides.postdata.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.continuerequestoverrides.postdata.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.continuerequestoverrides.url.md b/website/versioned_docs/version-16.1.1/api/puppeteer.continuerequestoverrides.url.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.continuerequestoverrides.url.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.continuerequestoverrides.url.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.coverage._constructor_.md b/website/versioned_docs/version-16.1.1/api/puppeteer.coverage._constructor_.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.coverage._constructor_.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.coverage._constructor_.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.coverage.md b/website/versioned_docs/version-16.1.1/api/puppeteer.coverage.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.coverage.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.coverage.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.coverage.startcsscoverage.md b/website/versioned_docs/version-16.1.1/api/puppeteer.coverage.startcsscoverage.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.coverage.startcsscoverage.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.coverage.startcsscoverage.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.coverage.startjscoverage.md b/website/versioned_docs/version-16.1.1/api/puppeteer.coverage.startjscoverage.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.coverage.startjscoverage.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.coverage.startjscoverage.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.coverage.stopcsscoverage.md b/website/versioned_docs/version-16.1.1/api/puppeteer.coverage.stopcsscoverage.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.coverage.stopcsscoverage.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.coverage.stopcsscoverage.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.coverage.stopjscoverage.md b/website/versioned_docs/version-16.1.1/api/puppeteer.coverage.stopjscoverage.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.coverage.stopjscoverage.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.coverage.stopjscoverage.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.coverageentry.md b/website/versioned_docs/version-16.1.1/api/puppeteer.coverageentry.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.coverageentry.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.coverageentry.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.coverageentry.ranges.md b/website/versioned_docs/version-16.1.1/api/puppeteer.coverageentry.ranges.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.coverageentry.ranges.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.coverageentry.ranges.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.coverageentry.text.md b/website/versioned_docs/version-16.1.1/api/puppeteer.coverageentry.text.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.coverageentry.text.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.coverageentry.text.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.coverageentry.url.md b/website/versioned_docs/version-16.1.1/api/puppeteer.coverageentry.url.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.coverageentry.url.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.coverageentry.url.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.createbrowserfetcher.md b/website/versioned_docs/version-16.1.1/api/puppeteer.createbrowserfetcher.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.createbrowserfetcher.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.createbrowserfetcher.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.credentials.md b/website/versioned_docs/version-16.1.1/api/puppeteer.credentials.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.credentials.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.credentials.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.credentials.password.md b/website/versioned_docs/version-16.1.1/api/puppeteer.credentials.password.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.credentials.password.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.credentials.password.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.credentials.username.md b/website/versioned_docs/version-16.1.1/api/puppeteer.credentials.username.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.credentials.username.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.credentials.username.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.csscoverage._constructor_.md b/website/versioned_docs/version-16.1.1/api/puppeteer.csscoverage._constructor_.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.csscoverage._constructor_.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.csscoverage._constructor_.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.csscoverage.md b/website/versioned_docs/version-16.1.1/api/puppeteer.csscoverage.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.csscoverage.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.csscoverage.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.csscoverage.start.md b/website/versioned_docs/version-16.1.1/api/puppeteer.csscoverage.start.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.csscoverage.start.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.csscoverage.start.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.csscoverage.stop.md b/website/versioned_docs/version-16.1.1/api/puppeteer.csscoverage.stop.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.csscoverage.stop.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.csscoverage.stop.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.csscoverageoptions.md b/website/versioned_docs/version-16.1.1/api/puppeteer.csscoverageoptions.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.csscoverageoptions.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.csscoverageoptions.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.csscoverageoptions.resetonnavigation.md b/website/versioned_docs/version-16.1.1/api/puppeteer.csscoverageoptions.resetonnavigation.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.csscoverageoptions.resetonnavigation.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.csscoverageoptions.resetonnavigation.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.customerror._constructor_.md b/website/versioned_docs/version-16.1.1/api/puppeteer.customerror._constructor_.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.customerror._constructor_.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.customerror._constructor_.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.customerror.md b/website/versioned_docs/version-16.1.1/api/puppeteer.customerror.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.customerror.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.customerror.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.customqueryhandler.md b/website/versioned_docs/version-16.1.1/api/puppeteer.customqueryhandler.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.customqueryhandler.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.customqueryhandler.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.customqueryhandler.queryall.md b/website/versioned_docs/version-16.1.1/api/puppeteer.customqueryhandler.queryall.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.customqueryhandler.queryall.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.customqueryhandler.queryall.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.customqueryhandler.queryone.md b/website/versioned_docs/version-16.1.1/api/puppeteer.customqueryhandler.queryone.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.customqueryhandler.queryone.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.customqueryhandler.queryone.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.customqueryhandlernames.md b/website/versioned_docs/version-16.1.1/api/puppeteer.customqueryhandlernames.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.customqueryhandlernames.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.customqueryhandlernames.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.default_intercept_resolution_priority.md b/website/versioned_docs/version-16.1.1/api/puppeteer.default_intercept_resolution_priority.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.default_intercept_resolution_priority.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.default_intercept_resolution_priority.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.defaultargs.md b/website/versioned_docs/version-16.1.1/api/puppeteer.defaultargs.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.defaultargs.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.defaultargs.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.device.md b/website/versioned_docs/version-16.1.1/api/puppeteer.device.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.device.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.device.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.device.name.md b/website/versioned_docs/version-16.1.1/api/puppeteer.device.name.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.device.name.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.device.name.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.device.useragent.md b/website/versioned_docs/version-16.1.1/api/puppeteer.device.useragent.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.device.useragent.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.device.useragent.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.device.viewport.md b/website/versioned_docs/version-16.1.1/api/puppeteer.device.viewport.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.device.viewport.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.device.viewport.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.devices.md b/website/versioned_docs/version-16.1.1/api/puppeteer.devices.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.devices.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.devices.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.devicesmap.md b/website/versioned_docs/version-16.1.1/api/puppeteer.devicesmap.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.devicesmap.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.devicesmap.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.dialog.accept.md b/website/versioned_docs/version-16.1.1/api/puppeteer.dialog.accept.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.dialog.accept.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.dialog.accept.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.dialog.defaultvalue.md b/website/versioned_docs/version-16.1.1/api/puppeteer.dialog.defaultvalue.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.dialog.defaultvalue.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.dialog.defaultvalue.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.dialog.dismiss.md b/website/versioned_docs/version-16.1.1/api/puppeteer.dialog.dismiss.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.dialog.dismiss.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.dialog.dismiss.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.dialog.md b/website/versioned_docs/version-16.1.1/api/puppeteer.dialog.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.dialog.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.dialog.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.dialog.message.md b/website/versioned_docs/version-16.1.1/api/puppeteer.dialog.message.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.dialog.message.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.dialog.message.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.dialog.type.md b/website/versioned_docs/version-16.1.1/api/puppeteer.dialog.type.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.dialog.type.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.dialog.type.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle._.md b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle._.md similarity index 52% rename from website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle._.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle._.md index 2d2f3b3ad66..c3984a957ed 100644 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle._.md +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle._.md @@ -4,7 +4,7 @@ sidebar_label: ElementHandle.$ # ElementHandle.$() method -Runs `element.querySelector` within the page. +Queries the current element for an element matching the given selector. **Signature:** @@ -18,16 +18,12 @@ class ElementHandle { ## Parameters -| Parameter | Type | Description | -| --------- | -------- | --------------------------- | -| selector | Selector | The selector to query with. | +| Parameter | Type | Description | +| --------- | -------- | -------------------------- | +| selector | Selector | The selector to query for. | **Returns:** Promise<[ElementHandle](./puppeteer.elementhandle.md)<[NodeFor](./puppeteer.nodefor.md)<Selector>> \| null> -`null` if no element matches the selector. - -## Exceptions - -`Error` if the selector has no associated query handler. +A [element handle](./puppeteer.elementhandle.md) to the first element matching the given selector. Otherwise, `null`. diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.__.md b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.__.md similarity index 53% rename from website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.__.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.__.md index 5d18f3cbb3f..18ff9489245 100644 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.__.md +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.__.md @@ -4,7 +4,7 @@ sidebar_label: ElementHandle.$$ # ElementHandle.$$() method -Runs `element.querySelectorAll` within the page. +Queries the current element for all elements matching the given selector. **Signature:** @@ -18,16 +18,12 @@ class ElementHandle { ## Parameters -| Parameter | Type | Description | -| --------- | -------- | --------------------------- | -| selector | Selector | The selector to query with. | +| Parameter | Type | Description | +| --------- | -------- | -------------------------- | +| selector | Selector | The selector to query for. | **Returns:** Promise<Array<[ElementHandle](./puppeteer.elementhandle.md)<[NodeFor](./puppeteer.nodefor.md)<Selector>>>> -`[]` if no element matches the selector. - -## Exceptions - -`Error` if the selector has no associated query handler. +An array of [element handles](./puppeteer.elementhandle.md) that point to elements matching the given selector. diff --git a/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.__eval.md b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.__eval.md new file mode 100644 index 00000000000..d34a4175996 --- /dev/null +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.__eval.md @@ -0,0 +1,61 @@ +--- +sidebar_label: ElementHandle.$$eval +--- + +# ElementHandle.$$eval() method + +Runs the given function on an array of elements matching the given selector in the current element. + +If the given function returns a promise, then this method will wait till the promise resolves. + +**Signature:** + +```typescript +class ElementHandle { + $$eval< + Selector extends string, + Params extends unknown[], + Func extends EvaluateFunc< + [Array>, ...Params] + > = EvaluateFunc<[Array>, ...Params]> + >( + selector: Selector, + pageFunction: Func | string, + ...args: Params + ): Promise>>; +} +``` + +## Parameters + +| Parameter | Type | Description | +| ------------ | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| selector | Selector | The selector to query for. | +| pageFunction | Func \| string | The function to be evaluated in the element's page's context. An array of elements matching the given selector will be passed to the function as its first argument. | +| args | Params | Additional arguments to pass to pageFunction. | + +**Returns:** + +Promise<Awaited<ReturnType<Func>>> + +A promise to the result of the function. + +## Example + +HTML: + +```html +
+
Hello!
+
Hi!
+
+``` + +JavaScript: + +```js +const feedHandle = await page.$('.feed'); +expect( + await feedHandle.$$eval('.tweet', nodes => nodes.map(n => n.innerText)) +).toEqual(['Hello!', 'Hi!']); +``` diff --git a/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle._eval.md b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle._eval.md new file mode 100644 index 00000000000..11cb427b77a --- /dev/null +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle._eval.md @@ -0,0 +1,49 @@ +--- +sidebar_label: ElementHandle.$eval +--- + +# ElementHandle.$eval() method + +Runs the given function on the first element matching the given selector in the current element. + +If the given function returns a promise, then this method will wait till the promise resolves. + +**Signature:** + +```typescript +class ElementHandle { + $eval< + Selector extends string, + Params extends unknown[], + Func extends EvaluateFunc< + [ElementHandle>, ...Params] + > = EvaluateFunc<[ElementHandle>, ...Params]> + >( + selector: Selector, + pageFunction: Func | string, + ...args: Params + ): Promise>>; +} +``` + +## Parameters + +| Parameter | Type | Description | +| ------------ | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | +| selector | Selector | The selector to query for. | +| pageFunction | Func \| string | The function to be evaluated in this element's page's context. The first element matching the selector will be passed in as the first argument. | +| args | Params | Additional arguments to pass to pageFunction. | + +**Returns:** + +Promise<Awaited<ReturnType<Func>>> + +A promise to the result of the function. + +## Example + +```ts +const tweetHandle = await page.$('.tweet'); +expect(await tweetHandle.$eval('.like', node => node.innerText)).toBe('100'); +expect(await tweetHandle.$eval('.retweets', node => node.innerText)).toBe('10'); +``` diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle._x.md b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle._x.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle._x.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle._x.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.aselement.md b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.aselement.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.aselement.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.aselement.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.boundingbox.md b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.boundingbox.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.boundingbox.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.boundingbox.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.boxmodel.md b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.boxmodel.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.boxmodel.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.boxmodel.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.click.md b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.click.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.click.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.click.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.clickablepoint.md b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.clickablepoint.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.clickablepoint.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.clickablepoint.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.contentframe.md b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.contentframe.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.contentframe.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.contentframe.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.drag.md b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.drag.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.drag.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.drag.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.draganddrop.md b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.draganddrop.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.draganddrop.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.draganddrop.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.dragenter.md b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.dragenter.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.dragenter.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.dragenter.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.dragover.md b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.dragover.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.dragover.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.dragover.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.drop.md b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.drop.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.drop.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.drop.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.focus.md b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.focus.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.focus.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.focus.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.hover.md b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.hover.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.hover.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.hover.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.isintersectingviewport.md b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.isintersectingviewport.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.isintersectingviewport.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.isintersectingviewport.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.md b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.md similarity index 69% rename from website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.md index e741b62bea7..1255d134906 100644 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.md +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.md @@ -12,7 +12,7 @@ ElementHandle represents an in-page DOM element. export declare class ElementHandle extends JSHandle ``` -**Extends:** [JSHandle](./puppeteer.jshandle.md) +**Extends:** [JSHandle](./puppeteer.jshandle.md)<ElementType> ## Remarks @@ -41,32 +41,32 @@ The constructor for this class is marked as internal. Third-party code should no ## Methods -| Method | Modifiers | Description | -| -------------------------------------------------------------------------------------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [$(selector)](./puppeteer.elementhandle._.md) | | Runs element.querySelector within the page. | -| [$$(selector)](./puppeteer.elementhandle.__.md) | | Runs element.querySelectorAll within the page. | -| [$$eval(selector, pageFunction, args)](./puppeteer.elementhandle.__eval.md) | |

This method runs document.querySelectorAll within the element and passes it as the first argument to pageFunction. If there's no element matching selector, the method throws an error.

If pageFunction returns a Promise, then frame.$$eval would wait for the promise to resolve and return its value.

| -| [$eval(selector, pageFunction, args)](./puppeteer.elementhandle._eval.md) | |

This method runs document.querySelector within the element and passes it as the first argument to pageFunction. If there's no element matching selector, the method throws an error.

If pageFunction returns a Promise, then frame.$eval would wait for the promise to resolve and return its value.

| -| [$x(expression)](./puppeteer.elementhandle._x.md) | | | -| [asElement()](./puppeteer.elementhandle.aselement.md) | | | -| [boundingBox()](./puppeteer.elementhandle.boundingbox.md) | | This method returns the bounding box of the element (relative to the main frame), or null if the element is not visible. | -| [boxModel()](./puppeteer.elementhandle.boxmodel.md) | | This method returns boxes of the element, or null if the element is not visible. | -| [click(this, options)](./puppeteer.elementhandle.click.md) | | This method scrolls element into view if needed, and then uses [Page.mouse](./puppeteer.page.mouse.md) to click in the center of the element. If the element is detached from DOM, the method throws an error. | -| [clickablePoint(offset)](./puppeteer.elementhandle.clickablepoint.md) | | Returns the middle point within an element unless a specific offset is provided. | -| [contentFrame()](./puppeteer.elementhandle.contentframe.md) | | Resolves to the content frame for element handles referencing iframe nodes, or null otherwise | -| [drag(this, target)](./puppeteer.elementhandle.drag.md) | | This method creates and captures a dragevent from the element. | -| [dragAndDrop(this, target, options)](./puppeteer.elementhandle.draganddrop.md) | | This method triggers a dragenter, dragover, and drop on the element. | -| [dragEnter(this, data)](./puppeteer.elementhandle.dragenter.md) | | This method creates a dragenter event on the element. | -| [dragOver(this, data)](./puppeteer.elementhandle.dragover.md) | | This method creates a dragover event on the element. | -| [drop(this, data)](./puppeteer.elementhandle.drop.md) | | This method triggers a drop on the element. | -| [focus()](./puppeteer.elementhandle.focus.md) | | Calls [focus](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus) on the element. | -| [hover(this)](./puppeteer.elementhandle.hover.md) | | This method scrolls element into view if needed, and then uses [Page.mouse](./puppeteer.page.mouse.md) to hover over the center of the element. If the element is detached from DOM, the method throws an error. | -| [isIntersectingViewport(this, options)](./puppeteer.elementhandle.isintersectingviewport.md) | | Resolves to true if the element is visible in the current viewport. | -| [press(key, options)](./puppeteer.elementhandle.press.md) | | Focuses the element, and then uses [Keyboard.down()](./puppeteer.keyboard.down.md) and [Keyboard.up()](./puppeteer.keyboard.up.md). | -| [screenshot(this, options)](./puppeteer.elementhandle.screenshot.md) | | This method scrolls element into view if needed, and then uses [Page.screenshot()](./puppeteer.page.screenshot.md) to take a screenshot of the element. If the element is detached from DOM, the method throws an error. | -| [select(values)](./puppeteer.elementhandle.select.md) | | Triggers a change and input event once all the provided options have been selected. If there's no <select> element matching selector, the method throws an error. | -| [tap(this)](./puppeteer.elementhandle.tap.md) | | This method scrolls element into view if needed, and then uses [Touchscreen.tap()](./puppeteer.touchscreen.tap.md) to tap in the center of the element. If the element is detached from DOM, the method throws an error. | -| [type(text, options)](./puppeteer.elementhandle.type.md) | |

Focuses the element, and then sends a keydown, keypress/input, and keyup event for each character in the text.

To press a special key, like Control or ArrowDown, use [ElementHandle.press()](./puppeteer.elementhandle.press.md).

| -| [uploadFile(this, filePaths)](./puppeteer.elementhandle.uploadfile.md) | | This method expects elementHandle to point to an [input element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input). | -| [waitForSelector(selector, options)](./puppeteer.elementhandle.waitforselector.md) | |

Wait for the selector to appear within the element. If at the moment of calling the method the selector already exists, the method will return immediately. If the selector doesn't appear after the timeout milliseconds of waiting, the function will throw.

This method does not work across navigations or if the element is detached from DOM.

| -| [waitForXPath(xpath, options)](./puppeteer.elementhandle.waitforxpath.md) | | | +| Method | Modifiers | Description | +| -------------------------------------------------------------------------------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [$(selector)](./puppeteer.elementhandle._.md) | | Queries the current element for an element matching the given selector. | +| [$$(selector)](./puppeteer.elementhandle.__.md) | | Queries the current element for all elements matching the given selector. | +| [$$eval(selector, pageFunction, args)](./puppeteer.elementhandle.__eval.md) | |

Runs the given function on an array of elements matching the given selector in the current element.

If the given function returns a promise, then this method will wait till the promise resolves.

| +| [$eval(selector, pageFunction, args)](./puppeteer.elementhandle._eval.md) | |

Runs the given function on the first element matching the given selector in the current element.

If the given function returns a promise, then this method will wait till the promise resolves.

| +| [$x(expression)](./puppeteer.elementhandle._x.md) | | | +| [asElement()](./puppeteer.elementhandle.aselement.md) | | | +| [boundingBox()](./puppeteer.elementhandle.boundingbox.md) | | This method returns the bounding box of the element (relative to the main frame), or null if the element is not visible. | +| [boxModel()](./puppeteer.elementhandle.boxmodel.md) | | This method returns boxes of the element, or null if the element is not visible. | +| [click(this, options)](./puppeteer.elementhandle.click.md) | | This method scrolls element into view if needed, and then uses [Page.mouse](./puppeteer.page.mouse.md) to click in the center of the element. If the element is detached from DOM, the method throws an error. | +| [clickablePoint(offset)](./puppeteer.elementhandle.clickablepoint.md) | | Returns the middle point within an element unless a specific offset is provided. | +| [contentFrame()](./puppeteer.elementhandle.contentframe.md) | | Resolves to the content frame for element handles referencing iframe nodes, or null otherwise | +| [drag(this, target)](./puppeteer.elementhandle.drag.md) | | This method creates and captures a dragevent from the element. | +| [dragAndDrop(this, target, options)](./puppeteer.elementhandle.draganddrop.md) | | This method triggers a dragenter, dragover, and drop on the element. | +| [dragEnter(this, data)](./puppeteer.elementhandle.dragenter.md) | | This method creates a dragenter event on the element. | +| [dragOver(this, data)](./puppeteer.elementhandle.dragover.md) | | This method creates a dragover event on the element. | +| [drop(this, data)](./puppeteer.elementhandle.drop.md) | | This method triggers a drop on the element. | +| [focus()](./puppeteer.elementhandle.focus.md) | | Calls [focus](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus) on the element. | +| [hover(this)](./puppeteer.elementhandle.hover.md) | | This method scrolls element into view if needed, and then uses [Page.mouse](./puppeteer.page.mouse.md) to hover over the center of the element. If the element is detached from DOM, the method throws an error. | +| [isIntersectingViewport(this, options)](./puppeteer.elementhandle.isintersectingviewport.md) | | Resolves to true if the element is visible in the current viewport. | +| [press(key, options)](./puppeteer.elementhandle.press.md) | | Focuses the element, and then uses [Keyboard.down()](./puppeteer.keyboard.down.md) and [Keyboard.up()](./puppeteer.keyboard.up.md). | +| [screenshot(this, options)](./puppeteer.elementhandle.screenshot.md) | | This method scrolls element into view if needed, and then uses [Page.screenshot()](./puppeteer.page.screenshot.md) to take a screenshot of the element. If the element is detached from DOM, the method throws an error. | +| [select(values)](./puppeteer.elementhandle.select.md) | | Triggers a change and input event once all the provided options have been selected. If there's no <select> element matching selector, the method throws an error. | +| [tap(this)](./puppeteer.elementhandle.tap.md) | | This method scrolls element into view if needed, and then uses [Touchscreen.tap()](./puppeteer.touchscreen.tap.md) to tap in the center of the element. If the element is detached from DOM, the method throws an error. | +| [type(text, options)](./puppeteer.elementhandle.type.md) | |

Focuses the element, and then sends a keydown, keypress/input, and keyup event for each character in the text.

To press a special key, like Control or ArrowDown, use [ElementHandle.press()](./puppeteer.elementhandle.press.md).

| +| [uploadFile(this, filePaths)](./puppeteer.elementhandle.uploadfile.md) | | This method expects elementHandle to point to an [input element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input). | +| [waitForSelector(selector, options)](./puppeteer.elementhandle.waitforselector.md) | |

Wait for an element matching the given selector to appear in the current element.

Unlike [Frame.waitForSelector()](./puppeteer.frame.waitforselector.md), this method does not work across navigations or if the element is detached from DOM.

| +| [waitForXPath(xpath, options)](./puppeteer.elementhandle.waitforxpath.md) | | | diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.press.md b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.press.md similarity index 92% rename from website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.press.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.press.md index 28f2928cd80..5b2b1e6321e 100644 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.press.md +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.press.md @@ -29,4 +29,4 @@ Promise<void> If `key` is a single character and no modifier keys besides `Shift` are being held down, a `keypress`/`input` event will also be generated. The `text` option can be specified to force an input event to be generated. -\*\*NOTE\*\* Modifier keys DO affect `elementHandle.press`. Holding down `Shift` will type the text in upper case. +**NOTE** Modifier keys DO affect `elementHandle.press`. Holding down `Shift` will type the text in upper case. diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.screenshot.md b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.screenshot.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.screenshot.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.screenshot.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.select.md b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.select.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.select.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.select.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.tap.md b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.tap.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.tap.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.tap.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.type.md b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.type.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.type.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.type.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.uploadfile.md b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.uploadfile.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.uploadfile.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.uploadfile.md diff --git a/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.waitforselector.md b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.waitforselector.md new file mode 100644 index 00000000000..5f905d1715d --- /dev/null +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.waitforselector.md @@ -0,0 +1,62 @@ +--- +sidebar_label: ElementHandle.waitForSelector +--- + +# ElementHandle.waitForSelector() method + +Wait for an element matching the given selector to appear in the current element. + +Unlike [Frame.waitForSelector()](./puppeteer.frame.waitforselector.md), this method does not work across navigations or if the element is detached from DOM. + +**Signature:** + +```typescript +class ElementHandle { + waitForSelector( + selector: Selector, + options?: Exclude + ): Promise> | null>; +} +``` + +## Parameters + +| Parameter | Type | Description | +| --------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------- | +| selector | Selector | The selector to query and wait for. | +| options | Exclude<[WaitForSelectorOptions](./puppeteer.waitforselectoroptions.md), 'root'> | (Optional) Options for customizing waiting behavior. | + +**Returns:** + +Promise<[ElementHandle](./puppeteer.elementhandle.md)<[NodeFor](./puppeteer.nodefor.md)<Selector>> \| null> + +An element matching the given selector. + +## Exceptions + +Throws if an element matching the given selector doesn't appear. + +## Example + +```ts +const puppeteer = require('puppeteer'); + +(async () => { + const browser = await puppeteer.launch(); + const page = await browser.newPage(); + let currentURL; + page + .mainFrame() + .waitForSelector('img') + .then(() => console.log('First URL with image: ' + currentURL)); + + for (currentURL of [ + 'https://example.com', + 'https://google.com', + 'https://bbc.com', + ]) { + await page.goto(currentURL); + } + await browser.close(); +})(); +``` diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.waitforxpath.md b/website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.waitforxpath.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.elementhandle.waitforxpath.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.elementhandle.waitforxpath.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.errorcode.md b/website/versioned_docs/version-16.1.1/api/puppeteer.errorcode.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.errorcode.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.errorcode.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.errors.md b/website/versioned_docs/version-16.1.1/api/puppeteer.errors.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.errors.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.errors.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.evaluatefunc.md b/website/versioned_docs/version-16.1.1/api/puppeteer.evaluatefunc.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.evaluatefunc.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.evaluatefunc.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.evaluation_script_url.md b/website/versioned_docs/version-16.1.1/api/puppeteer.evaluation_script_url.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.evaluation_script_url.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.evaluation_script_url.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.eventemitter.addlistener.md b/website/versioned_docs/version-16.1.1/api/puppeteer.eventemitter.addlistener.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.eventemitter.addlistener.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.eventemitter.addlistener.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.eventemitter.emit.md b/website/versioned_docs/version-16.1.1/api/puppeteer.eventemitter.emit.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.eventemitter.emit.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.eventemitter.emit.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.eventemitter.listenercount.md b/website/versioned_docs/version-16.1.1/api/puppeteer.eventemitter.listenercount.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.eventemitter.listenercount.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.eventemitter.listenercount.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.eventemitter.md b/website/versioned_docs/version-16.1.1/api/puppeteer.eventemitter.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.eventemitter.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.eventemitter.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.eventemitter.off.md b/website/versioned_docs/version-16.1.1/api/puppeteer.eventemitter.off.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.eventemitter.off.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.eventemitter.off.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.eventemitter.on.md b/website/versioned_docs/version-16.1.1/api/puppeteer.eventemitter.on.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.eventemitter.on.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.eventemitter.on.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.eventemitter.once.md b/website/versioned_docs/version-16.1.1/api/puppeteer.eventemitter.once.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.eventemitter.once.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.eventemitter.once.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.eventemitter.removealllisteners.md b/website/versioned_docs/version-16.1.1/api/puppeteer.eventemitter.removealllisteners.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.eventemitter.removealllisteners.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.eventemitter.removealllisteners.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.eventemitter.removelistener.md b/website/versioned_docs/version-16.1.1/api/puppeteer.eventemitter.removelistener.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.eventemitter.removelistener.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.eventemitter.removelistener.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.eventtype.md b/website/versioned_docs/version-16.1.1/api/puppeteer.eventtype.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.eventtype.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.eventtype.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.executablepath.md b/website/versioned_docs/version-16.1.1/api/puppeteer.executablepath.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.executablepath.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.executablepath.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.executioncontext.evaluate.md b/website/versioned_docs/version-16.1.1/api/puppeteer.executioncontext.evaluate.md similarity index 52% rename from website/versioned_docs/version-16.1.0/api/puppeteer.executioncontext.evaluate.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.executioncontext.evaluate.md index 3c7abd30581..549997871f5 100644 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.executioncontext.evaluate.md +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.executioncontext.evaluate.md @@ -4,6 +4,8 @@ sidebar_label: ExecutionContext.evaluate # ExecutionContext.evaluate() method +Evaluates the given function. + **Signature:** ```typescript @@ -20,20 +22,16 @@ class ExecutionContext { ## Parameters -| Parameter | Type | Description | -| ------------ | -------------- | --------------------------------------------------------------- | -| pageFunction | Func \| string | a function to be evaluated in the executionContext | -| args | Params | argument to pass to the page function | +| Parameter | Type | Description | +| ------------ | -------------- | ----------------------------------------------- | +| pageFunction | Func \| string | The function to evaluate. | +| args | Params | Additional arguments to pass into the function. | **Returns:** Promise<Awaited<ReturnType<Func>>> -A promise that resolves to the return value of the given function. - -## Remarks - -If the function passed to the `executionContext.evaluate` returns a Promise, then `executionContext.evaluate` would wait for the promise to resolve and return its value. If the function passed to the `executionContext.evaluate` returns a non-serializable value, then `executionContext.evaluate` resolves to `undefined`. DevTools Protocol also supports transferring some additional values that are not serializable by `JSON`: `-0`, `NaN`, `Infinity`, `-Infinity`, and bigint literals. +The result of evaluating the function. If the result is an object, a vanilla object containing the serializable properties of the result is returned. ## Example 1 @@ -45,7 +43,7 @@ console.log(result); // prints "56" ## Example 2 -A string can also be passed in instead of a function. +A string can also be passed in instead of a function: ```ts console.log(await executionContext.evaluate('1 + 2')); // prints "3" @@ -53,13 +51,15 @@ console.log(await executionContext.evaluate('1 + 2')); // prints "3" ## Example 3 -[JSHandle](./puppeteer.jshandle.md) instances can be passed as arguments to the `executionContext.* evaluate`: +Handles can also be passed as `args`. They resolve to their referenced object: ```ts const oneHandle = await executionContext.evaluateHandle(() => 1); const twoHandle = await executionContext.evaluateHandle(() => 2); const result = await executionContext.evaluate( - (a, b) => a + b, oneHandle, * twoHandle + (a, b) => a + b, + oneHandle, + twoHandle ); await oneHandle.dispose(); await twoHandle.dispose(); diff --git a/website/versioned_docs/version-16.1.1/api/puppeteer.executioncontext.evaluatehandle.md b/website/versioned_docs/version-16.1.1/api/puppeteer.executioncontext.evaluatehandle.md new file mode 100644 index 00000000000..d35dcfa9660 --- /dev/null +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.executioncontext.evaluatehandle.md @@ -0,0 +1,75 @@ +--- +sidebar_label: ExecutionContext.evaluateHandle +--- + +# ExecutionContext.evaluateHandle() method + +Evaluates the given function. + +Unlike [evaluate](./puppeteer.executioncontext.evaluate.md), this method returns a handle to the result of the function. + +This method may be better suited if the object cannot be serialized (e.g. `Map`) and requires further manipulation. + +**Signature:** + +```typescript +class ExecutionContext { + evaluateHandle< + Params extends unknown[], + Func extends EvaluateFunc = EvaluateFunc + >( + pageFunction: Func | string, + ...args: Params + ): Promise>>>; +} +``` + +## Parameters + +| Parameter | Type | Description | +| ------------ | -------------- | ----------------------------------------------- | +| pageFunction | Func \| string | The function to evaluate. | +| args | Params | Additional arguments to pass into the function. | + +**Returns:** + +Promise<[HandleFor](./puppeteer.handlefor.md)<Awaited<ReturnType<Func>>>> + +A [handle](./puppeteer.jshandle.md) to the result of evaluating the function. If the result is a `Node`, then this will return an [element handle](./puppeteer.elementhandle.md). + +## Example 1 + +```ts +const context = await page.mainFrame().executionContext(); +const handle: JSHandle = await context.evaluateHandle(() => + Promise.resolve(self) +); +``` + +## Example 2 + +A string can also be passed in instead of a function. + +```ts +const handle: JSHandle = await context.evaluateHandle('1 + 2'); +``` + +## Example 3 + +Handles can also be passed as `args`. They resolve to their referenced object: + +```ts +const bodyHandle: ElementHandle = await context.evaluateHandle( + () => { + return document.body; + } +); +const stringHandle: JSHandle = await context.evaluateHandle( + body => body.innerHTML, + body +); +console.log(await stringHandle.jsonValue()); // prints body's innerHTML +// Always dispose your garbage! :) +await bodyHandle.dispose(); +await stringHandle.dispose(); +``` diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.executioncontext.frame.md b/website/versioned_docs/version-16.1.1/api/puppeteer.executioncontext.frame.md similarity index 77% rename from website/versioned_docs/version-16.1.0/api/puppeteer.executioncontext.frame.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.executioncontext.frame.md index feef9b8dbdf..07afe93bd47 100644 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.executioncontext.frame.md +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.executioncontext.frame.md @@ -20,4 +20,4 @@ The frame associated with this execution context. ## Remarks -Not every execution context is associated with a frame. For example, workers and extensions have execution contexts that are not associated with frames. +Not every execution context is associated with a frame. For example, [workers](./puppeteer.webworker.md) have execution contexts that are not associated with frames. diff --git a/website/versioned_docs/version-16.1.1/api/puppeteer.executioncontext.md b/website/versioned_docs/version-16.1.1/api/puppeteer.executioncontext.md new file mode 100644 index 00000000000..d59ee4c1156 --- /dev/null +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.executioncontext.md @@ -0,0 +1,38 @@ +--- +sidebar_label: ExecutionContext +--- + +# ExecutionContext class + +> Warning: This API is now obsolete. +> +> Do not use directly. +> +> Represents a context for JavaScript execution. + +**Signature:** + +```typescript +export declare class ExecutionContext +``` + +## Remarks + +Besides pages, execution contexts can be found in [workers](./puppeteer.webworker.md). + +The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `ExecutionContext` class. + +## Example + +A [Page](./puppeteer.page.md) can have several execution contexts: + +- Each [Frame](./puppeteer.frame.md) of a [page](./puppeteer.page.md) has a "default" execution context that is always created after frame is attached to DOM. This context is returned by the [Frame.executionContext()](./puppeteer.frame.executioncontext.md) method. - Each [Chrome extensions](https://developer.chrome.com/extensions) creates additional execution contexts to isolate their code. + +## Methods + +| Method | Modifiers | Description | +| ------------------------------------------------------------------------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [evaluate(pageFunction, args)](./puppeteer.executioncontext.evaluate.md) | | Evaluates the given function. | +| [evaluateHandle(pageFunction, args)](./puppeteer.executioncontext.evaluatehandle.md) | |

Evaluates the given function.

Unlike [evaluate](./puppeteer.executioncontext.evaluate.md), this method returns a handle to the result of the function.

This method may be better suited if the object cannot be serialized (e.g. Map) and requires further manipulation.

| +| [frame()](./puppeteer.executioncontext.frame.md) | | | +| [queryObjects(prototypeHandle)](./puppeteer.executioncontext.queryobjects.md) | | Iterates through the JavaScript heap and finds all the objects with the given prototype. | diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.executioncontext.queryobjects.md b/website/versioned_docs/version-16.1.1/api/puppeteer.executioncontext.queryobjects.md similarity index 92% rename from website/versioned_docs/version-16.1.0/api/puppeteer.executioncontext.queryobjects.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.executioncontext.queryobjects.md index 400fdb41048..8b55d68b0ce 100644 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.executioncontext.queryobjects.md +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.executioncontext.queryobjects.md @@ -4,7 +4,7 @@ sidebar_label: ExecutionContext.queryObjects # ExecutionContext.queryObjects() method -This method iterates the JavaScript heap and finds all the objects with the given prototype. +Iterates through the JavaScript heap and finds all the objects with the given prototype. **Signature:** @@ -28,8 +28,6 @@ Promise<[HandleFor](./puppeteer.handlefor.md)<Prototype\[\]>> A handle to an array of objects with the given prototype. -## Remarks - ## Example ```ts diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.filechooser.accept.md b/website/versioned_docs/version-16.1.1/api/puppeteer.filechooser.accept.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.filechooser.accept.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.filechooser.accept.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.filechooser.cancel.md b/website/versioned_docs/version-16.1.1/api/puppeteer.filechooser.cancel.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.filechooser.cancel.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.filechooser.cancel.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.filechooser.ismultiple.md b/website/versioned_docs/version-16.1.1/api/puppeteer.filechooser.ismultiple.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.filechooser.ismultiple.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.filechooser.ismultiple.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.filechooser.md b/website/versioned_docs/version-16.1.1/api/puppeteer.filechooser.md similarity index 84% rename from website/versioned_docs/version-16.1.0/api/puppeteer.filechooser.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.filechooser.md index 8eaae182b2f..589056b165a 100644 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.filechooser.md +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.filechooser.md @@ -14,14 +14,14 @@ export declare class FileChooser ## Remarks -`FileChooser` objects are returned via the `page.waitForFileChooser` method. +`FileChooser` instances are returned via the [Page.waitForFileChooser()](./puppeteer.page.waitforfilechooser.md) method. + +In browsers, only one file chooser can be opened at a time. All file choosers must be accepted or canceled. Not doing so will prevent subsequent file choosers from appearing. The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `FileChooser` class. ## Example -An example of using `FileChooser`: - ```ts const [fileChooser] = await Promise.all([ page.waitForFileChooser(), @@ -30,8 +30,6 @@ const [fileChooser] = await Promise.all([ await fileChooser.accept(['/tmp/myfile.pdf']); ``` -\*\*NOTE\*\* In browsers, only one file chooser can be opened at a time. All file choosers must be accepted or canceled. Not doing so will prevent subsequent file choosers from appearing. - ## Methods | Method | Modifiers | Description | diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.flattenhandle.md b/website/versioned_docs/version-16.1.1/api/puppeteer.flattenhandle.md similarity index 100% rename from website/versioned_docs/version-16.1.0/api/puppeteer.flattenhandle.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.flattenhandle.md diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.frame._.md b/website/versioned_docs/version-16.1.1/api/puppeteer.frame._.md similarity index 51% rename from website/versioned_docs/version-16.1.0/api/puppeteer.frame._.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.frame._.md index 1e29bcb8e25..d9f5cb8842d 100644 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.frame._.md +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.frame._.md @@ -4,7 +4,7 @@ sidebar_label: Frame.$ # Frame.$() method -This method queries the frame for the given selector. +Queries the frame for an element matching the given selector. **Signature:** @@ -18,12 +18,12 @@ class Frame { ## Parameters -| Parameter | Type | Description | -| --------- | -------- | ------------------------ | -| selector | Selector | a selector to query for. | +| Parameter | Type | Description | +| --------- | -------- | -------------------------- | +| selector | Selector | The selector to query for. | **Returns:** Promise<[ElementHandle](./puppeteer.elementhandle.md)<[NodeFor](./puppeteer.nodefor.md)<Selector>> \| null> -A promise which resolves to an `ElementHandle` pointing at the element, or `null` if it was not found. +A [element handle](./puppeteer.elementhandle.md) to the first element matching the given selector. Otherwise, `null`. diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.__.md b/website/versioned_docs/version-16.1.1/api/puppeteer.frame.__.md similarity index 52% rename from website/versioned_docs/version-16.1.0/api/puppeteer.frame.__.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.frame.__.md index 7b296cbd2c1..66cc18995ff 100644 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.__.md +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.frame.__.md @@ -4,7 +4,7 @@ sidebar_label: Frame.$$ # Frame.$$() method -This runs `document.querySelectorAll` in the frame and returns the result. +Queries the frame for all elements matching the given selector. **Signature:** @@ -18,12 +18,12 @@ class Frame { ## Parameters -| Parameter | Type | Description | -| --------- | -------- | ------------------------ | -| selector | Selector | a selector to search for | +| Parameter | Type | Description | +| --------- | -------- | -------------------------- | +| selector | Selector | The selector to query for. | **Returns:** Promise<Array<[ElementHandle](./puppeteer.elementhandle.md)<[NodeFor](./puppeteer.nodefor.md)<Selector>>>> -An array of element handles pointing to the found frame elements. +An array of [element handles](./puppeteer.elementhandle.md) that point to elements matching the given selector. diff --git a/website/versioned_docs/version-16.1.1/api/puppeteer.frame.__eval.md b/website/versioned_docs/version-16.1.1/api/puppeteer.frame.__eval.md new file mode 100644 index 00000000000..2007e355832 --- /dev/null +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.frame.__eval.md @@ -0,0 +1,47 @@ +--- +sidebar_label: Frame.$$eval +--- + +# Frame.$$eval() method + +Runs the given function on an array of elements matching the given selector in the frame. + +If the given function returns a promise, then this method will wait till the promise resolves. + +**Signature:** + +```typescript +class Frame { + $$eval< + Selector extends string, + Params extends unknown[], + Func extends EvaluateFunc< + [Array>, ...Params] + > = EvaluateFunc<[Array>, ...Params]> + >( + selector: Selector, + pageFunction: Func | string, + ...args: Params + ): Promise>>; +} +``` + +## Parameters + +| Parameter | Type | Description | +| ------------ | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | +| selector | Selector | The selector to query for. | +| pageFunction | Func \| string | The function to be evaluated in the frame's context. An array of elements matching the given selector will be passed to the function as its first argument. | +| args | Params | Additional arguments to pass to pageFunction. | + +**Returns:** + +Promise<Awaited<ReturnType<Func>>> + +A promise to the result of the function. + +## Example + +```js +const divsCounts = await frame.$$eval('div', divs => divs.length); +``` diff --git a/website/versioned_docs/version-16.1.1/api/puppeteer.frame._eval.md b/website/versioned_docs/version-16.1.1/api/puppeteer.frame._eval.md new file mode 100644 index 00000000000..0c6589a18a1 --- /dev/null +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.frame._eval.md @@ -0,0 +1,47 @@ +--- +sidebar_label: Frame.$eval +--- + +# Frame.$eval() method + +Runs the given function on the first element matching the given selector in the frame. + +If the given function returns a promise, then this method will wait till the promise resolves. + +**Signature:** + +```typescript +class Frame { + $eval< + Selector extends string, + Params extends unknown[], + Func extends EvaluateFunc< + [ElementHandle>, ...Params] + > = EvaluateFunc<[ElementHandle>, ...Params]> + >( + selector: Selector, + pageFunction: Func | string, + ...args: Params + ): Promise>>; +} +``` + +## Parameters + +| Parameter | Type | Description | +| ------------ | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | +| selector | Selector | The selector to query for. | +| pageFunction | Func \| string | The function to be evaluated in the frame's context. The first element matching the selector will be passed to the function as its first argument. | +| args | Params | Additional arguments to pass to pageFunction. | + +**Returns:** + +Promise<Awaited<ReturnType<Func>>> + +A promise to the result of the function. + +## Example + +```ts +const searchValue = await frame.$eval('#search', el => el.value); +``` diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.frame._x.md b/website/versioned_docs/version-16.1.1/api/puppeteer.frame._x.md similarity index 71% rename from website/versioned_docs/version-16.1.0/api/puppeteer.frame._x.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.frame._x.md index e2290048e6d..dd7a17b49cb 100644 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.frame._x.md +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.frame._x.md @@ -4,7 +4,11 @@ sidebar_label: Frame.$x # Frame.$x() method -This method evaluates the given XPath expression and returns the results. +> Warning: This API is now obsolete. +> +> Use [Frame.$$()](./puppeteer.frame.__.md) with the `xpath` prefix. +> +> This method evaluates the given XPath expression and returns the results. **Signature:** diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.addscripttag.md b/website/versioned_docs/version-16.1.1/api/puppeteer.frame.addscripttag.md similarity index 79% rename from website/versioned_docs/version-16.1.0/api/puppeteer.frame.addscripttag.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.frame.addscripttag.md index 3baf564eabf..67e2638507e 100644 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.addscripttag.md +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.frame.addscripttag.md @@ -18,9 +18,9 @@ class Frame { ## Parameters -| Parameter | Type | Description | -| --------- | ------------------------------------------------------------------- | ---------------------------------------- | -| options | [FrameAddScriptTagOptions](./puppeteer.frameaddscripttagoptions.md) | configure the script to add to the page. | +| Parameter | Type | Description | +| --------- | ------------------------------------------------------------------- | ----------------------- | +| options | [FrameAddScriptTagOptions](./puppeteer.frameaddscripttagoptions.md) | Options for the script. | **Returns:** diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.addstyletag.md b/website/versioned_docs/version-16.1.1/api/puppeteer.frame.addstyletag.md similarity index 62% rename from website/versioned_docs/version-16.1.0/api/puppeteer.frame.addstyletag.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.frame.addstyletag.md index e5a13076276..5b00d734afa 100644 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.addstyletag.md +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.frame.addstyletag.md @@ -10,18 +10,20 @@ Adds a `` tag into the page with the desired url or a `>; + addStyleTag( + options: FrameAddStyleTagOptions + ): Promise>; } ``` ## Parameters -| Parameter | Type | Description | -| --------- | ----------------------------------------------------------------- | ------------------------------------- | -| options | [FrameAddStyleTagOptions](./puppeteer.frameaddstyletagoptions.md) | configure the CSS to add to the page. | +| Parameter | Type | Description | +| --------- | ----------------------------------------------------------------- | --------------------------- | +| options | [FrameAddStyleTagOptions](./puppeteer.frameaddstyletagoptions.md) | Options for the style link. | **Returns:** -Promise<[ElementHandle](./puppeteer.elementhandle.md)<Node>> +Promise<[ElementHandle](./puppeteer.elementhandle.md)<HTMLStyleElement \| HTMLLinkElement>> a promise that resolves to the added tag when the stylesheets's `onload` event fires or when the CSS content was injected into the frame. diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.childframes.md b/website/versioned_docs/version-16.1.1/api/puppeteer.frame.childframes.md similarity index 88% rename from website/versioned_docs/version-16.1.0/api/puppeteer.frame.childframes.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.frame.childframes.md index 809d6cbbd4f..353407e90d1 100644 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.childframes.md +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.frame.childframes.md @@ -16,4 +16,4 @@ class Frame { [Frame](./puppeteer.frame.md)\[\] -an array of child frames. +An array of child frames. diff --git a/website/versioned_docs/version-16.1.1/api/puppeteer.frame.click.md b/website/versioned_docs/version-16.1.1/api/puppeteer.frame.click.md new file mode 100644 index 00000000000..b250ef5cf18 --- /dev/null +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.frame.click.md @@ -0,0 +1,44 @@ +--- +sidebar_label: Frame.click +--- + +# Frame.click() method + +Clicks the first element found that matches `selector`. + +**Signature:** + +```typescript +class Frame { + click( + selector: string, + options?: { + delay?: number; + button?: MouseButton; + clickCount?: number; + } + ): Promise; +} +``` + +## Parameters + +| Parameter | Type | Description | +| --------- | -------------------------------------------------------------------------------------------- | -------------------------- | +| selector | string | The selector to query for. | +| options | { delay?: number; button?: [MouseButton](./puppeteer.mousebutton.md); clickCount?: number; } | (Optional) | + +**Returns:** + +Promise<void> + +## Remarks + +If `click()` triggers a navigation event and there's a separate `page.waitForNavigation()` promise to be resolved, you may end up with a race condition that yields unexpected results. The correct pattern for click and wait for navigation is the following: + +```ts +const [response] = await Promise.all([ + page.waitForNavigation(waitOptions), + frame.click(selector, clickOptions), +]); +``` diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.content.md b/website/versioned_docs/version-16.1.1/api/puppeteer.frame.content.md similarity index 75% rename from website/versioned_docs/version-16.1.0/api/puppeteer.frame.content.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.frame.content.md index 7d44372825a..61640b6db38 100644 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.content.md +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.frame.content.md @@ -16,4 +16,4 @@ class Frame { Promise<string> -the full HTML contents of the frame, including the doctype. +The full HTML contents of the frame, including the DOCTYPE. diff --git a/website/versioned_docs/version-16.1.1/api/puppeteer.frame.evaluate.md b/website/versioned_docs/version-16.1.1/api/puppeteer.frame.evaluate.md new file mode 100644 index 00000000000..9804c36a002 --- /dev/null +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.frame.evaluate.md @@ -0,0 +1,32 @@ +--- +sidebar_label: Frame.evaluate +--- + +# Frame.evaluate() method + +Behaves identically to [Page.evaluate()](./puppeteer.page.evaluate.md) except it's run within the the context of this frame. + +**Signature:** + +```typescript +class Frame { + evaluate< + Params extends unknown[], + Func extends EvaluateFunc = EvaluateFunc + >( + pageFunction: Func | string, + ...args: Params + ): Promise>>; +} +``` + +## Parameters + +| Parameter | Type | Description | +| ------------ | -------------- | ----------- | +| pageFunction | Func \| string | | +| args | Params | | + +**Returns:** + +Promise<Awaited<ReturnType<Func>>> diff --git a/website/versioned_docs/version-16.1.1/api/puppeteer.frame.evaluatehandle.md b/website/versioned_docs/version-16.1.1/api/puppeteer.frame.evaluatehandle.md new file mode 100644 index 00000000000..0532cf177a9 --- /dev/null +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.frame.evaluatehandle.md @@ -0,0 +1,32 @@ +--- +sidebar_label: Frame.evaluateHandle +--- + +# Frame.evaluateHandle() method + +Behaves identically to [Page.evaluateHandle()](./puppeteer.page.evaluatehandle.md) except it's run within the context of this frame. + +**Signature:** + +```typescript +class Frame { + evaluateHandle< + Params extends unknown[], + Func extends EvaluateFunc = EvaluateFunc + >( + pageFunction: Func | string, + ...args: Params + ): Promise>>>; +} +``` + +## Parameters + +| Parameter | Type | Description | +| ------------ | -------------- | ----------- | +| pageFunction | Func \| string | | +| args | Params | | + +**Returns:** + +Promise<[HandleFor](./puppeteer.handlefor.md)<Awaited<ReturnType<Func>>>> diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.executioncontext.md b/website/versioned_docs/version-16.1.1/api/puppeteer.frame.executioncontext.md similarity index 79% rename from website/versioned_docs/version-16.1.0/api/puppeteer.frame.executioncontext.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.frame.executioncontext.md index cb6c95555bb..9a364c79a56 100644 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.executioncontext.md +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.frame.executioncontext.md @@ -4,6 +4,10 @@ sidebar_label: Frame.executionContext # Frame.executionContext() method +> Warning: This API is now obsolete. +> +> Do not use the execution context directly. + **Signature:** ```typescript diff --git a/website/versioned_docs/version-16.1.1/api/puppeteer.frame.focus.md b/website/versioned_docs/version-16.1.1/api/puppeteer.frame.focus.md new file mode 100644 index 00000000000..952fee0e064 --- /dev/null +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.frame.focus.md @@ -0,0 +1,29 @@ +--- +sidebar_label: Frame.focus +--- + +# Frame.focus() method + +Focuses the first element that matches the `selector`. + +**Signature:** + +```typescript +class Frame { + focus(selector: string): Promise; +} +``` + +## Parameters + +| Parameter | Type | Description | +| --------- | ------ | -------------------------- | +| selector | string | The selector to query for. | + +**Returns:** + +Promise<void> + +## Exceptions + +Throws if there's no element matching `selector`. diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.goto.md b/website/versioned_docs/version-16.1.1/api/puppeteer.frame.goto.md similarity index 71% rename from website/versioned_docs/version-16.1.0/api/puppeteer.frame.goto.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.frame.goto.md index 205d3538626..02c4930f0c5 100644 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.goto.md +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.frame.goto.md @@ -4,6 +4,8 @@ sidebar_label: Frame.goto # Frame.goto() method +Navigates a frame to the given url. + **Signature:** ```typescript @@ -32,20 +34,20 @@ Promise<[HTTPResponse](./puppeteer.httpresponse.md) \| null> A promise which resolves to the main resource response. In case of multiple redirects, the navigation will resolve with the response of the last redirect. +## Exceptions + +This method will throw an error if: + +- there's an SSL error (e.g. in case of self-signed certificates). - target URL is invalid. - the `timeout` is exceeded during navigation. - the remote server does not respond or is unreachable. - the main resource failed to load. + +This method will not throw an error when any valid HTTP status code is returned by the remote server, including 404 "Not Found" and 500 "Internal Server Error". The status code for such responses can be retrieved by calling [HTTPResponse.status()](./puppeteer.httpresponse.status.md). + ## Remarks -`frame.goto` will throw an error if: - there's an SSL error (e.g. in case of self-signed certificates). +Navigation to `about:blank` or navigation to the same URL with a different hash will succeed and return `null`. -- target URL is invalid. +:::warning -- the `timeout` is exceeded during navigation. +Headless mode doesn't support navigation to a PDF document. See the [upstream issue](https://bugs.chromium.org/p/chromium/issues/detail?id=761295). -- the remote server does not respond or is unreachable. - -- the main resource failed to load. - -`frame.goto` will not throw an error when any valid HTTP status code is returned by the remote server, including 404 "Not Found" and 500 "Internal Server Error". The status code for such responses can be retrieved by calling [HTTPResponse.status()](./puppeteer.httpresponse.status.md). - -NOTE: `frame.goto` either throws an error or returns a main resource response. The only exceptions are navigation to `about:blank` or navigation to the same URL with a different hash, which would succeed and return `null`. - -NOTE: Headless mode doesn't support navigation to a PDF document. See the [upstream issue](https://bugs.chromium.org/p/chromium/issues/detail?id=761295). +::: diff --git a/website/versioned_docs/version-16.1.1/api/puppeteer.frame.hover.md b/website/versioned_docs/version-16.1.1/api/puppeteer.frame.hover.md new file mode 100644 index 00000000000..b4f1fd7c9d0 --- /dev/null +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.frame.hover.md @@ -0,0 +1,29 @@ +--- +sidebar_label: Frame.hover +--- + +# Frame.hover() method + +Hovers the pointer over the center of the first element that matches the `selector`. + +**Signature:** + +```typescript +class Frame { + hover(selector: string): Promise; +} +``` + +## Parameters + +| Parameter | Type | Description | +| --------- | ------ | -------------------------- | +| selector | string | The selector to query for. | + +**Returns:** + +Promise<void> + +## Exceptions + +Throws if there's no element matching `selector`. diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.isdetached.md b/website/versioned_docs/version-16.1.1/api/puppeteer.frame.isdetached.md similarity index 73% rename from website/versioned_docs/version-16.1.0/api/puppeteer.frame.isdetached.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.frame.isdetached.md index 57a02d8ddd4..72c96a2fc8a 100644 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.isdetached.md +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.frame.isdetached.md @@ -16,4 +16,4 @@ class Frame { boolean -`true` if the frame has been detached, or `false` otherwise. +`true` if the frame has been detached. Otherwise, `false`. diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.isoopframe.md b/website/versioned_docs/version-16.1.1/api/puppeteer.frame.isoopframe.md similarity index 69% rename from website/versioned_docs/version-16.1.0/api/puppeteer.frame.isoopframe.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.frame.isoopframe.md index 83d2a759125..c818d8a2f6b 100644 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.isoopframe.md +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.frame.isoopframe.md @@ -16,6 +16,4 @@ class Frame { boolean -`true` if the frame is an OOP frame, or `false` otherwise. - -## Remarks +`true` if the frame is an out-of-process (OOP) frame. Otherwise, `false`. diff --git a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.md b/website/versioned_docs/version-16.1.1/api/puppeteer.frame.md similarity index 56% rename from website/versioned_docs/version-16.1.0/api/puppeteer.frame.md rename to website/versioned_docs/version-16.1.1/api/puppeteer.frame.md index a69bb57dbe2..54a9e0ff4c3 100644 --- a/website/versioned_docs/version-16.1.0/api/puppeteer.frame.md +++ b/website/versioned_docs/version-16.1.1/api/puppeteer.frame.md @@ -4,7 +4,9 @@ sidebar_label: Frame # Frame class -At every point of time, page exposes its current frame tree via the [page.mainFrame](./puppeteer.page.mainframe.md) and [frame.childFrames](./puppeteer.frame.childframes.md) methods. +Represents a DOM frame. + +To understand frames, you can think of frames as `