chore: release main (#12375)

Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>

.release-please-manifest.json

@@ -1,6 +1,6 @@
 {
-  "packages/puppeteer": "22.7.1",
-  "packages/puppeteer-core": "22.7.1",
+  "packages/puppeteer": "22.8.0",
+  "packages/puppeteer-core": "22.8.0",
   "packages/testserver": "0.6.0",
   "packages/ng-schematics": "0.6.0",
   "packages/browsers": "2.2.3"

docs/supported-browsers.md

@@ -10,6 +10,7 @@ The following versions of the browsers are supported, mapped to Puppeteer versio
 
 <!-- version-start -->
 
+- [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) 124.0.6367.91 - [Puppeteer v22.8.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v22.8.0/docs/api/index.md)
 - [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) 124.0.6367.78 - [Puppeteer v22.7.1](https://github.com/puppeteer/puppeteer/blob/puppeteer-v22.7.1/docs/api/index.md)
 - [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) 124.0.6367.60 - [Puppeteer v22.7.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v22.7.0/docs/api/index.md)
 - [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) 123.0.6312.122 - [Puppeteer v22.6.4](https://github.com/puppeteer/puppeteer/blob/puppeteer-v22.6.4/docs/api/index.md)

package-lock.json

@@ -11842,14 +11842,14 @@
       }
     },
     "packages/puppeteer": {
-      "version": "22.7.1",
+      "version": "22.8.0",
       "hasInstallScript": true,
       "license": "Apache-2.0",
       "dependencies": {
         "@puppeteer/browsers": "2.2.3",
         "cosmiconfig": "9.0.0",
         "devtools-protocol": "0.0.1273771",
-        "puppeteer-core": "22.7.1"
+        "puppeteer-core": "22.8.0"
       },
       "bin": {
         "puppeteer": "lib/esm/puppeteer/node/cli.js"
@@ -11862,7 +11862,7 @@
       }
     },
     "packages/puppeteer-core": {
-      "version": "22.7.1",
+      "version": "22.8.0",
       "license": "Apache-2.0",
       "dependencies": {
         "@puppeteer/browsers": "2.2.3",

packages/puppeteer-core/CHANGELOG.md

@@ -20,6 +20,25 @@ All notable changes to this project will be documented in this file. See [standa
   * dependencies
     * @puppeteer/browsers bumped from 1.5.1 to 1.6.0
 
+## [22.8.0](https://github.com/puppeteer/puppeteer/compare/puppeteer-core-v22.7.1...puppeteer-core-v22.8.0) (2024-05-06)
+
+
+### Features
+
+* **webdriver:** support `page.setUserAgent` for WebDriver BiDi ([#12330](https://github.com/puppeteer/puppeteer/issues/12330)) ([1f99e66](https://github.com/puppeteer/puppeteer/commit/1f99e669a1d644d1d17d5a7e926fbeafb8d231c6))
+* **webdriver:** support ARIA selectors ([#12315](https://github.com/puppeteer/puppeteer/issues/12315)) ([88b46ee](https://github.com/puppeteer/puppeteer/commit/88b46ee5020d30355a3e52512030e1162502e4f5))
+
+
+### Bug Fixes
+
+* **cdp:** throw on closed connection ([#12352](https://github.com/puppeteer/puppeteer/issues/12352)) ([28a8d0f](https://github.com/puppeteer/puppeteer/commit/28a8d0ffb6345309df2bb23c9a5e2bd8be2f059d))
+* deprecate CDP for Firefox ([#12349](https://github.com/puppeteer/puppeteer/issues/12349)) ([dffad28](https://github.com/puppeteer/puppeteer/commit/dffad28a429596be66741fb263e616437d7b965d))
+* disable IsolateSandboxedIframes trial to prevent flakiness ([#12381](https://github.com/puppeteer/puppeteer/issues/12381)) ([461a8ff](https://github.com/puppeteer/puppeteer/commit/461a8ff92ff0e3887b4ceb4e4b7d1198eb8f7901))
+* remove --disable-field-trial-config ([#12377](https://github.com/puppeteer/puppeteer/issues/12377)) ([54a6377](https://github.com/puppeteer/puppeteer/commit/54a6377d7d505e4580c78c06bb8a2c538bbf6857))
+* roll to Chrome 124.0.6367.91 (r1274542) ([#12344](https://github.com/puppeteer/puppeteer/issues/12344)) ([fedd8a9](https://github.com/puppeteer/puppeteer/commit/fedd8a9628aed134e8fc725b4e6c3cb20d546581))
+* turn on PdfOopif for PDF viewer ([#12370](https://github.com/puppeteer/puppeteer/issues/12370)) ([73d7692](https://github.com/puppeteer/puppeteer/commit/73d7692ae93959239f909cdee6ee849f8a70b7e5))
+* **webdriver:** redirects emitting events ([#12338](https://github.com/puppeteer/puppeteer/issues/12338)) ([e1606ac](https://github.com/puppeteer/puppeteer/commit/e1606acfc800ab067ec5a8db336a70dba57b0827))
+
 ## [22.7.1](https://github.com/puppeteer/puppeteer/compare/puppeteer-core-v22.7.0...puppeteer-core-v22.7.1) (2024-04-25)
 
 

packages/puppeteer-core/package.json

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

packages/puppeteer/CHANGELOG.md

@@ -29,6 +29,20 @@ All notable changes to this project will be documented in this file. See [standa
     * puppeteer-core bumped from 21.0.2 to 21.0.3
     * @puppeteer/browsers bumped from 1.5.1 to 1.6.0
 
+## [22.8.0](https://github.com/puppeteer/puppeteer/compare/puppeteer-v22.7.1...puppeteer-v22.8.0) (2024-05-06)
+
+
+### Miscellaneous Chores
+
+* **puppeteer:** Synchronize puppeteer versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * puppeteer-core bumped from 22.7.1 to 22.8.0
+
 ## [22.7.1](https://github.com/puppeteer/puppeteer/compare/puppeteer-v22.7.0...puppeteer-v22.7.1) (2024-04-25)
 
 

packages/puppeteer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "puppeteer",
-  "version": "22.7.1",
+  "version": "22.8.0",
   "description": "A high-level API to control headless Chrome over the DevTools Protocol",
   "keywords": [
     "puppeteer",
@@ -124,7 +124,7 @@
   "license": "Apache-2.0",
   "dependencies": {
     "cosmiconfig": "9.0.0",
-    "puppeteer-core": "22.7.1",
+    "puppeteer-core": "22.8.0",
     "@puppeteer/browsers": "2.2.3",
     "devtools-protocol": "0.0.1273771"
   },

versions.js

@@ -7,7 +7,7 @@
 const versionsPerRelease = new Map([
   // This is a mapping from Chrome version => Puppeteer version.
   // In Chrome roll patches, use `NEXT` for the Puppeteer version.
-  ['124.0.6367.91', 'NEXT'],
+  ['124.0.6367.91', 'v22.8.0'],
   ['124.0.6367.78', 'v22.7.1'],
   ['124.0.6367.60', 'v22.7.0'],
   ['123.0.6312.122', 'v22.6.4'],

website/versioned_docs/version-22.8.0/api/index.md

@@ -23,6 +23,16 @@ Description
 
 The Accessibility class provides methods for inspecting the browser'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).
 
+**Remarks:**
+
+Accessibility is a very platform-specific thing. On different platforms, there are different screen readers that might have wildly different output.
+
+Blink - Chrome's rendering engine - has a concept of "accessibility tree", which is then translated into different platform-specific APIs. Accessibility namespace gives users access to the Blink Accessibility Tree.
+
+Most of the accessibility tree gets filtered out when converting from Blink AX Tree to Platform-specific AX-Tree or by assistive technologies themselves. By default, Puppeteer tries to approximate this filtering, exposing only the "interesting" nodes of the tree.
+
+The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `Accessibility` class.
+
 </td></tr>
 <tr><td>
 
@@ -36,6 +46,10 @@ The Accessibility class provides methods for inspecting the browser's accessibil
 
 [Browser](./puppeteer.browser.md) [emits](./puppeteer.eventemitter.emit.md) various events which are documented in the [BrowserEvent](./puppeteer.browserevent.md) enum.
 
+**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 `Browser` class.
+
 </td></tr>
 <tr><td>
 
@@ -51,6 +65,10 @@ When a [browser](./puppeteer.browser.md) is launched, it has a single [browser c
 
 If a [page](./puppeteer.page.md) opens another [page](./puppeteer.page.md), e.g. using `window.open`, the popup will belong to the parent [page's browser context](./puppeteer.page.browsercontext.md).
 
+**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 `BrowserContext` class.
+
 </td></tr>
 <tr><td>
 
@@ -60,6 +78,14 @@ If a [page](./puppeteer.page.md) opens another [page](./puppeteer.page.md), e.g.
 
 The `CDPSession` instances are used to talk raw Chrome Devtools Protocol.
 
+**Remarks:**
+
+Protocol methods can be called with [CDPSession.send()](./puppeteer.cdpsession.send.md) method and protocol events can be subscribed to with `CDPSession.on` method.
+
+Useful links: [DevTools Protocol Viewer](https://chromedevtools.github.io/devtools-protocol/) and [Getting Started with DevTools Protocol](https://github.com/aslushnikov/getting-started-with-cdp/blob/HEAD/README.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 `CDPSession` class.
+
 </td></tr>
 <tr><td>
 
@@ -85,6 +111,10 @@ ConsoleMessage objects are dispatched by page via the 'console' event.
 
 The Coverage class provides methods to gather information about parts of JavaScript and CSS that were used by the page.
 
+**Remarks:**
+
+To output coverage in a form consumable by [Istanbul](https://github.com/istanbuljs), see [puppeteer-to-istanbul](https://github.com/istanbuljs/puppeteer-to-istanbul).
+
 </td></tr>
 <tr><td>
 
@@ -101,6 +131,12 @@ The Coverage class provides methods to gather information about parts of JavaScr
 
 Device request prompts let you respond to the page requesting for a device through an API like WebBluetooth.
 
+**Remarks:**
+
+`DeviceRequestPrompt` instances are returned via the [Page.waitForDevicePrompt()](./puppeteer.page.waitfordeviceprompt.md) method.
+
+The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `DeviceRequestPrompt` class.
+
 </td></tr>
 <tr><td>
 
@@ -110,6 +146,10 @@ Device request prompts let you respond to the page requesting for a device throu
 
 Device in a request prompt.
 
+**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 `DeviceRequestPromptDevice` class.
+
 </td></tr>
 <tr><td>
 
@@ -119,6 +159,10 @@ Device in a request prompt.
 
 Dialog instances are dispatched by the [Page](./puppeteer.page.md) via the `dialog` event.
 
+**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 `Dialog` class.
+
 </td></tr>
 <tr><td>
 
@@ -128,6 +172,31 @@ Dialog instances are dispatched by the [Page](./puppeteer.page.md) via the `dial
 
 ElementHandle represents an in-page DOM element.
 
+**Remarks:**
+
+ElementHandles can be created with the [Page.$()](./puppeteer.page._.md) method.
+
+```ts
+import puppeteer from 'puppeteer';
+
+(async () => {
+  const browser = await puppeteer.launch();
+  const page = await browser.newPage();
+  await page.goto('https://example.com');
+  const hrefElement = await page.$('a');
+  await hrefElement.click();
+  // ...
+})();
+```
+
+ElementHandle prevents the DOM element from being garbage-collected unless the handle is [disposed](./puppeteer.jshandle.dispose.md). ElementHandles are auto-disposed when their origin frame gets navigated.
+
+ElementHandle instances can be used as arguments in [Page.$eval()](./puppeteer.page._eval.md) and [Page.evaluate()](./puppeteer.page.evaluate.md) methods.
+
+If you're using TypeScript, ElementHandle takes a generic argument that denotes the type of element the handle is holding within. For example, if you have a handle to a `<select>` element, you can type it as `ElementHandle<HTMLSelectElement>` and you get some nicer type checks.
+
+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.
+
 </td></tr>
 <tr><td>
 
@@ -137,6 +206,12 @@ ElementHandle represents an in-page DOM element.
 
 The EventEmitter class that many Puppeteer classes extend.
 
+**Remarks:**
+
+This allows you to listen to events that Puppeteer classes fire and act accordingly. Therefore you'll mostly use [on](./puppeteer.eventemitter.on.md) and [off](./puppeteer.eventemitter.off.md) to bind and unbind to event listeners.
+
+The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `EventEmitter` class.
+
 </td></tr>
 <tr><td>
 
@@ -146,6 +221,14 @@ The EventEmitter class that many Puppeteer classes extend.
 
 File choosers let you react to the page requesting for a file.
 
+**Remarks:**
+
+`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.
+
 </td></tr>
 <tr><td>
 
@@ -157,6 +240,14 @@ 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.
 
+**Remarks:**
+
+Frame lifecycles are controlled by three events that are all dispatched on the parent [page](./puppeteer.frame.page.md):
+
+- [PageEvent.FrameAttached](./puppeteer.pageevent.md) - [PageEvent.FrameNavigated](./puppeteer.pageevent.md) - [PageEvent.FrameDetached](./puppeteer.pageevent.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 `Frame` class.
+
 </td></tr>
 <tr><td>
 
@@ -166,6 +257,26 @@ To understand frames, you can think of frames as `<iframe>` elements. Just like
 
 Represents an HTTP request sent by a page.
 
+**Remarks:**
+
+Whenever the page sends a request, such as for a network resource, the following events are emitted by Puppeteer's `page`:
+
+- `request`: emitted when the request is issued by the page. - `requestfinished` - emitted when the response body is downloaded and the request is complete.
+
+If request fails at some point, then instead of `requestfinished` event the `requestfailed` event is emitted.
+
+All of these events provide an instance of `HTTPRequest` representing the request that occurred:
+
+```
+page.on('request', request => ...)
+```
+
+NOTE: HTTP Error responses, such as 404 or 503, are still successful responses from HTTP standpoint, so request will complete with `requestfinished` event.
+
+If request gets a 'redirect' response, the request is successfully finished with the `requestfinished` event, and a new request is issued to a redirected url.
+
+The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `HTTPRequest` class.
+
 </td></tr>
 <tr><td>
 
@@ -175,6 +286,10 @@ Represents an HTTP request sent by a page.
 
 The HTTPResponse class represents responses which are received by the [Page](./puppeteer.page.md) class.
 
+**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 `HTTPResponse` class.
+
 </td></tr>
 <tr><td>
 
@@ -195,6 +310,10 @@ Handles prevent the referenced JavaScript object from being garbage-collected un
 
 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.
 
+**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.
+
 </td></tr>
 <tr><td>
 
@@ -204,6 +323,14 @@ Handles can be used as arguments for any evaluation function such as [Page.$eval
 
 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.
 
+**Remarks:**
+
+For finer control, you can use [Keyboard.down()](./puppeteer.keyboard.down.md), [Keyboard.up()](./puppeteer.keyboard.up.md), and [Keyboard.sendCharacter()](./puppeteer.keyboard.sendcharacter.md) to manually fire events as if they were generated from a real keyboard.
+
+On macOS, keyboard shortcuts like `⌘ A` -&gt; Select All do not work. See [\#1313](https://github.com/puppeteer/puppeteer/issues/1313).
+
+The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `Keyboard` class.
+
 </td></tr>
 <tr><td>
 
@@ -222,6 +349,12 @@ Locators describe a strategy of locating objects and performing an action on the
 
 The Mouse class operates in main-frame CSS pixels relative to the top-left corner of the viewport.
 
+**Remarks:**
+
+Every `page` object has its own Mouse, accessible with \[`page.mouse`\](\#pagemouse).
+
+The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `Mouse` class.
+
 </td></tr>
 <tr><td>
 
@@ -237,6 +370,10 @@ One Browser instance might have multiple Page instances.
 
 :::
 
+**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 `Page` class.
+
 </td></tr>
 <tr><td>
 
@@ -246,6 +383,10 @@ One Browser instance might have multiple Page instances.
 
 Describes a launcher - a class that is able to create and launch a browser instance.
 
+**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 `ProductLauncher` class.
+
 </td></tr>
 <tr><td>
 
@@ -266,6 +407,10 @@ 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).
 
+**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 `Puppeteer` class.
+
 </td></tr>
 <tr><td>
 
@@ -275,6 +420,10 @@ IMPORTANT: if you are using Puppeteer in a Node environment, you will get an ins
 
 The base class for all Puppeteer-specific errors
 
+**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 `PuppeteerError` class.
+
 </td></tr>
 <tr><td>
 
@@ -286,6 +435,14 @@ Extends the main [Puppeteer](./puppeteer.puppeteer.md) class with Node specific
 
 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`).
 
+**Remarks:**
+
+The most common method to use is [launch](./puppeteer.puppeteernode.launch.md), which is used to launch and connect to a new browser instance.
+
+See [the main Puppeteer class](./puppeteer.puppeteer.md) for methods common to all environments, such as [Puppeteer.connect()](./puppeteer.puppeteer.connect.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 `PuppeteerNode` class.
+
 </td></tr>
 <tr><td>
 
@@ -293,6 +450,10 @@ If you're using Puppeteer in a Node environment, this is the class you'll get wh
 
 </td><td>
 
+**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 `ScreenRecorder` class.
+
 </td></tr>
 <tr><td>
 
@@ -302,6 +463,10 @@ If you're using Puppeteer in a Node environment, this is the class you'll get wh
 
 The SecurityDetails class represents the security details of a response that was received over a secure connection.
 
+**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 `SecurityDetails` class.
+
 </td></tr>
 <tr><td>
 
@@ -311,6 +476,10 @@ The SecurityDetails class represents the security details of a response that was
 
 Target represents a [CDP target](https://chromedevtools.github.io/devtools-protocol/tot/Target/). In CDP a target is something that can be debugged such a frame, a page or a worker.
 
+**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 `Target` class.
+
 </td></tr>
 <tr><td>
 
@@ -320,6 +489,10 @@ Target represents a [CDP target](https://chromedevtools.github.io/devtools-proto
 
 TimeoutError is emitted whenever certain operations are terminated due to timeout.
 
+**Remarks:**
+
+Example operations are [page.waitForSelector](./puppeteer.page.waitforselector.md) or [puppeteer.launch](./puppeteer.puppeteernode.launch.md).
+
 </td></tr>
 <tr><td>
 
@@ -329,6 +502,10 @@ TimeoutError is emitted whenever certain operations are terminated due to timeou
 
 The Touchscreen class exposes touchscreen events.
 
+**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 `Touchscreen` class.
+
 </td></tr>
 <tr><td>
 
@@ -338,6 +515,12 @@ The Touchscreen class exposes touchscreen events.
 
 The Tracing class exposes the tracing audit interface.
 
+**Remarks:**
+
+You can use `tracing.start` and `tracing.stop` to create a trace file which can be opened in Chrome DevTools or [timeline viewer](https://chromedevtools.github.io/timeline-viewer/).
+
+The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `Tracing` class.
+
 </td></tr>
 <tr><td>
 
@@ -356,6 +539,12 @@ Puppeteer will throw this error if a method is not supported by the currently us
 
 This class represents a [WebWorker](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API).
 
+**Remarks:**
+
+The events `workercreated` and `workerdestroyed` are emitted on the page object to signal the worker lifecycle.
+
+The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `WebWorker` class.
+
 </td></tr>
 </tbody></table>
 
@@ -713,6 +902,8 @@ Set of configurable options for CSS coverage.
 
 </td><td>
 
+**_(Experimental)_**
+
 </td></tr>
 <tr><td>
 
@@ -986,6 +1177,8 @@ Required response data to fulfill a request with.
 
 </td><td>
 
+**_(Experimental)_**
+
 </td></tr>
 <tr><td>
 
@@ -1389,6 +1582,32 @@ All the valid keys that can be passed to functions that take user input, such as
 
 All the valid paper format types when printing a PDF.
 
+**Remarks:**
+
+The sizes of each format are as follows:
+
+- `Letter`: 8.5in x 11in
+
+- `Legal`: 8.5in x 14in
+
+- `Tabloid`: 11in x 17in
+
+- `Ledger`: 17in x 11in
+
+- `A0`: 33.1in x 46.8in
+
+- `A1`: 23.4in x 33.1in
+
+- `A2`: 16.54in x 23.4in
+
+- `A3`: 11.7in x 16.54in
+
+- `A4`: 8.27in x 11.7in
+
+- `A5`: 5.83in x 8.27in
+
+- `A6`: 4.13in x 5.83in
+
 </td></tr>
 <tr><td>
 

website/versioned_docs/version-22.8.0/api/puppeteer.accessibility.md

@@ -47,5 +47,9 @@ Description
 
 Captures the current state of the accessibility tree. The returned object represents the root accessible node of the page.
 
+**Remarks:**
+
+**NOTE** The Chrome 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`.
+
 </td></tr>
 </tbody></table>

website/versioned_docs/version-22.8.0/api/puppeteer.browser.md

@@ -104,7 +104,11 @@ Whether Puppeteer is connected to this [browser](./puppeteer.browser.md).
 
 </td><td>
 
-Get debug information from Puppeteer.
+**_(Experimental)_** Get debug information from Puppeteer.
+
+**Remarks:**
+
+Currently, includes pending protocol calls. In the future, we might add more info.
 
 </td></tr>
 </tbody></table>
@@ -171,6 +175,10 @@ This won't share cookies/cache with other [browser contexts](./puppeteer.browser
 
 Gets the default [browser context](./puppeteer.browsercontext.md).
 
+**Remarks:**
+
+The default [browser context](./puppeteer.browsercontext.md) cannot be closed.
+
 </td></tr>
 <tr><td>
 
@@ -223,6 +231,10 @@ Gets a list of all open [pages](./puppeteer.page.md) inside this [Browser](./pup
 
 If there ar multiple [browser contexts](./puppeteer.browsercontext.md), this returns all [pages](./puppeteer.page.md) in all [browser contexts](./puppeteer.browsercontext.md).
 
+**Remarks:**
+
+Non-visible [pages](./puppeteer.page.md), such as `"background_page"`, will not be listed here. You can find them using [Target.page()](./puppeteer.target.page.md).
+
 </td></tr>
 <tr><td>
 
@@ -316,5 +328,9 @@ You can find the debugger URL (`webSocketDebuggerUrl`) from `http://HOST:PORT/js
 
 See [browser endpoint](https://chromedevtools.github.io/devtools-protocol/#how-do-i-access-the-browser-target) for more information.
 
+**Remarks:**
+
+The format is always `ws://HOST:PORT/devtools/browser/<id>`.
+
 </td></tr>
 </tbody></table>

website/versioned_docs/version-22.8.0/api/puppeteer.browsercontext.md

@@ -141,6 +141,10 @@ Clears all permission overrides for this [browser context](./puppeteer.browserco
 
 Closes this [browser context](./puppeteer.browsercontext.md) and all associated [pages](./puppeteer.page.md).
 
+**Remarks:**
+
+The [default browser context](./puppeteer.browser.defaultbrowsercontext.md) cannot be closed.
+
 </td></tr>
 <tr><td>
 
@@ -193,6 +197,10 @@ Grants this [browser context](./puppeteer.browsercontext.md) the given `permissi
 
 Gets a list of all open [pages](./puppeteer.page.md) inside this [browser context](./puppeteer.browsercontext.md).
 
+**Remarks:**
+
+Non-visible [pages](./puppeteer.page.md), such as `"background_page"`, will not be listed here. You can find them using [Target.page()](./puppeteer.target.page.md).
+
 </td></tr>
 <tr><td>
 

website/versioned_docs/version-22.8.0/api/puppeteer.browserevent.md

@@ -54,6 +54,10 @@ TargetChanged
 
 Emitted when the URL of a target changes. Contains a [Target](./puppeteer.target.md) instance.
 
+**Remarks:**
+
+Note that this includes target changes in all browser contexts.
+
 </td></tr>
 <tr><td>
 
@@ -69,6 +73,10 @@ Emitted when a target is created, for example when a new page is opened by [wind
 
 Contains a [Target](./puppeteer.target.md) instance.
 
+**Remarks:**
+
+Note that this includes target creations in all browser contexts.
+
 </td></tr>
 <tr><td>
 
@@ -82,5 +90,9 @@ TargetDestroyed
 
 Emitted when a target is destroyed, for example when a page is closed. Contains a [Target](./puppeteer.target.md) instance.
 
+**Remarks:**
+
+Note that this includes target destructions in all browser contexts.
+
 </td></tr>
 </tbody></table>

website/versioned_docs/version-22.8.0/api/puppeteer.browserlaunchargumentoptions.md

@@ -110,6 +110,12 @@ boolean \| 'shell'
 
 Whether to run the browser in headless mode.
 
+**Remarks:**
+
+- `true` launches the browser in the [new headless](https://developer.chrome.com/articles/new-headless/) mode.
+
+- `'shell'` launches [shell](https://developer.chrome.com/blog/chrome-headless-shell) known as the old headless mode.
+
 </td><td>
 
 `true`

website/versioned_docs/version-22.8.0/api/puppeteer.configuration.md

@@ -128,6 +128,10 @@ Specifies the URL prefix that is used to download the browser.
 
 Can be overridden by `PUPPETEER_DOWNLOAD_BASE_URL`.
 
+**Remarks:**
+
+This must include the protocol and may even need a path prefix.
+
 </td><td>
 
 Either https://storage.googleapis.com/chrome-for-testing-public or https://archive.mozilla.org/pub/firefox/nightly/latest-mozilla-central, depending on the product.

website/versioned_docs/version-22.8.0/api/puppeteer.connectoptions.md

@@ -85,6 +85,10 @@ Record<string, string>
 
 Headers to use for the web socket connection.
 
+**Remarks:**
+
+Only works in the Node.js environment.
+
 </td><td>
 
 </td></tr>