chore(main): release 17.1.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "17.0.0"
+  ".": "17.1.0"
 }

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.
 
+## [17.1.0](https://github.com/puppeteer/puppeteer/compare/v17.0.0...v17.1.0) (2022-09-02)
+
+
+### Features
+
+* **chromium:** roll to Chromium 106.0.5249.0 (r1036745) ([#8869](https://github.com/puppeteer/puppeteer/issues/8869)) ([6e9a47a](https://github.com/puppeteer/puppeteer/commit/6e9a47a6faa06d241dec0bcf7bcdf49370517008))
+
+
+### Bug Fixes
+
+* allow getting a frame from an elementhandle ([#8875](https://github.com/puppeteer/puppeteer/issues/8875)) ([3732757](https://github.com/puppeteer/puppeteer/commit/3732757450b4363041ccbacc3b236289a156abb0))
+* typos in documentation ([#8858](https://github.com/puppeteer/puppeteer/issues/8858)) ([8d95a9b](https://github.com/puppeteer/puppeteer/commit/8d95a9bc920b98820aa655ad4eb2d8fd9b2b893a))
+* use the timeout setting in waitForFileChooser ([#8856](https://github.com/puppeteer/puppeteer/issues/8856)) ([f477b46](https://github.com/puppeteer/puppeteer/commit/f477b46f212da9206102da695697760eea539f05))
+
 ## [17.0.0](https://github.com/puppeteer/puppeteer/compare/v16.2.0...v17.0.0) (2022-08-26)
 
 

docs/chromium-support.md

@@ -8,6 +8,7 @@ The following versions of Chromium are supported, mapped to Puppeteer version:
 
 <!-- version-start -->
 
+- Chromium 106.0.5249.0 - [Puppeteer v17.1.0](https://pptr.dev/17.1.0)
 - Chromium 105.0.5173.0 - [Puppeteer v15.5.0](https://github.com/puppeteer/puppeteer/blob/v15.5.0/docs/api/index.md)
 - Chromium 104.0.5109.0 - Puppeteer v15.1.0
 - Chromium 103.0.5059.0 - [Puppeteer v14.2.0](https://github.com/puppeteer/puppeteer/blob/v14.2.0/docs/api.md)

package.json

@@ -1,6 +1,6 @@
 {
   "name": "puppeteer",
-  "version": "17.0.0",
+  "version": "17.1.0",
   "description": "A high-level API to control headless Chrome over the DevTools Protocol",
   "keywords": [
     "puppeteer",

versions.js

@@ -17,7 +17,7 @@
 const versionsPerRelease = new Map([
   // This is a mapping from Chromium version => Puppeteer version.
   // In Chromium roll patches, use `NEXT` for the Puppeteer version.
-  ['106.0.5249.0', 'NEXT'],
+  ['106.0.5249.0', 'v17.1.0'],
   ['105.0.5173.0', 'v15.5.0'],
   ['104.0.5109.0', 'v15.1.0'],
   ['103.0.5059.0', 'v14.2.0'],

website/versioned_docs/version-17.0.0/api/puppeteer.clickoptions.md → website/versioned_docs/version-17.1.0/api/puppeteer.clickoptions.md

@@ -17,4 +17,4 @@ export interface ClickOptions
 | [button?](./puppeteer.clickoptions.button.md)         |           | [MouseButton](./puppeteer.mousebutton.md) | <i>(Optional)</i>                                                                                       |
 | [clickCount?](./puppeteer.clickoptions.clickcount.md) |           | number                                    | <i>(Optional)</i>                                                                                       |
 | [delay?](./puppeteer.clickoptions.delay.md)           |           | number                                    | <i>(Optional)</i> Time to wait between <code>mousedown</code> and <code>mouseup</code> in milliseconds. |
-| [offset?](./puppeteer.clickoptions.offset.md)         |           | [Offset](./puppeteer.offset.md)           | <i>(Optional)</i> Offset for the clickable point relative to the top-left corder of the border box.     |
+| [offset?](./puppeteer.clickoptions.offset.md)         |           | [Offset](./puppeteer.offset.md)           | <i>(Optional)</i> Offset for the clickable point relative to the top-left corner of the border box.     |

website/versioned_docs/version-17.0.0/api/puppeteer.clickoptions.offset.md → website/versioned_docs/version-17.1.0/api/puppeteer.clickoptions.offset.md

@@ -4,7 +4,7 @@ sidebar_label: ClickOptions.offset
 
 # ClickOptions.offset property
 
-Offset for the clickable point relative to the top-left corder of the border box.
+Offset for the clickable point relative to the top-left corner of the border box.
 
 **Signature:**
 

website/versioned_docs/version-17.1.0/api/puppeteer.elementhandle.frame.md

@@ -0,0 +1,13 @@
+---
+sidebar_label: ElementHandle.frame
+---
+
+# ElementHandle.frame property
+
+**Signature:**
+
+```typescript
+class ElementHandle {
+  get frame(): Frame;
+}
+```

website/versioned_docs/version-17.0.0/api/puppeteer.elementhandle.md → website/versioned_docs/version-17.1.0/api/puppeteer.elementhandle.md

@@ -39,6 +39,12 @@ If you're using TypeScript, ElementHandle takes a generic argument that denotes
 
 The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `ElementHandle` class.
 
+## Properties
+
+| Property                                    | Modifiers             | Type                          | Description |
+| ------------------------------------------- | --------------------- | ----------------------------- | ----------- |
+| [frame](./puppeteer.elementhandle.frame.md) | <code>readonly</code> | [Frame](./puppeteer.frame.md) |             |
+
 ## Methods
 
 | Method                                                                                       | Modifiers | Description                                                                                                                                                                                                                                                                                                                   |

website/versioned_docs/version-17.0.0/api/puppeteer.frame.addscripttag.md → website/versioned_docs/version-17.1.0/api/puppeteer.frame.addscripttag.md

@@ -26,4 +26,4 @@ class Frame {
 
 Promise<[ElementHandle](./puppeteer.elementhandle.md)<HTMLScriptElement>>
 
-a promise that resolves to the added tag when the script's `onload` event fires or when the script content was injected into the frame.
+An [element handle](./puppeteer.elementhandle.md) to the injected `<script>` element.

website/versioned_docs/version-17.1.0/api/puppeteer.frame.addstyletag.md

@@ -0,0 +1,29 @@
+---
+sidebar_label: Frame.addStyleTag
+---
+
+# Frame.addStyleTag() method
+
+Adds a `<link rel="stylesheet">` tag into the page with the desired URL or a `<style type="text/css">` tag with the content.
+
+**Signature:**
+
+```typescript
+class Frame {
+  addStyleTag(
+    options: Omit<FrameAddStyleTagOptions, 'url'>
+  ): Promise<ElementHandle<HTMLStyleElement>>;
+}
+```
+
+## Parameters
+
+| Parameter | Type                                                                                 | Description |
+| --------- | ------------------------------------------------------------------------------------ | ----------- |
+| options   | Omit&lt;[FrameAddStyleTagOptions](./puppeteer.frameaddstyletagoptions.md), 'url'&gt; |             |
+
+**Returns:**
+
+Promise&lt;[ElementHandle](./puppeteer.elementhandle.md)&lt;HTMLStyleElement&gt;&gt;
+
+An [element handle](./puppeteer.elementhandle.md) to the loaded `<link>` or `<style>` element.

website/versioned_docs/version-17.1.0/api/puppeteer.frame.addstyletag_1.md

@@ -0,0 +1,25 @@
+---
+sidebar_label: Frame.addStyleTag_1
+---
+
+# Frame.addStyleTag() method
+
+**Signature:**
+
+```typescript
+class Frame {
+  addStyleTag(
+    options: FrameAddStyleTagOptions
+  ): Promise<ElementHandle<HTMLLinkElement>>;
+}
+```
+
+## Parameters
+
+| Parameter | Type                                                              | Description |
+| --------- | ----------------------------------------------------------------- | ----------- |
+| options   | [FrameAddStyleTagOptions](./puppeteer.frameaddstyletagoptions.md) |             |
+
+**Returns:**
+
+Promise&lt;[ElementHandle](./puppeteer.elementhandle.md)&lt;HTMLLinkElement&gt;&gt;

website/versioned_docs/version-17.0.0/api/puppeteer.frame.md → website/versioned_docs/version-17.1.0/api/puppeteer.frame.md

@@ -69,7 +69,8 @@ console.log(text);
 | [$eval(selector, pageFunction, args)](./puppeteer.frame._eval.md)                    |           | <p>Runs the given function on the first element matching the given selector in the frame.</p><p>If the given function returns a promise, then this method will wait till the promise resolves.</p>                                                                         |
 | [$x(expression)](./puppeteer.frame._x.md)                                            |           |                                                                                                                                                                                                                                                                            |
 | [addScriptTag(options)](./puppeteer.frame.addscripttag.md)                           |           | Adds a <code>&lt;script&gt;</code> tag into the page with the desired url or content.                                                                                                                                                                                      |
-| [addStyleTag(options)](./puppeteer.frame.addstyletag.md)                             |           | Adds a <code>&lt;link rel=&quot;stylesheet&quot;&gt;</code> tag into the page with the desired url or a <code>&lt;style type=&quot;text/css&quot;&gt;</code> tag with the content.                                                                                         |
+| [addStyleTag(options)](./puppeteer.frame.addstyletag.md)                             |           | Adds a <code>&lt;link rel=&quot;stylesheet&quot;&gt;</code> tag into the page with the desired URL or a <code>&lt;style type=&quot;text/css&quot;&gt;</code> tag with the content.                                                                                         |
+| [addStyleTag(options)](./puppeteer.frame.addstyletag_1.md)                           |           |                                                                                                                                                                                                                                                                            |
 | [childFrames()](./puppeteer.frame.childframes.md)                                    |           |                                                                                                                                                                                                                                                                            |
 | [click(selector, options)](./puppeteer.frame.click.md)                               |           | Clicks the first element found that matches <code>selector</code>.                                                                                                                                                                                                         |
 | [content()](./puppeteer.frame.content.md)                                            |           |                                                                                                                                                                                                                                                                            |

website/versioned_docs/version-17.0.0/api/puppeteer.frameaddscripttagoptions.content.md → website/versioned_docs/version-17.1.0/api/puppeteer.frameaddscripttagoptions.content.md

@@ -4,7 +4,7 @@ sidebar_label: FrameAddScriptTagOptions.content
 
 # FrameAddScriptTagOptions.content property
 
-Raw JavaScript content to be injected into the frame.
+JavaScript to be injected into the frame.
 
 **Signature:**
 

website/versioned_docs/version-17.1.0/api/puppeteer.frameaddscripttagoptions.id.md

@@ -0,0 +1,15 @@
+---
+sidebar_label: FrameAddScriptTagOptions.id
+---
+
+# FrameAddScriptTagOptions.id property
+
+Sets the `id` of the script.
+
+**Signature:**
+
+```typescript
+interface FrameAddScriptTagOptions {
+  id?: string;
+}
+```

website/versioned_docs/version-17.0.0/api/puppeteer.frameaddscripttagoptions.md → website/versioned_docs/version-17.1.0/api/puppeteer.frameaddscripttagoptions.md

@@ -12,9 +12,10 @@ export interface FrameAddScriptTagOptions
 
 ## Properties
 
-| Property                                                    | Modifiers | Type   | Description                                                                                                      |
-| ----------------------------------------------------------- | --------- | ------ | ---------------------------------------------------------------------------------------------------------------- |
-| [content?](./puppeteer.frameaddscripttagoptions.content.md) |           | string | <i>(Optional)</i> Raw JavaScript content to be injected into the frame.                                          |
-| [path?](./puppeteer.frameaddscripttagoptions.path.md)       |           | string | <i>(Optional)</i> The path to a JavaScript file to be injected into the frame.                                   |
-| [type?](./puppeteer.frameaddscripttagoptions.type.md)       |           | string | <i>(Optional)</i> Set the script's <code>type</code>. Use <code>module</code> in order to load an ES2015 module. |
-| [url?](./puppeteer.frameaddscripttagoptions.url.md)         |           | string | <i>(Optional)</i> the URL of the script to be added.                                                             |
+| Property                                                    | Modifiers | Type   | Description                                                                                                            |
+| ----------------------------------------------------------- | --------- | ------ | ---------------------------------------------------------------------------------------------------------------------- |
+| [content?](./puppeteer.frameaddscripttagoptions.content.md) |           | string | <i>(Optional)</i> JavaScript to be injected into the frame.                                                            |
+| [id?](./puppeteer.frameaddscripttagoptions.id.md)           |           | string | <i>(Optional)</i> Sets the <code>id</code> of the script.                                                              |
+| [path?](./puppeteer.frameaddscripttagoptions.path.md)       |           | string | <i>(Optional)</i> Path to a JavaScript file to be injected into the frame.                                             |
+| [type?](./puppeteer.frameaddscripttagoptions.type.md)       |           | string | <i>(Optional)</i> Sets the <code>type</code> of the script. Use <code>module</code> in order to load an ES2015 module. |
+| [url?](./puppeteer.frameaddscripttagoptions.url.md)         |           | string | <i>(Optional)</i> URL of the script to be added.                                                                       |

website/versioned_docs/version-17.0.0/api/puppeteer.frameaddscripttagoptions.path.md → website/versioned_docs/version-17.1.0/api/puppeteer.frameaddscripttagoptions.path.md

@@ -4,7 +4,7 @@ sidebar_label: FrameAddScriptTagOptions.path
 
 # FrameAddScriptTagOptions.path property
 
-The path to a JavaScript file to be injected into the frame.
+Path to a JavaScript file to be injected into the frame.
 
 **Signature:**
 

website/versioned_docs/version-17.0.0/api/puppeteer.frameaddscripttagoptions.type.md → website/versioned_docs/version-17.1.0/api/puppeteer.frameaddscripttagoptions.type.md

@@ -4,7 +4,7 @@ sidebar_label: FrameAddScriptTagOptions.type
 
 # FrameAddScriptTagOptions.type property
 
-Set the script's `type`. Use `module` in order to load an ES2015 module.
+Sets the `type` of the script. Use `module` in order to load an ES2015 module.
 
 **Signature:**
 

website/versioned_docs/version-17.0.0/api/puppeteer.frameaddscripttagoptions.url.md → website/versioned_docs/version-17.1.0/api/puppeteer.frameaddscripttagoptions.url.md

@@ -4,7 +4,7 @@ sidebar_label: FrameAddScriptTagOptions.url
 
 # FrameAddScriptTagOptions.url property
 
-the URL of the script to be added.
+URL of the script to be added.
 
 **Signature:**