chore: release main (#9939)

Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
This commit is contained in:
release-please[bot] 2023-03-29 11:22:11 +00:00 committed by GitHub
parent 2a29d30d17
commit 8d026042db
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
816 changed files with 1356 additions and 5370 deletions

View File

@ -1,7 +1,7 @@
{
"packages/puppeteer": "19.8.1",
"packages/puppeteer": "19.8.2",
"packages/puppeteer-core": "19.8.1",
"packages/testserver": "0.6.0",
"packages/ng-schematics": "0.1.0",
"packages/browsers": "0.3.0"
"packages/browsers": "0.3.1"
}

8
package-lock.json generated
View File

@ -9317,7 +9317,7 @@
},
"packages/browsers": {
"name": "@puppeteer/browsers",
"version": "0.3.0",
"version": "0.3.1",
"license": "Apache-2.0",
"dependencies": {
"debug": "4.3.4",
@ -9466,11 +9466,11 @@
}
},
"packages/puppeteer": {
"version": "19.8.1",
"version": "19.8.2",
"hasInstallScript": true,
"license": "Apache-2.0",
"dependencies": {
"@puppeteer/browsers": "0.3.0",
"@puppeteer/browsers": "0.3.1",
"cosmiconfig": "8.1.3",
"https-proxy-agent": "5.0.1",
"progress": "2.0.3",
@ -14453,7 +14453,7 @@
"puppeteer": {
"version": "file:packages/puppeteer",
"requires": {
"@puppeteer/browsers": "0.3.0",
"@puppeteer/browsers": "0.3.1",
"cosmiconfig": "8.1.3",
"https-proxy-agent": "5.0.1",
"progress": "2.0.3",

View File

@ -1,5 +1,12 @@
# Changelog
## [0.3.1](https://github.com/puppeteer/puppeteer/compare/browsers-v0.3.0...browsers-v0.3.1) (2023-03-29)
### Bug Fixes
* bump @puppeteer/browsers ([#9938](https://github.com/puppeteer/puppeteer/issues/9938)) ([2a29d30](https://github.com/puppeteer/puppeteer/commit/2a29d30d1790b47c99f8d196b3844364d351acbd))
## [0.3.0](https://github.com/puppeteer/puppeteer/compare/browsers-v0.2.0...browsers-v0.3.0) (2023-03-27)

View File

@ -1,6 +1,6 @@
{
"name": "@puppeteer/browsers",
"version": "0.3.0",
"version": "0.3.1",
"description": "Download and launch browsers",
"scripts": {
"build": "wireit",

View File

@ -2,6 +2,12 @@
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.
### Dependencies
* The following workspace dependencies were updated
* dependencies
* @puppeteer/browsers bumped from 0.3.0 to 0.3.1
## [19.8.1](https://github.com/puppeteer/puppeteer/compare/puppeteer-v19.8.0...puppeteer-v19.8.1) (2023-03-28)

View File

@ -1,6 +1,6 @@
{
"name": "puppeteer",
"version": "19.8.1",
"version": "19.8.2",
"description": "A high-level API to control headless Chrome over the DevTools Protocol",
"keywords": [
"puppeteer",
@ -121,6 +121,6 @@
"progress": "2.0.3",
"proxy-from-env": "1.1.0",
"puppeteer-core": "19.8.1",
"@puppeteer/browsers": "0.3.0"
"@puppeteer/browsers": "0.3.1"
}
}

View File

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

View File

@ -1,20 +0,0 @@
---
sidebar_label: BoundingBox
---
# BoundingBox interface
#### Signature:
```typescript
export interface BoundingBox extends Point
```
**Extends:** [Point](./puppeteer.point.md)
## Properties
| Property | Modifiers | Type | Description | Default |
| ------------------------------------------- | --------- | ------ | ------------------------------------ | ------- |
| [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. | |

View File

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

View File

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

View File

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

View File

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

View File

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

View File

@ -1,22 +0,0 @@
---
sidebar_label: BoxModel
---
# BoxModel interface
#### Signature:
```typescript
export interface BoxModel
```
## Properties
| Property | Modifiers | Type | Description | Default |
| ------------------------------------------ | --------- | --------------------------------- | ----------- | ------- |
| [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 | | |

View File

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

View File

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

View File

@ -1,15 +0,0 @@
---
sidebar_label: BrowserConnectOptions.defaultViewport
---
# BrowserConnectOptions.defaultViewport property
Sets the viewport for each page.
#### Signature:
```typescript
interface BrowserConnectOptions {
defaultViewport?: Viewport | null;
}
```

View File

@ -1,19 +0,0 @@
---
sidebar_label: BrowserConnectOptions.ignoreHTTPSErrors
---
# BrowserConnectOptions.ignoreHTTPSErrors property
Whether to ignore HTTPS errors during navigation.
#### Signature:
```typescript
interface BrowserConnectOptions {
ignoreHTTPSErrors?: boolean;
}
```
#### Default value:
false

View File

@ -1,23 +0,0 @@
---
sidebar_label: BrowserConnectOptions
---
# BrowserConnectOptions interface
Generic browser options that can be passed when launching any browser or when connecting to an existing browser instance.
#### Signature:
```typescript
export interface BrowserConnectOptions
```
## Properties
| Property | Modifiers | Type | Description | Default |
| ---------------------------------------------------------------------------- | --------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | ------- |
| [defaultViewport?](./puppeteer.browserconnectoptions.defaultviewport.md) | | [Viewport](./puppeteer.viewport.md) \| null | _(Optional)_ Sets the viewport for each page. | |
| [ignoreHTTPSErrors?](./puppeteer.browserconnectoptions.ignorehttpserrors.md) | | boolean | _(Optional)_ Whether to ignore HTTPS errors during navigation. | false |
| [protocolTimeout?](./puppeteer.browserconnectoptions.protocoltimeout.md) | | number | _(Optional)_ Timeout setting for individual protocol (CDP) calls. | 180000 |
| [slowMo?](./puppeteer.browserconnectoptions.slowmo.md) | | number | _(Optional)_ Slows down Puppeteer operations by the specified amount of milliseconds to aid debugging. | |
| [targetFilter?](./puppeteer.browserconnectoptions.targetfilter.md) | | [TargetFilterCallback](./puppeteer.targetfiltercallback.md) | _(Optional)_ Callback to decide if Puppeteer should connect to a given target or not. | |

View File

@ -1,19 +0,0 @@
---
sidebar_label: BrowserConnectOptions.protocolTimeout
---
# BrowserConnectOptions.protocolTimeout property
Timeout setting for individual protocol (CDP) calls.
#### Signature:
```typescript
interface BrowserConnectOptions {
protocolTimeout?: number;
}
```
#### Default value:
180000

View File

@ -1,15 +0,0 @@
---
sidebar_label: BrowserConnectOptions.slowMo
---
# BrowserConnectOptions.slowMo property
Slows down Puppeteer operations by the specified amount of milliseconds to aid debugging.
#### Signature:
```typescript
interface BrowserConnectOptions {
slowMo?: number;
}
```

View File

@ -1,15 +0,0 @@
---
sidebar_label: BrowserConnectOptions.targetFilter
---
# BrowserConnectOptions.targetFilter property
Callback to decide if Puppeteer should connect to a given target or not.
#### Signature:
```typescript
interface BrowserConnectOptions {
targetFilter?: TargetFilterCallback;
}
```

View File

@ -1,13 +0,0 @@
---
sidebar_label: BrowserContext.id
---
# BrowserContext.id property
#### Signature:
```typescript
class BrowserContext {
get id(): string | undefined;
}
```

View File

@ -1,20 +0,0 @@
---
sidebar_label: BrowserContextOptions
---
# BrowserContextOptions interface
BrowserContext options.
#### Signature:
```typescript
export interface BrowserContextOptions
```
## Properties
| Property | Modifiers | Type | Description | Default |
| ------------------------------------------------------------------------ | --------- | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| [proxyBypassList?](./puppeteer.browsercontextoptions.proxybypasslist.md) | | string\[\] | _(Optional)_ Bypass the proxy for the given list of hosts. | |
| [proxyServer?](./puppeteer.browsercontextoptions.proxyserver.md) | | string | _(Optional)_ Proxy server with optional port to use for all requests. Username and password can be set in <code>Page.authenticate</code>. | |

View File

@ -1,15 +0,0 @@
---
sidebar_label: BrowserContextOptions.proxyBypassList
---
# BrowserContextOptions.proxyBypassList property
Bypass the proxy for the given list of hosts.
#### Signature:
```typescript
interface BrowserContextOptions {
proxyBypassList?: string[];
}
```

View File

@ -1,15 +0,0 @@
---
sidebar_label: BrowserContextOptions.proxyServer
---
# BrowserContextOptions.proxyServer property
Proxy server with optional port to use for all requests. Username and password can be set in `Page.authenticate`.
#### Signature:
```typescript
interface BrowserContextOptions {
proxyServer?: string;
}
```

View File

@ -1,21 +0,0 @@
---
sidebar_label: BrowserFetcherOptions.host
---
# BrowserFetcherOptions.host property
Determines the host that will be used for downloading.
#### Signature:
```typescript
interface BrowserFetcherOptions {
host?: string;
}
```
#### Default value:
Either
- https://storage.googleapis.com or - https://archive.mozilla.org/pub/firefox/nightly/latest-mozilla-central

View File

@ -1,21 +0,0 @@
---
sidebar_label: BrowserFetcherOptions
---
# BrowserFetcherOptions interface
#### Signature:
```typescript
export interface BrowserFetcherOptions
```
## Properties
| Property | Modifiers | Type | Description | Default |
| ---------------------------------------------------------------------------- | --------- | ----------------------------------- | ------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| [host?](./puppeteer.browserfetcheroptions.host.md) | | string | _(Optional)_ Determines the host that will be used for downloading. | <p>Either</p><p>- https://storage.googleapis.com or - https://archive.mozilla.org/pub/firefox/nightly/latest-mozilla-central</p> |
| [path](./puppeteer.browserfetcheroptions.path.md) | | string | Determines the path to download browsers to. | |
| [platform?](./puppeteer.browserfetcheroptions.platform.md) | | [Platform](./puppeteer.platform.md) | _(Optional)_ Determines which platform the browser will be suited for. | Auto-detected. |
| [product?](./puppeteer.browserfetcheroptions.product.md) | | 'chrome' \| 'firefox' | _(Optional)_ Determines which product the [BrowserFetcher](./puppeteer.browserfetcher.md) is for. | <code>&quot;chrome&quot;</code>. |
| [useMacOSARMBinary?](./puppeteer.browserfetcheroptions.usemacosarmbinary.md) | | boolean | _(Optional)_ Enables the use of the Chromium binary for macOS ARM. | |

View File

@ -1,15 +0,0 @@
---
sidebar_label: BrowserFetcherOptions.path
---
# BrowserFetcherOptions.path property
Determines the path to download browsers to.
#### Signature:
```typescript
interface BrowserFetcherOptions {
path: string;
}
```

View File

@ -1,19 +0,0 @@
---
sidebar_label: BrowserFetcherOptions.platform
---
# BrowserFetcherOptions.platform property
Determines which platform the browser will be suited for.
#### Signature:
```typescript
interface BrowserFetcherOptions {
platform?: Platform;
}
```
#### Default value:
Auto-detected.

View File

@ -1,19 +0,0 @@
---
sidebar_label: BrowserFetcherOptions.product
---
# BrowserFetcherOptions.product property
Determines which product the [BrowserFetcher](./puppeteer.browserfetcher.md) is for.
#### Signature:
```typescript
interface BrowserFetcherOptions {
product?: 'chrome' | 'firefox';
}
```
#### Default value:
`"chrome"`.

View File

@ -1,15 +0,0 @@
---
sidebar_label: BrowserFetcherOptions.useMacOSARMBinary
---
# BrowserFetcherOptions.useMacOSARMBinary property
Enables the use of the Chromium binary for macOS ARM.
#### Signature:
```typescript
interface BrowserFetcherOptions {
useMacOSARMBinary?: boolean;
}
```

View File

@ -1,13 +0,0 @@
---
sidebar_label: BrowserFetcherRevisionInfo.executablePath
---
# BrowserFetcherRevisionInfo.executablePath property
#### Signature:
```typescript
interface BrowserFetcherRevisionInfo {
executablePath: string;
}
```

View File

@ -1,13 +0,0 @@
---
sidebar_label: BrowserFetcherRevisionInfo.folderPath
---
# BrowserFetcherRevisionInfo.folderPath property
#### Signature:
```typescript
interface BrowserFetcherRevisionInfo {
folderPath: string;
}
```

View File

@ -1,13 +0,0 @@
---
sidebar_label: BrowserFetcherRevisionInfo.local
---
# BrowserFetcherRevisionInfo.local property
#### Signature:
```typescript
interface BrowserFetcherRevisionInfo {
local: boolean;
}
```

View File

@ -1,22 +0,0 @@
---
sidebar_label: BrowserFetcherRevisionInfo
---
# BrowserFetcherRevisionInfo interface
#### Signature:
```typescript
export interface BrowserFetcherRevisionInfo
```
## Properties
| Property | Modifiers | Type | Description | Default |
| -------------------------------------------------------------------------- | --------- | ------- | ----------- | ------- |
| [executablePath](./puppeteer.browserfetcherrevisioninfo.executablepath.md) | | string | | |
| [folderPath](./puppeteer.browserfetcherrevisioninfo.folderpath.md) | | string | | |
| [local](./puppeteer.browserfetcherrevisioninfo.local.md) | | boolean | | |
| [product](./puppeteer.browserfetcherrevisioninfo.product.md) | | string | | |
| [revision](./puppeteer.browserfetcherrevisioninfo.revision.md) | | string | | |
| [url](./puppeteer.browserfetcherrevisioninfo.url.md) | | string | | |

View File

@ -1,13 +0,0 @@
---
sidebar_label: BrowserFetcherRevisionInfo.product
---
# BrowserFetcherRevisionInfo.product property
#### Signature:
```typescript
interface BrowserFetcherRevisionInfo {
product: string;
}
```

View File

@ -1,13 +0,0 @@
---
sidebar_label: BrowserFetcherRevisionInfo.revision
---
# BrowserFetcherRevisionInfo.revision property
#### Signature:
```typescript
interface BrowserFetcherRevisionInfo {
revision: string;
}
```

View File

@ -1,13 +0,0 @@
---
sidebar_label: BrowserFetcherRevisionInfo.url
---
# BrowserFetcherRevisionInfo.url property
#### Signature:
```typescript
interface BrowserFetcherRevisionInfo {
url: string;
}
```

View File

@ -1,15 +0,0 @@
---
sidebar_label: BrowserLaunchArgumentOptions.args
---
# BrowserLaunchArgumentOptions.args property
Additional command line arguments to pass to the browser instance.
#### Signature:
```typescript
interface BrowserLaunchArgumentOptions {
args?: string[];
}
```

View File

@ -1,13 +0,0 @@
---
sidebar_label: BrowserLaunchArgumentOptions.debuggingPort
---
# BrowserLaunchArgumentOptions.debuggingPort property
#### Signature:
```typescript
interface BrowserLaunchArgumentOptions {
debuggingPort?: number;
}
```

View File

@ -1,19 +0,0 @@
---
sidebar_label: BrowserLaunchArgumentOptions.devtools
---
# BrowserLaunchArgumentOptions.devtools property
Whether to auto-open a DevTools panel for each tab. If this is set to `true`, then `headless` will be forced to `false`.
#### Signature:
```typescript
interface BrowserLaunchArgumentOptions {
devtools?: boolean;
}
```
#### Default value:
`false`

View File

@ -1,19 +0,0 @@
---
sidebar_label: BrowserLaunchArgumentOptions.headless
---
# BrowserLaunchArgumentOptions.headless property
Whether to run the browser in headless mode.
#### Signature:
```typescript
interface BrowserLaunchArgumentOptions {
headless?: boolean | 'new';
}
```
#### Default value:
true

View File

@ -1,23 +0,0 @@
---
sidebar_label: BrowserLaunchArgumentOptions
---
# BrowserLaunchArgumentOptions interface
Launcher options that only apply to Chrome.
#### Signature:
```typescript
export interface BrowserLaunchArgumentOptions
```
## Properties
| Property | Modifiers | Type | Description | Default |
| --------------------------------------------------------------------------- | --------- | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ |
| [args?](./puppeteer.browserlaunchargumentoptions.args.md) | | string\[\] | _(Optional)_ Additional command line arguments to pass to the browser instance. | |
| [debuggingPort?](./puppeteer.browserlaunchargumentoptions.debuggingport.md) | | number | _(Optional)_ | |
| [devtools?](./puppeteer.browserlaunchargumentoptions.devtools.md) | | boolean | _(Optional)_ Whether to auto-open a DevTools panel for each tab. If this is set to <code>true</code>, then <code>headless</code> will be forced to <code>false</code>. | <code>false</code> |
| [headless?](./puppeteer.browserlaunchargumentoptions.headless.md) | | boolean \| 'new' | _(Optional)_ Whether to run the browser in headless mode. | true |
| [userDataDir?](./puppeteer.browserlaunchargumentoptions.userdatadir.md) | | string | _(Optional)_ Path to a user data directory. [see the Chromium docs](https://chromium.googlesource.com/chromium/src/+/refs/heads/main/docs/user_data_dir.md) for more info. | |

View File

@ -1,15 +0,0 @@
---
sidebar_label: BrowserLaunchArgumentOptions.userDataDir
---
# BrowserLaunchArgumentOptions.userDataDir property
Path to a user data directory. [see the Chromium docs](https://chromium.googlesource.com/chromium/src/+/refs/heads/main/docs/user_data_dir.md) for more info.
#### Signature:
```typescript
interface BrowserLaunchArgumentOptions {
userDataDir?: string;
}
```

View File

@ -1,17 +0,0 @@
---
sidebar_label: CDPSessionOnMessageObject.error
---
# CDPSessionOnMessageObject.error property
#### Signature:
```typescript
interface CDPSessionOnMessageObject {
error: {
message: string;
data: any;
code: number;
};
}
```

View File

@ -1,13 +0,0 @@
---
sidebar_label: CDPSessionOnMessageObject.id
---
# CDPSessionOnMessageObject.id property
#### Signature:
```typescript
interface CDPSessionOnMessageObject {
id?: number;
}
```

View File

@ -1,21 +0,0 @@
---
sidebar_label: CDPSessionOnMessageObject
---
# CDPSessionOnMessageObject interface
#### Signature:
```typescript
export interface CDPSessionOnMessageObject
```
## Properties
| Property | Modifiers | Type | Description | Default |
| ---------------------------------------------------------- | --------- | --------------------------------------------- | ------------ | ------- |
| [error](./puppeteer.cdpsessiononmessageobject.error.md) | | { message: string; data: any; code: number; } | | |
| [id?](./puppeteer.cdpsessiononmessageobject.id.md) | | number | _(Optional)_ | |
| [method](./puppeteer.cdpsessiononmessageobject.method.md) | | string | | |
| [params](./puppeteer.cdpsessiononmessageobject.params.md) | | Record&lt;string, unknown&gt; | | |
| [result?](./puppeteer.cdpsessiononmessageobject.result.md) | | any | _(Optional)_ | |

View File

@ -1,13 +0,0 @@
---
sidebar_label: CDPSessionOnMessageObject.method
---
# CDPSessionOnMessageObject.method property
#### Signature:
```typescript
interface CDPSessionOnMessageObject {
method: string;
}
```

View File

@ -1,13 +0,0 @@
---
sidebar_label: CDPSessionOnMessageObject.params
---
# CDPSessionOnMessageObject.params property
#### Signature:
```typescript
interface CDPSessionOnMessageObject {
params: Record<string, unknown>;
}
```

View File

@ -1,13 +0,0 @@
---
sidebar_label: CDPSessionOnMessageObject.result
---
# CDPSessionOnMessageObject.result property
#### Signature:
```typescript
interface CDPSessionOnMessageObject {
result?: any;
}
```

View File

@ -1,17 +0,0 @@
---
sidebar_label: ClickOptions.button
---
# ClickOptions.button property
#### Signature:
```typescript
interface ClickOptions {
button?: MouseButton;
}
```
#### Default value:
'left'

View File

@ -1,17 +0,0 @@
---
sidebar_label: ClickOptions.clickCount
---
# ClickOptions.clickCount property
#### Signature:
```typescript
interface ClickOptions {
clickCount?: number;
}
```
#### Default value:
1

View File

@ -1,19 +0,0 @@
---
sidebar_label: ClickOptions.delay
---
# ClickOptions.delay property
Time to wait between `mousedown` and `mouseup` in milliseconds.
#### Signature:
```typescript
interface ClickOptions {
delay?: number;
}
```
#### Default value:
0

View File

@ -1,20 +0,0 @@
---
sidebar_label: ClickOptions
---
# ClickOptions interface
#### Signature:
```typescript
export interface ClickOptions
```
## Properties
| Property | Modifiers | Type | Description | Default |
| ----------------------------------------------------- | --------- | ----------------------------------------- | -------------------------------------------------------------------------------------------------- | ------- |
| [button?](./puppeteer.clickoptions.button.md) | | [MouseButton](./puppeteer.mousebutton.md) | _(Optional)_ | 'left' |
| [clickCount?](./puppeteer.clickoptions.clickcount.md) | | number | _(Optional)_ | 1 |
| [delay?](./puppeteer.clickoptions.delay.md) | | number | _(Optional)_ Time to wait between <code>mousedown</code> and <code>mouseup</code> in milliseconds. | 0 |
| [offset?](./puppeteer.clickoptions.offset.md) | | [Offset](./puppeteer.offset.md) | _(Optional)_ Offset for the clickable point relative to the top-left corner of the border box. | |

View File

@ -1,15 +0,0 @@
---
sidebar_label: ClickOptions.offset
---
# ClickOptions.offset property
Offset for the clickable point relative to the top-left corner of the border box.
#### Signature:
```typescript
interface ClickOptions {
offset?: Offset;
}
```

View File

@ -1,23 +0,0 @@
---
sidebar_label: Configuration.browserRevision
---
# Configuration.browserRevision property
Specifies a certain version of the browser you'd like Puppeteer to use.
Can be overridden by `PUPPETEER_BROWSER_REVISION`.
See [puppeteer.launch](./puppeteer.puppeteernode.launch.md) on how executable path is inferred.
#### Signature:
```typescript
interface Configuration {
browserRevision?: string;
}
```
#### Default value:
A compatible-revision of the browser.

View File

@ -1,21 +0,0 @@
---
sidebar_label: Configuration.cacheDirectory
---
# Configuration.cacheDirectory property
Defines the directory to be used by Puppeteer for caching.
Can be overridden by `PUPPETEER_CACHE_DIR`.
#### Signature:
```typescript
interface Configuration {
cacheDirectory?: string;
}
```
#### Default value:
`path.join(os.homedir(), '.cache', 'puppeteer')`

View File

@ -1,21 +0,0 @@
---
sidebar_label: Configuration.defaultProduct
---
# Configuration.defaultProduct property
Specifies which browser you'd like Puppeteer to use.
Can be overridden by `PUPPETEER_PRODUCT`.
#### Signature:
```typescript
interface Configuration {
defaultProduct?: Product;
}
```
#### Default value:
`'chrome'`

View File

@ -1,25 +0,0 @@
---
sidebar_label: Configuration.downloadHost
---
# Configuration.downloadHost property
Specifies the URL prefix that is used to download Chromium.
Can be overridden by `PUPPETEER_DOWNLOAD_HOST`.
#### Signature:
```typescript
interface Configuration {
downloadHost?: string;
}
```
#### Default value:
Either https://storage.googleapis.com or https://archive.mozilla.org/pub/firefox/nightly/latest-mozilla-central, depending on the product.
## Remarks
This must include the protocol and may even need a path prefix.

View File

@ -1,21 +0,0 @@
---
sidebar_label: Configuration.downloadPath
---
# Configuration.downloadPath property
Specifies the path for the downloads folder.
Can be overridden by `PUPPETEER_DOWNLOAD_PATH`.
#### Signature:
```typescript
interface Configuration {
downloadPath?: string;
}
```
#### Default value:
`<cache>/<product>` where `<cache>` is Puppeteer's cache directory and `<product>` is the name of the browser.

View File

@ -1,21 +0,0 @@
---
sidebar_label: Configuration.executablePath
---
# Configuration.executablePath property
Specifies an executable path to be used in [puppeteer.launch](./puppeteer.puppeteernode.launch.md).
Can be overridden by `PUPPETEER_EXECUTABLE_PATH`.
#### Signature:
```typescript
interface Configuration {
executablePath?: string;
}
```
#### Default value:
Auto-computed.

View File

@ -1,15 +0,0 @@
---
sidebar_label: Configuration.experiments
---
# Configuration.experiments property
Defines experimental options for Puppeteer.
#### Signature:
```typescript
interface Configuration {
experiments?: ExperimentsConfiguration;
}
```

View File

@ -1,21 +0,0 @@
---
sidebar_label: Configuration.logLevel
---
# Configuration.logLevel property
Tells Puppeteer to log at the given level.
At the moment, any option silences logging.
#### Signature:
```typescript
interface Configuration {
logLevel?: 'silent' | 'error' | 'warn';
}
```
#### Default value:
`undefined`

View File

@ -1,30 +0,0 @@
---
sidebar_label: Configuration
---
# Configuration interface
Defines options to configure Puppeteer's behavior during installation and runtime.
See individual properties for more information.
#### Signature:
```typescript
export interface Configuration
```
## Properties
| Property | Modifiers | Type | Description | Default |
| ---------------------------------------------------------------------- | --------- | ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [browserRevision?](./puppeteer.configuration.browserrevision.md) | | string | <p>_(Optional)_ Specifies a certain version of the browser you'd like Puppeteer to use.</p><p>Can be overridden by <code>PUPPETEER_BROWSER_REVISION</code>.</p><p>See [puppeteer.launch](./puppeteer.puppeteernode.launch.md) on how executable path is inferred.</p> | A compatible-revision of the browser. |
| [cacheDirectory?](./puppeteer.configuration.cachedirectory.md) | | string | <p>_(Optional)_ Defines the directory to be used by Puppeteer for caching.</p><p>Can be overridden by <code>PUPPETEER_CACHE_DIR</code>.</p> | <code>path.join(os.homedir(), '.cache', 'puppeteer')</code> |
| [defaultProduct?](./puppeteer.configuration.defaultproduct.md) | | [Product](./puppeteer.product.md) | <p>_(Optional)_ Specifies which browser you'd like Puppeteer to use.</p><p>Can be overridden by <code>PUPPETEER_PRODUCT</code>.</p> | <code>'chrome'</code> |
| [downloadHost?](./puppeteer.configuration.downloadhost.md) | | string | <p>_(Optional)_ Specifies the URL prefix that is used to download Chromium.</p><p>Can be overridden by <code>PUPPETEER_DOWNLOAD_HOST</code>.</p> | Either https://storage.googleapis.com or https://archive.mozilla.org/pub/firefox/nightly/latest-mozilla-central, depending on the product. |
| [downloadPath?](./puppeteer.configuration.downloadpath.md) | | string | <p>_(Optional)_ Specifies the path for the downloads folder.</p><p>Can be overridden by <code>PUPPETEER_DOWNLOAD_PATH</code>.</p> | <code>&lt;cache&gt;/&lt;product&gt;</code> where <code>&lt;cache&gt;</code> is Puppeteer's cache directory and <code>&lt;product&gt;</code> is the name of the browser. |
| [executablePath?](./puppeteer.configuration.executablepath.md) | | string | <p>_(Optional)_ Specifies an executable path to be used in [puppeteer.launch](./puppeteer.puppeteernode.launch.md).</p><p>Can be overridden by <code>PUPPETEER_EXECUTABLE_PATH</code>.</p> | Auto-computed. |
| [experiments?](./puppeteer.configuration.experiments.md) | | [ExperimentsConfiguration](./puppeteer.experimentsconfiguration.md) | _(Optional)_ Defines experimental options for Puppeteer. | |
| [logLevel?](./puppeteer.configuration.loglevel.md) | | 'silent' \| 'error' \| 'warn' | <p>_(Optional)_ Tells Puppeteer to log at the given level.</p><p>At the moment, any option silences logging.</p> | <code>undefined</code> |
| [skipDownload?](./puppeteer.configuration.skipdownload.md) | | boolean | <p>_(Optional)_ Tells Puppeteer to not download during installation.</p><p>Can be overridden by <code>PUPPETEER_SKIP_DOWNLOAD</code>.</p> | |
| [temporaryDirectory?](./puppeteer.configuration.temporarydirectory.md) | | string | <p>_(Optional)_ Defines the directory to be used by Puppeteer for creating temporary files.</p><p>Can be overridden by <code>PUPPETEER_TMP_DIR</code>.</p> | <code>os.tmpdir()</code> |

View File

@ -1,17 +0,0 @@
---
sidebar_label: Configuration.skipDownload
---
# Configuration.skipDownload property
Tells Puppeteer to not download during installation.
Can be overridden by `PUPPETEER_SKIP_DOWNLOAD`.
#### Signature:
```typescript
interface Configuration {
skipDownload?: boolean;
}
```

View File

@ -1,21 +0,0 @@
---
sidebar_label: Configuration.temporaryDirectory
---
# Configuration.temporaryDirectory property
Defines the directory to be used by Puppeteer for creating temporary files.
Can be overridden by `PUPPETEER_TMP_DIR`.
#### Signature:
```typescript
interface Configuration {
temporaryDirectory?: string;
}
```
#### Default value:
`os.tmpdir()`

View File

@ -1,13 +0,0 @@
---
sidebar_label: Connection.timeout
---
# Connection.timeout property
#### Signature:
```typescript
class Connection {
get timeout(): number;
}
```

View File

@ -1,25 +0,0 @@
---
sidebar_label: ConnectionTransport
---
# ConnectionTransport interface
#### Signature:
```typescript
export interface ConnectionTransport
```
## Properties
| Property | Modifiers | Type | Description | Default |
| ---------------------------------------------------------- | --------- | ---------------------------- | ------------ | ------- |
| [onclose?](./puppeteer.connectiontransport.onclose.md) | | () =&gt; void | _(Optional)_ | |
| [onmessage?](./puppeteer.connectiontransport.onmessage.md) | | (message: string) =&gt; void | _(Optional)_ | |
## Methods
| Method | Description |
| -------------------------------------------------------- | ----------- |
| [close()](./puppeteer.connectiontransport.close.md) | |
| [send(message)](./puppeteer.connectiontransport.send.md) | |

View File

@ -1,13 +0,0 @@
---
sidebar_label: ConnectionTransport.onclose
---
# ConnectionTransport.onclose property
#### Signature:
```typescript
interface ConnectionTransport {
onclose?: () => void;
}
```

View File

@ -1,13 +0,0 @@
---
sidebar_label: ConnectionTransport.onmessage
---
# ConnectionTransport.onmessage property
#### Signature:
```typescript
interface ConnectionTransport {
onmessage?: (message: string) => void;
}
```

View File

@ -1,13 +0,0 @@
---
sidebar_label: ConnectOptions.browserURL
---
# ConnectOptions.browserURL property
#### Signature:
```typescript
interface ConnectOptions {
browserURL?: string;
}
```

View File

@ -1,13 +0,0 @@
---
sidebar_label: ConnectOptions.browserWSEndpoint
---
# ConnectOptions.browserWSEndpoint property
#### Signature:
```typescript
interface ConnectOptions {
browserWSEndpoint?: string;
}
```

View File

@ -1,19 +0,0 @@
---
sidebar_label: ConnectOptions.headers
---
# ConnectOptions.headers property
Headers to use for the web socket connection.
#### Signature:
```typescript
interface ConnectOptions {
headers?: Record<string, string>;
}
```
## Remarks
Only works in the Node.js environment.

View File

@ -1,22 +0,0 @@
---
sidebar_label: ConnectOptions
---
# ConnectOptions interface
#### Signature:
```typescript
export interface ConnectOptions extends BrowserConnectOptions
```
**Extends:** [BrowserConnectOptions](./puppeteer.browserconnectoptions.md)
## Properties
| Property | Modifiers | Type | Description | Default |
| --------------------------------------------------------------------- | --------- | --------------------------------------------------------- | ---------------------------------------------------------- | ------- |
| [browserURL?](./puppeteer.connectoptions.browserurl.md) | | string | _(Optional)_ | |
| [browserWSEndpoint?](./puppeteer.connectoptions.browserwsendpoint.md) | | string | _(Optional)_ | |
| [headers?](./puppeteer.connectoptions.headers.md) | | Record&lt;string, string&gt; | _(Optional)_ Headers to use for the web socket connection. | |
| [transport?](./puppeteer.connectoptions.transport.md) | | [ConnectionTransport](./puppeteer.connectiontransport.md) | _(Optional)_ | |

View File

@ -1,13 +0,0 @@
---
sidebar_label: ConnectOptions.transport
---
# ConnectOptions.transport property
#### Signature:
```typescript
interface ConnectOptions {
transport?: ConnectionTransport;
}
```

View File

@ -1,15 +0,0 @@
---
sidebar_label: ConsoleMessageLocation.columnNumber
---
# ConsoleMessageLocation.columnNumber property
0-based column number in the resource if known or `undefined` otherwise.
#### Signature:
```typescript
interface ConsoleMessageLocation {
columnNumber?: number;
}
```

View File

@ -1,15 +0,0 @@
---
sidebar_label: ConsoleMessageLocation.lineNumber
---
# ConsoleMessageLocation.lineNumber property
0-based line number in the resource if known or `undefined` otherwise.
#### Signature:
```typescript
interface ConsoleMessageLocation {
lineNumber?: number;
}
```

View File

@ -1,19 +0,0 @@
---
sidebar_label: ConsoleMessageLocation
---
# ConsoleMessageLocation interface
#### Signature:
```typescript
export interface ConsoleMessageLocation
```
## Properties
| Property | Modifiers | Type | Description | Default |
| ------------------------------------------------------------------- | --------- | ------ | ------------------------------------------------------------------------------------------------ | ------- |
| [columnNumber?](./puppeteer.consolemessagelocation.columnnumber.md) | | number | _(Optional)_ 0-based column number in the resource if known or <code>undefined</code> otherwise. | |
| [lineNumber?](./puppeteer.consolemessagelocation.linenumber.md) | | number | _(Optional)_ 0-based line number in the resource if known or <code>undefined</code> otherwise. | |
| [url?](./puppeteer.consolemessagelocation.url.md) | | string | _(Optional)_ URL of the resource if known or <code>undefined</code> otherwise. | |

View File

@ -1,15 +0,0 @@
---
sidebar_label: ConsoleMessageLocation.url
---
# ConsoleMessageLocation.url property
URL of the resource if known or `undefined` otherwise.
#### Signature:
```typescript
interface ConsoleMessageLocation {
url?: string;
}
```

View File

@ -1,13 +0,0 @@
---
sidebar_label: ContinueRequestOverrides.headers
---
# ContinueRequestOverrides.headers property
#### Signature:
```typescript
interface ContinueRequestOverrides {
headers?: Record<string, string>;
}
```

View File

@ -1,20 +0,0 @@
---
sidebar_label: ContinueRequestOverrides
---
# ContinueRequestOverrides interface
#### Signature:
```typescript
export interface ContinueRequestOverrides
```
## Properties
| Property | Modifiers | Type | Description | Default |
| ------------------------------------------------------------- | --------- | ---------------------------- | ------------------------------------------------------------------------- | ------- |
| [headers?](./puppeteer.continuerequestoverrides.headers.md) | | Record&lt;string, string&gt; | _(Optional)_ | |
| [method?](./puppeteer.continuerequestoverrides.method.md) | | string | _(Optional)_ | |
| [postData?](./puppeteer.continuerequestoverrides.postdata.md) | | string | _(Optional)_ | |
| [url?](./puppeteer.continuerequestoverrides.url.md) | | string | _(Optional)_ If set, the request URL will change. This is not a redirect. | |

View File

@ -1,13 +0,0 @@
---
sidebar_label: ContinueRequestOverrides.method
---
# ContinueRequestOverrides.method property
#### Signature:
```typescript
interface ContinueRequestOverrides {
method?: string;
}
```

View File

@ -1,13 +0,0 @@
---
sidebar_label: ContinueRequestOverrides.postData
---
# ContinueRequestOverrides.postData property
#### Signature:
```typescript
interface ContinueRequestOverrides {
postData?: string;
}
```

View File

@ -1,15 +0,0 @@
---
sidebar_label: ContinueRequestOverrides.url
---
# ContinueRequestOverrides.url property
If set, the request URL will change. This is not a redirect.
#### Signature:
```typescript
interface ContinueRequestOverrides {
url?: string;
}
```

View File

@ -1,21 +0,0 @@
---
sidebar_label: CoverageEntry
---
# CoverageEntry interface
The CoverageEntry class represents one entry of the coverage report.
#### Signature:
```typescript
export interface CoverageEntry
```
## Properties
| Property | Modifiers | Type | Description | Default |
| --------------------------------------------- | --------- | -------------------------------------------- | --------------------------------------------- | ------- |
| [ranges](./puppeteer.coverageentry.ranges.md) | | Array&lt;{ start: number; end: number; }&gt; | The covered range as start and end positions. | |
| [text](./puppeteer.coverageentry.text.md) | | string | The content of the style sheet or script. | |
| [url](./puppeteer.coverageentry.url.md) | | string | The URL of the style sheet or script. | |

View File

@ -1,18 +0,0 @@
---
sidebar_label: CoverageEntry.ranges
---
# CoverageEntry.ranges property
The covered range as start and end positions.
#### Signature:
```typescript
interface CoverageEntry {
ranges: Array<{
start: number;
end: number;
}>;
}
```

View File

@ -1,15 +0,0 @@
---
sidebar_label: CoverageEntry.text
---
# CoverageEntry.text property
The content of the style sheet or script.
#### Signature:
```typescript
interface CoverageEntry {
text: string;
}
```

View File

@ -1,15 +0,0 @@
---
sidebar_label: CoverageEntry.url
---
# CoverageEntry.url property
The URL of the style sheet or script.
#### Signature:
```typescript
interface CoverageEntry {
url: string;
}
```

View File

@ -1,18 +0,0 @@
---
sidebar_label: Credentials
---
# Credentials interface
#### Signature:
```typescript
export interface Credentials
```
## Properties
| Property | Modifiers | Type | Description | Default |
| ----------------------------------------------- | --------- | ------ | ----------- | ------- |
| [password](./puppeteer.credentials.password.md) | | string | | |
| [username](./puppeteer.credentials.username.md) | | string | | |

View File

@ -1,13 +0,0 @@
---
sidebar_label: Credentials.password
---
# Credentials.password property
#### Signature:
```typescript
interface Credentials {
password: string;
}
```

View File

@ -1,13 +0,0 @@
---
sidebar_label: Credentials.username
---
# Credentials.username property
#### Signature:
```typescript
interface Credentials {
username: string;
}
```

View File

@ -1,19 +0,0 @@
---
sidebar_label: CSSCoverageOptions
---
# CSSCoverageOptions interface
Set of configurable options for CSS coverage.
#### Signature:
```typescript
export interface CSSCoverageOptions
```
## Properties
| Property | Modifiers | Type | Description | Default |
| ------------------------------------------------------------------------- | --------- | ------- | ----------------------------------------------------------- | ------- |
| [resetOnNavigation?](./puppeteer.csscoverageoptions.resetonnavigation.md) | | boolean | _(Optional)_ Whether to reset coverage on every navigation. | |

View File

@ -1,15 +0,0 @@
---
sidebar_label: CSSCoverageOptions.resetOnNavigation
---
# CSSCoverageOptions.resetOnNavigation property
Whether to reset coverage on every navigation.
#### Signature:
```typescript
interface CSSCoverageOptions {
resetOnNavigation?: boolean;
}
```

View File

@ -1,18 +0,0 @@
---
sidebar_label: CustomQueryHandler
---
# CustomQueryHandler interface
#### Signature:
```typescript
export interface CustomQueryHandler
```
## Properties
| Property | Modifiers | Type | Description | Default |
| ------------------------------------------------------- | --------- | --------------------------------------------------------- | ------------ | ------- |
| [queryAll?](./puppeteer.customqueryhandler.queryall.md) | | (node: Node, selector: string) =&gt; Iterable&lt;Node&gt; | _(Optional)_ | |
| [queryOne?](./puppeteer.customqueryhandler.queryone.md) | | (node: Node, selector: string) =&gt; Node \| null | _(Optional)_ | |

View File

@ -1,13 +0,0 @@
---
sidebar_label: CustomQueryHandler.queryAll
---
# CustomQueryHandler.queryAll property
#### Signature:
```typescript
interface CustomQueryHandler {
queryAll?: (node: Node, selector: string) => Iterable<Node>;
}
```

View File

@ -1,13 +0,0 @@
---
sidebar_label: CustomQueryHandler.queryOne
---
# CustomQueryHandler.queryOne property
#### Signature:
```typescript
interface CustomQueryHandler {
queryOne?: (node: Node, selector: string) => Node | null;
}
```

View File

@ -1,18 +0,0 @@
---
sidebar_label: Device
---
# Device interface
#### Signature:
```typescript
export interface Device
```
## Properties
| Property | Modifiers | Type | Description | Default |
| -------------------------------------------- | --------- | ----------------------------------- | ----------- | ------- |
| [userAgent](./puppeteer.device.useragent.md) | | string | | |
| [viewport](./puppeteer.device.viewport.md) | | [Viewport](./puppeteer.viewport.md) | | |

View File

@ -1,13 +0,0 @@
---
sidebar_label: Device.userAgent
---
# Device.userAgent property
#### Signature:
```typescript
interface Device {
userAgent: string;
}
```

View File

@ -1,13 +0,0 @@
---
sidebar_label: Device.viewport
---
# Device.viewport property
#### Signature:
```typescript
interface Device {
viewport: Viewport;
}
```

Some files were not shown because too many files have changed in this diff Show More