chore(main): release 15.4.0 (puppeteer#8668)

* chore(main): release 15.4.0

* chore: generate versioned docs

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

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "15.3.2"
+  ".": "15.4.0"
 }

CHANGELOG.md

@@ -2,6 +2,18 @@
 
 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.
 
+## [15.4.0](https://github.com/puppeteer/puppeteer/compare/v15.3.2...v15.4.0) (2022-07-13)
+
+
+### Features
+
+* expose the page getter on Frame ([#8657](https://github.com/puppeteer/puppeteer/issues/8657)) ([af08c5c](https://github.com/puppeteer/puppeteer/commit/af08c5c90380c853e8257a51298bfed4b0635779))
+
+
+### Bug Fixes
+
+* ignore *.tsbuildinfo ([#8662](https://github.com/puppeteer/puppeteer/issues/8662)) ([edcdf21](https://github.com/puppeteer/puppeteer/commit/edcdf217cefbf31aee5a2f571abac429dd81f3a0))
+
 ## [15.3.2](https://github.com/puppeteer/puppeteer/compare/v15.3.1...v15.3.2) (2022-07-08)
 
 

package.json

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

src/generated/version.ts

@@ -1,4 +1,4 @@
 /**
  * @internal
  */
-export const packageVersion = '15.3.2';
+export const packageVersion = '15.4.0';

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

@@ -0,0 +1,29 @@
+---
+sidebar_label: Accessibility
+---
+
+# Accessibility class
+
+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).
+
+**Signature:**
+
+```typescript
+export declare class Accessibility
+```
+
+## 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.
+
+## Methods
+
+| Method                                                     | Modifiers | Description                                                                                                                |
+| ---------------------------------------------------------- | --------- | -------------------------------------------------------------------------------------------------------------------------- |
+| [snapshot(options)](./puppeteer.accessibility.snapshot.md) |           | Captures the current state of the accessibility tree. The returned object represents the root accessible node of the page. |

website/versioned_docs/version-15.4.0/api/puppeteer.accessibility.snapshot.md

@@ -0,0 +1,59 @@
+---
+sidebar_label: Accessibility.snapshot
+---
+
+# Accessibility.snapshot() method
+
+Captures the current state of the accessibility tree. The returned object represents the root accessible node of the page.
+
+**Signature:**
+
+```typescript
+class Accessibility {
+  snapshot(options?: SnapshotOptions): Promise<SerializedAXNode | null>;
+}
+```
+
+## Parameters
+
+| Parameter | Type                                              | Description       |
+| --------- | ------------------------------------------------- | ----------------- |
+| options   | [SnapshotOptions](./puppeteer.snapshotoptions.md) | <i>(Optional)</i> |
+
+**Returns:**
+
+Promise&lt;[SerializedAXNode](./puppeteer.serializedaxnode.md) \| null&gt;
+
+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`.
+
+## Example 1
+
+An example of dumping the entire accessibility tree:
+
+```ts
+const snapshot = await page.accessibility.snapshot();
+console.log(snapshot);
+```
+
+## Example 2
+
+An example of logging the focused node's name:
+
+```ts
+const snapshot = await page.accessibility.snapshot();
+const node = findFocusedNode(snapshot);
+console.log(node && node.name);
+
+function findFocusedNode(node) {
+  if (node.focused) return node;
+  for (const child of node.children || []) {
+    const foundNode = findFocusedNode(child);
+    return foundNode;
+  }
+  return null;
+}
+```

website/versioned_docs/version-15.4.0/api/puppeteer.actionresult.md

@@ -0,0 +1,11 @@
+---
+sidebar_label: ActionResult
+---
+
+# ActionResult type
+
+**Signature:**
+
+```typescript
+export declare type ActionResult = 'continue' | 'abort' | 'respond';
+```

website/versioned_docs/version-15.4.0/api/puppeteer.awaitable.md

@@ -0,0 +1,11 @@
+---
+sidebar_label: Awaitable
+---
+
+# Awaitable type
+
+**Signature:**
+
+```typescript
+export declare type Awaitable<T> = T | PromiseLike<T>;
+```

website/versioned_docs/version-15.4.0/api/puppeteer.boundingbox.height.md

@@ -0,0 +1,15 @@
+---
+sidebar_label: BoundingBox.height
+---
+
+# BoundingBox.height property
+
+the height of the element in pixels.
+
+**Signature:**
+
+```typescript
+interface BoundingBox {
+  height: number;
+}
+```

website/versioned_docs/version-15.4.0/api/puppeteer.boundingbox.md

@@ -0,0 +1,20 @@
+---
+sidebar_label: BoundingBox
+---
+
+# BoundingBox interface
+
+**Signature:**
+
+```typescript
+export interface BoundingBox extends Point
+```
+
+**Extends:** [Point](./puppeteer.point.md)
+
+## Properties
+
+| Property                                    | Modifiers | Type   | Description                          |
+| ------------------------------------------- | --------- | ------ | ------------------------------------ |
+| [height](./puppeteer.boundingbox.height.md) |           | number | the height of the element in pixels. |
+| [width](./puppeteer.boundingbox.width.md)   |           | number | the width of the element in pixels.  |

website/versioned_docs/version-15.4.0/api/puppeteer.boundingbox.width.md

@@ -0,0 +1,15 @@
+---
+sidebar_label: BoundingBox.width
+---
+
+# BoundingBox.width property
+
+the width of the element in pixels.
+
+**Signature:**
+
+```typescript
+interface BoundingBox {
+  width: number;
+}
+```

website/versioned_docs/version-15.4.0/api/puppeteer.boxmodel.border.md

@@ -0,0 +1,13 @@
+---
+sidebar_label: BoxModel.border
+---
+
+# BoxModel.border property
+
+**Signature:**
+
+```typescript
+interface BoxModel {
+  border: Point[];
+}
+```

website/versioned_docs/version-15.4.0/api/puppeteer.boxmodel.content.md

@@ -0,0 +1,13 @@
+---
+sidebar_label: BoxModel.content
+---
+
+# BoxModel.content property
+
+**Signature:**
+
+```typescript
+interface BoxModel {
+  content: Point[];
+}
+```

website/versioned_docs/version-15.4.0/api/puppeteer.boxmodel.height.md

@@ -0,0 +1,13 @@
+---
+sidebar_label: BoxModel.height
+---
+
+# BoxModel.height property
+
+**Signature:**
+
+```typescript
+interface BoxModel {
+  height: number;
+}
+```

website/versioned_docs/version-15.4.0/api/puppeteer.boxmodel.margin.md

@@ -0,0 +1,13 @@
+---
+sidebar_label: BoxModel.margin
+---
+
+# BoxModel.margin property
+
+**Signature:**
+
+```typescript
+interface BoxModel {
+  margin: Point[];
+}
+```

website/versioned_docs/version-15.4.0/api/puppeteer.boxmodel.md

@@ -0,0 +1,22 @@
+---
+sidebar_label: BoxModel
+---
+
+# BoxModel interface
+
+**Signature:**
+
+```typescript
+export interface BoxModel
+```
+
+## Properties
+
+| Property                                   | Modifiers | Type                              | Description |
+| ------------------------------------------ | --------- | --------------------------------- | ----------- |
+| [border](./puppeteer.boxmodel.border.md)   |           | [Point](./puppeteer.point.md)\[\] |             |
+| [content](./puppeteer.boxmodel.content.md) |           | [Point](./puppeteer.point.md)\[\] |             |
+| [height](./puppeteer.boxmodel.height.md)   |           | number                            |             |
+| [margin](./puppeteer.boxmodel.margin.md)   |           | [Point](./puppeteer.point.md)\[\] |             |
+| [padding](./puppeteer.boxmodel.padding.md) |           | [Point](./puppeteer.point.md)\[\] |             |
+| [width](./puppeteer.boxmodel.width.md)     |           | number                            |             |

website/versioned_docs/version-15.4.0/api/puppeteer.boxmodel.padding.md

@@ -0,0 +1,13 @@
+---
+sidebar_label: BoxModel.padding
+---
+
+# BoxModel.padding property
+
+**Signature:**
+
+```typescript
+interface BoxModel {
+  padding: Point[];
+}
+```

website/versioned_docs/version-15.4.0/api/puppeteer.boxmodel.width.md

@@ -0,0 +1,13 @@
+---
+sidebar_label: BoxModel.width
+---
+
+# BoxModel.width property
+
+**Signature:**
+
+```typescript
+interface BoxModel {
+  width: number;
+}
+```

website/versioned_docs/version-15.4.0/api/puppeteer.browser.browsercontexts.md

@@ -0,0 +1,19 @@
+---
+sidebar_label: Browser.browserContexts
+---
+
+# Browser.browserContexts() method
+
+Returns an array of all open browser contexts. In a newly created browser, this will return a single instance of [BrowserContext](./puppeteer.browsercontext.md).
+
+**Signature:**
+
+```typescript
+class Browser {
+  browserContexts(): BrowserContext[];
+}
+```
+
+**Returns:**
+
+[BrowserContext](./puppeteer.browsercontext.md)\[\]

website/versioned_docs/version-15.4.0/api/puppeteer.browser.close.md

@@ -0,0 +1,19 @@
+---
+sidebar_label: Browser.close
+---
+
+# Browser.close() method
+
+Closes Chromium and all of its pages (if any were opened). The [Browser](./puppeteer.browser.md) object itself is considered to be disposed and cannot be used anymore.
+
+**Signature:**
+
+```typescript
+class Browser {
+  close(): Promise<void>;
+}
+```
+
+**Returns:**
+
+Promise&lt;void&gt;