github/puppeteer
0
0
Fork 0
mirror of https://github.com/puppeteer/puppeteer synced 2024-06-14 14:02:48 +00:00
Code Issues Packages Projects Releases Wiki Activity

chore: remove docusaurus metadata from README.md (#8624)

Browse Source
This commit is contained in:
jrandolf 2022-07-05 14:42:31 +02:00 committed by GitHub
parent fc77c1517f
commit 45eb2c607f
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
728 changed files with 15375 additions and 17493 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
.gitignore vendored
View File

@ -2,19 +2,18 @@
node_modules
# Production
build
lib
build/
lib/
# Generated files
coverage
tsconfig.tsbuildinfo
puppeteer.api.json
puppeteer*.tgz
yarn.lock
.docusaurus
.docusaurus/
.cache-loader
.local-chromium
.local-firefox
.local-chromium/
.local-firefox/
test/output-*/
.dev_profile*

43
.prettierignore
View File

@ -1,17 +1,44 @@
# Keep in sync with .gitignore
# Dependencies
node_modules
# Production
build/
lib/
# Generated files
tsconfig.tsbuildinfo
puppeteer.api.json
puppeteer*.tgz
yarn.lock
.docusaurus/
.cache-loader
.local-chromium/
.local-firefox/
test/output-*/
.dev_profile*
# IDE Artifacts
.vscode
# Misc
.DS_Store
.env.local
.env.development.local
.env.test.local
.env.production.local
npm-debug.log*
yarn-debug.log*
yarn-error.log*
# Prettier-only ignores.
assets/
build/
CHANGELOG.md
coverage/
lib/
node_modules/
package-lock.json
package.json
test/assets/
tsconfig.tsbuildinfo
vendor/
yarn.lock
puppeteer.api.json
website/
docs/

5
README.md
View File

@ -1,6 +1,5 @@
---
sidebar_position: 1
---
<!-- docusaurus-metadata-start -->
<!-- docusaurus-metadata-end -->
# Puppeteer

288
docs/api/index.md
View File

@ -1,166 +1,166 @@
---
sidebar_label: API
---
# API Reference
## Classes
| Class | Description |
| --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Accessibility](./puppeteer.accessibility.md) | The Accessibility class provides methods for inspecting Chromium's accessibility tree. The accessibility tree is used by assistive technology such as [screen readers](https://en.wikipedia.org/wiki/Screen_reader) or [switches](https://en.wikipedia.org/wiki/Switch_access). |
| [Browser](./puppeteer.browser.md) | A Browser is created when Puppeteer connects to a Chromium instance, either through [PuppeteerNode.launch()](./puppeteer.puppeteernode.launch.md) or [Puppeteer.connect()](./puppeteer.puppeteer.connect.md). |
| [BrowserContext](./puppeteer.browsercontext.md) | BrowserContexts provide a way to operate multiple independent browser sessions. When a browser is launched, it has a single BrowserContext used by default. The method [Browser.newPage](./puppeteer.browser.newpage.md) creates a page in the default browser context. |
| [BrowserFetcher](./puppeteer.browserfetcher.md) | BrowserFetcher can download and manage different versions of Chromium and Firefox. |
| [CDPSession](./puppeteer.cdpsession.md) | The <code>CDPSession</code> instances are used to talk raw Chrome Devtools Protocol. |
| [Connection](./puppeteer.connection.md) | |
| [ConsoleMessage](./puppeteer.consolemessage.md) | ConsoleMessage objects are dispatched by page via the 'console' event. |
| [Coverage](./puppeteer.coverage.md) | The Coverage class provides methods to gathers information about parts of JavaScript and CSS that were used by the page. |
| [CSSCoverage](./puppeteer.csscoverage.md) | |
| [CustomError](./puppeteer.customerror.md) | |
| [Dialog](./puppeteer.dialog.md) | Dialog instances are dispatched by the [Page](./puppeteer.page.md) via the <code>dialog</code> event. |
| [ElementHandle](./puppeteer.elementhandle.md) | ElementHandle represents an in-page DOM element. |
| [EventEmitter](./puppeteer.eventemitter.md) | The EventEmitter class that many Puppeteer classes extend. |
| [ExecutionContext](./puppeteer.executioncontext.md) | <p>This class represents a context for JavaScript execution. A \[Page\] might have many execution contexts: - each [frame](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe) has "default" execution context that is always created after frame is attached to DOM. This context is returned by the [Frame.executionContext()](./puppeteer.frame.executioncontext.md) method. - [Extension](https://developer.chrome.com/extensions)'s content scripts create additional execution contexts.</p><p>Besides pages, execution contexts can be found in [workers](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API).</p> |
| [FileChooser](./puppeteer.filechooser.md) | File choosers let you react to the page requesting for a file. |
| [Frame](./puppeteer.frame.md) | At every point of time, page exposes its current frame tree via the [page.mainFrame](./puppeteer.page.mainframe.md) and [frame.childFrames](./puppeteer.frame.childframes.md) methods. |
| [HTTPRequest](./puppeteer.httprequest.md) | Represents an HTTP request sent by a page. |
| [HTTPResponse](./puppeteer.httpresponse.md) | The HTTPResponse class represents responses which are received by the [Page](./puppeteer.page.md) class. |
| [JSCoverage](./puppeteer.jscoverage.md) | |
| [JSHandle](./puppeteer.jshandle.md) | Represents an in-page JavaScript object. JSHandles can be created with the [page.evaluateHandle](./puppeteer.page.evaluatehandle.md) method. |
| [Keyboard](./puppeteer.keyboard.md) | Keyboard provides an api for managing a virtual keyboard. The high level api is [Keyboard.type()](./puppeteer.keyboard.type.md), which takes raw characters and generates proper keydown, keypress/input, and keyup events on your page. |
| [Mouse](./puppeteer.mouse.md) | The Mouse class operates in main-frame CSS pixels relative to the top-left corner of the viewport. |
| [Page](./puppeteer.page.md) | <p>Page provides methods to interact with a single tab or [extension background page](https://developer.chrome.com/extensions/background_pages) in Chromium.</p><p>:::note</p><p>One Browser instance might have multiple Page instances.</p><p>:::</p> |
| [ProtocolError](./puppeteer.protocolerror.md) | ProtocolError is emitted whenever there is an error from the protocol. |
| [Puppeteer](./puppeteer.puppeteer.md) | <p>The main Puppeteer class.</p><p>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 <code>puppeteer</code>. That class extends <code>Puppeteer</code>, so has all the methods documented below as well as all that are defined on [PuppeteerNode](./puppeteer.puppeteernode.md).</p> |
| [PuppeteerNode](./puppeteer.puppeteernode.md) | <p>Extends the main [Puppeteer](./puppeteer.puppeteer.md) class with Node specific behaviour for fetching and downloading browsers.</p><p>If you're using Puppeteer in a Node environment, this is the class you'll get when you run <code>require('puppeteer')</code> (or the equivalent ES <code>import</code>).</p> |
| [SecurityDetails](./puppeteer.securitydetails.md) | The SecurityDetails class represents the security details of a response that was received over a secure connection. |
| [Target](./puppeteer.target.md) | |
| [TimeoutError](./puppeteer.timeouterror.md) | TimeoutError is emitted whenever certain operations are terminated due to timeout. |
| [Touchscreen](./puppeteer.touchscreen.md) | The Touchscreen class exposes touchscreen events. |
| [Tracing](./puppeteer.tracing.md) | The Tracing class exposes the tracing audit interface. |
| [WebWorker](./puppeteer.webworker.md) | The WebWorker class represents a [WebWorker](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API). |
| Class | Description |
| --- | --- |
| [Accessibility](./puppeteer.accessibility.md) | The Accessibility class provides methods for inspecting Chromium's accessibility tree. The accessibility tree is used by assistive technology such as [screen readers](https://en.wikipedia.org/wiki/Screen_reader) or [switches](https://en.wikipedia.org/wiki/Switch_access). |
| [Browser](./puppeteer.browser.md) | A Browser is created when Puppeteer connects to a Chromium instance, either through [PuppeteerNode.launch()](./puppeteer.puppeteernode.launch.md) or [Puppeteer.connect()](./puppeteer.puppeteer.connect.md). |
| [BrowserContext](./puppeteer.browsercontext.md) | BrowserContexts provide a way to operate multiple independent browser sessions. When a browser is launched, it has a single BrowserContext used by default. The method [Browser.newPage](./puppeteer.browser.newpage.md) creates a page in the default browser context. |
| [BrowserFetcher](./puppeteer.browserfetcher.md) | BrowserFetcher can download and manage different versions of Chromium and Firefox. |
| [CDPSession](./puppeteer.cdpsession.md) | The <code>CDPSession</code> instances are used to talk raw Chrome Devtools Protocol. |
| [Connection](./puppeteer.connection.md) | |
| [ConsoleMessage](./puppeteer.consolemessage.md) | ConsoleMessage objects are dispatched by page via the 'console' event. |
| [Coverage](./puppeteer.coverage.md) | The Coverage class provides methods to gathers information about parts of JavaScript and CSS that were used by the page. |
| [CSSCoverage](./puppeteer.csscoverage.md) | |
| [CustomError](./puppeteer.customerror.md) | |
| [Dialog](./puppeteer.dialog.md) | Dialog instances are dispatched by the [Page](./puppeteer.page.md) via the <code>dialog</code> event. |
| [ElementHandle](./puppeteer.elementhandle.md) | ElementHandle represents an in-page DOM element. |
| [EventEmitter](./puppeteer.eventemitter.md) | The EventEmitter class that many Puppeteer classes extend. |
| [ExecutionContext](./puppeteer.executioncontext.md) | <p>This class represents a context for JavaScript execution. A \[Page\] might have many execution contexts: - each [frame](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe) has "default" execution context that is always created after frame is attached to DOM. This context is returned by the [Frame.executionContext()](./puppeteer.frame.executioncontext.md) method. - [Extension](https://developer.chrome.com/extensions)'s content scripts create additional execution contexts.</p><p>Besides pages, execution contexts can be found in [workers](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API).</p> |
| [FileChooser](./puppeteer.filechooser.md) | File choosers let you react to the page requesting for a file. |
| [Frame](./puppeteer.frame.md) | At every point of time, page exposes its current frame tree via the [page.mainFrame](./puppeteer.page.mainframe.md) and [frame.childFrames](./puppeteer.frame.childframes.md) methods. |
| [HTTPRequest](./puppeteer.httprequest.md) | Represents an HTTP request sent by a page. |
| [HTTPResponse](./puppeteer.httpresponse.md) | The HTTPResponse class represents responses which are received by the [Page](./puppeteer.page.md) class. |
| [JSCoverage](./puppeteer.jscoverage.md) | |
| [JSHandle](./puppeteer.jshandle.md) | Represents an in-page JavaScript object. JSHandles can be created with the [page.evaluateHandle](./puppeteer.page.evaluatehandle.md) method. |
| [Keyboard](./puppeteer.keyboard.md) | Keyboard provides an api for managing a virtual keyboard. The high level api is [Keyboard.type()](./puppeteer.keyboard.type.md), which takes raw characters and generates proper keydown, keypress/input, and keyup events on your page. |
| [Mouse](./puppeteer.mouse.md) | The Mouse class operates in main-frame CSS pixels relative to the top-left corner of the viewport. |
| [Page](./puppeteer.page.md) | <p>Page provides methods to interact with a single tab or [extension background page](https://developer.chrome.com/extensions/background_pages) in Chromium.</p><p>:::note</p><p>One Browser instance might have multiple Page instances.</p><p>:::</p> |
| [ProtocolError](./puppeteer.protocolerror.md) | ProtocolError is emitted whenever there is an error from the protocol. |
| [Puppeteer](./puppeteer.puppeteer.md) | <p>The main Puppeteer class.</p><p>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 <code>puppeteer</code>. That class extends <code>Puppeteer</code>, so has all the methods documented below as well as all that are defined on [PuppeteerNode](./puppeteer.puppeteernode.md).</p> |
| [PuppeteerNode](./puppeteer.puppeteernode.md) | <p>Extends the main [Puppeteer](./puppeteer.puppeteer.md) class with Node specific behaviour for fetching and downloading browsers.</p><p>If you're using Puppeteer in a Node environment, this is the class you'll get when you run <code>require('puppeteer')</code> (or the equivalent ES <code>import</code>).</p> |
| [SecurityDetails](./puppeteer.securitydetails.md) | The SecurityDetails class represents the security details of a response that was received over a secure connection. |
| [Target](./puppeteer.target.md) | |
| [TimeoutError](./puppeteer.timeouterror.md) | TimeoutError is emitted whenever certain operations are terminated due to timeout. |
| [Touchscreen](./puppeteer.touchscreen.md) | The Touchscreen class exposes touchscreen events. |
| [Tracing](./puppeteer.tracing.md) | The Tracing class exposes the tracing audit interface. |
| [WebWorker](./puppeteer.webworker.md) | The WebWorker class represents a [WebWorker](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API). |
## Enumerations
| Enumeration | Description |
| ------------------------------------------------------------------------- | --------------------------------------------------------------------- |
| [BrowserContextEmittedEvents](./puppeteer.browsercontextemittedevents.md) | |
| [BrowserEmittedEvents](./puppeteer.browseremittedevents.md) | All the events a [browser instance](./puppeteer.browser.md) may emit. |
| [InterceptResolutionAction](./puppeteer.interceptresolutionaction.md) | |
| [PageEmittedEvents](./puppeteer.pageemittedevents.md) | All the events that a page instance may emit. |
| Enumeration | Description |
| --- | --- |
| [BrowserContextEmittedEvents](./puppeteer.browsercontextemittedevents.md) | |
| [BrowserEmittedEvents](./puppeteer.browseremittedevents.md) | All the events a [browser instance](./puppeteer.browser.md) may emit. |
| [InterceptResolutionAction](./puppeteer.interceptresolutionaction.md) | |
| [PageEmittedEvents](./puppeteer.pageemittedevents.md) | All the events that a page instance may emit. |
## Functions
| Function | Description |
| -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| [clearCustomQueryHandlers()](./puppeteer.clearcustomqueryhandlers.md) | Clears all registered handlers. |
| [customQueryHandlerNames()](./puppeteer.customqueryhandlernames.md) | |
| [registerCustomQueryHandler(name, handler)](./puppeteer.registercustomqueryhandler.md) | Registers a [custom query handler](./puppeteer.customqueryhandler.md). |
| [unregisterCustomQueryHandler(name)](./puppeteer.unregistercustomqueryhandler.md) | |
| Function | Description |
| --- | --- |
| [clearCustomQueryHandlers()](./puppeteer.clearcustomqueryhandlers.md) | Clears all registered handlers. |
| [customQueryHandlerNames()](./puppeteer.customqueryhandlernames.md) | |
| [registerCustomQueryHandler(name, handler)](./puppeteer.registercustomqueryhandler.md) | Registers a [custom query handler](./puppeteer.customqueryhandler.md). |
| [unregisterCustomQueryHandler(name)](./puppeteer.unregistercustomqueryhandler.md) | |
## Interfaces
| Interface | Description |
| --------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [BoundingBox](./puppeteer.boundingbox.md) | |
| [BoxModel](./puppeteer.boxmodel.md) | |
| [BrowserConnectOptions](./puppeteer.browserconnectoptions.md) | Generic browser options that can be passed when launching any browser or when connecting to an existing browser instance. |
| [BrowserContextOptions](./puppeteer.browsercontextoptions.md) | BrowserContext options. |
| [BrowserFetcherOptions](./puppeteer.browserfetcheroptions.md) | |
| [BrowserFetcherRevisionInfo](./puppeteer.browserfetcherrevisioninfo.md) | |
| [BrowserLaunchArgumentOptions](./puppeteer.browserlaunchargumentoptions.md) | Launcher options that only apply to Chrome. |
| [CDPSessionOnMessageObject](./puppeteer.cdpsessiononmessageobject.md) | |
| [ClickOptions](./puppeteer.clickoptions.md) | |
| [CommonEventEmitter](./puppeteer.commoneventemitter.md) | |
| [ConnectionCallback](./puppeteer.connectioncallback.md) | |
| [ConnectionTransport](./puppeteer.connectiontransport.md) | |
| [ConnectOptions](./puppeteer.connectoptions.md) | |
| [ConsoleMessageLocation](./puppeteer.consolemessagelocation.md) | |
| [ContinueRequestOverrides](./puppeteer.continuerequestoverrides.md) | |
| [CoverageEntry](./puppeteer.coverageentry.md) | The CoverageEntry class represents one entry of the coverage report. |
| [Credentials](./puppeteer.credentials.md) | |
| [CSSCoverageOptions](./puppeteer.csscoverageoptions.md) | Set of configurable options for CSS coverage. |
| [CustomQueryHandler](./puppeteer.customqueryhandler.md) | Contains two functions <code>queryOne</code> and <code>queryAll</code> that can be [registered](./puppeteer.registercustomqueryhandler.md) as alternative querying strategies. The functions <code>queryOne</code> and <code>queryAll</code> are executed in the page context. <code>queryOne</code> should take an <code>Element</code> and a selector string as argument and return a single <code>Element</code> or <code>null</code> if no element is found. <code>queryAll</code> takes the same arguments but should instead return a <code>NodeListOf&lt;Element&gt;</code> or <code>Array&lt;Element&gt;</code> with all the elements that match the given query selector. |
| [Device](./puppeteer.device.md) | |
| [FrameAddScriptTagOptions](./puppeteer.frameaddscripttagoptions.md) | |
| [FrameAddStyleTagOptions](./puppeteer.frameaddstyletagoptions.md) | |
| [FrameWaitForFunctionOptions](./puppeteer.framewaitforfunctionoptions.md) | |
| [GeolocationOptions](./puppeteer.geolocationoptions.md) | |
| [InterceptResolutionState](./puppeteer.interceptresolutionstate.md) | |
| [InternalNetworkConditions](./puppeteer.internalnetworkconditions.md) | |
| [JSCoverageEntry](./puppeteer.jscoverageentry.md) | The CoverageEntry class for JavaScript |
| [JSCoverageOptions](./puppeteer.jscoverageoptions.md) | Set of configurable options for JS coverage. |
| [LaunchOptions](./puppeteer.launchoptions.md) | Generic launch options that can be passed when launching any browser. |
| [MediaFeature](./puppeteer.mediafeature.md) | |
| [Metrics](./puppeteer.metrics.md) | |
| [MouseOptions](./puppeteer.mouseoptions.md) | |
| [MouseWheelOptions](./puppeteer.mousewheeloptions.md) | |
| [NetworkConditions](./puppeteer.networkconditions.md) | |
| [Offset](./puppeteer.offset.md) | |
| [PageEventObject](./puppeteer.pageeventobject.md) | <p>Denotes the objects received by callback functions for page events.</p><p>See [PageEmittedEvents](./puppeteer.pageemittedevents.md) for more detail on the events and when they are emitted.</p> |
| [PDFMargin](./puppeteer.pdfmargin.md) | |
| [PDFOptions](./puppeteer.pdfoptions.md) | Valid options to configure PDF generation via [Page.pdf()](./puppeteer.page.pdf.md). |
| [Point](./puppeteer.point.md) | |
| [PressOptions](./puppeteer.pressoptions.md) | |
| [ProductLauncher](./puppeteer.productlauncher.md) | Describes a launcher - a class that is able to create and launch a browser instance. |
| [PuppeteerErrors](./puppeteer.puppeteererrors.md) | |
| [PuppeteerLaunchOptions](./puppeteer.puppeteerlaunchoptions.md) | |
| [RemoteAddress](./puppeteer.remoteaddress.md) | |
| [ResponseForRequest](./puppeteer.responseforrequest.md) | Required response data to fulfill a request with. |
| [ScreenshotClip](./puppeteer.screenshotclip.md) | |
| [ScreenshotOptions](./puppeteer.screenshotoptions.md) | |
| [SerializedAXNode](./puppeteer.serializedaxnode.md) | Represents a Node and the properties of it that are relevant to Accessibility. |
| [SnapshotOptions](./puppeteer.snapshotoptions.md) | |
| [TracingOptions](./puppeteer.tracingoptions.md) | |
| [Viewport](./puppeteer.viewport.md) | Sets the viewport of the page. |
| [WaitForOptions](./puppeteer.waitforoptions.md) | |
| [WaitForSelectorOptions](./puppeteer.waitforselectoroptions.md) | |
| [WaitForTargetOptions](./puppeteer.waitfortargetoptions.md) | |
| [WaitTimeoutOptions](./puppeteer.waittimeoutoptions.md) | |
| Interface | Description |
| --- | --- |
| [BoundingBox](./puppeteer.boundingbox.md) | |
| [BoxModel](./puppeteer.boxmodel.md) | |
| [BrowserConnectOptions](./puppeteer.browserconnectoptions.md) | Generic browser options that can be passed when launching any browser or when connecting to an existing browser instance. |
| [BrowserContextOptions](./puppeteer.browsercontextoptions.md) | BrowserContext options. |
| [BrowserFetcherOptions](./puppeteer.browserfetcheroptions.md) | |
| [BrowserFetcherRevisionInfo](./puppeteer.browserfetcherrevisioninfo.md) | |
| [BrowserLaunchArgumentOptions](./puppeteer.browserlaunchargumentoptions.md) | Launcher options that only apply to Chrome. |
| [CDPSessionOnMessageObject](./puppeteer.cdpsessiononmessageobject.md) | |
| [ClickOptions](./puppeteer.clickoptions.md) | |
| [CommonEventEmitter](./puppeteer.commoneventemitter.md) | |
| [ConnectionCallback](./puppeteer.connectioncallback.md) | |
| [ConnectionTransport](./puppeteer.connectiontransport.md) | |
| [ConnectOptions](./puppeteer.connectoptions.md) | |
| [ConsoleMessageLocation](./puppeteer.consolemessagelocation.md) | |
| [ContinueRequestOverrides](./puppeteer.continuerequestoverrides.md) | |
| [CoverageEntry](./puppeteer.coverageentry.md) | The CoverageEntry class represents one entry of the coverage report. |
| [Credentials](./puppeteer.credentials.md) | |
| [CSSCoverageOptions](./puppeteer.csscoverageoptions.md) | Set of configurable options for CSS coverage. |
| [CustomQueryHandler](./puppeteer.customqueryhandler.md) | Contains two functions <code>queryOne</code> and <code>queryAll</code> that can be [registered](./puppeteer.registercustomqueryhandler.md) as alternative querying strategies. The functions <code>queryOne</code> and <code>queryAll</code> are executed in the page context. <code>queryOne</code> should take an <code>Element</code> and a selector string as argument and return a single <code>Element</code> or <code>null</code> if no element is found. <code>queryAll</code> takes the same arguments but should instead return a <code>NodeListOf&lt;Element&gt;</code> or <code>Array&lt;Element&gt;</code> with all the elements that match the given query selector. |
| [Device](./puppeteer.device.md) | |
| [FrameAddScriptTagOptions](./puppeteer.frameaddscripttagoptions.md) | |
| [FrameAddStyleTagOptions](./puppeteer.frameaddstyletagoptions.md) | |
| [FrameWaitForFunctionOptions](./puppeteer.framewaitforfunctionoptions.md) | |
| [GeolocationOptions](./puppeteer.geolocationoptions.md) | |
| [InterceptResolutionState](./puppeteer.interceptresolutionstate.md) | |
| [InternalNetworkConditions](./puppeteer.internalnetworkconditions.md) | |
| [JSCoverageEntry](./puppeteer.jscoverageentry.md) | The CoverageEntry class for JavaScript |
| [JSCoverageOptions](./puppeteer.jscoverageoptions.md) | Set of configurable options for JS coverage. |
| [LaunchOptions](./puppeteer.launchoptions.md) | Generic launch options that can be passed when launching any browser. |
| [MediaFeature](./puppeteer.mediafeature.md) | |
| [Metrics](./puppeteer.metrics.md) | |
| [MouseOptions](./puppeteer.mouseoptions.md) | |
| [MouseWheelOptions](./puppeteer.mousewheeloptions.md) | |
| [NetworkConditions](./puppeteer.networkconditions.md) | |
| [Offset](./puppeteer.offset.md) | |
| [PageEventObject](./puppeteer.pageeventobject.md) | <p>Denotes the objects received by callback functions for page events.</p><p>See [PageEmittedEvents](./puppeteer.pageemittedevents.md) for more detail on the events and when they are emitted.</p> |
| [PDFMargin](./puppeteer.pdfmargin.md) | |
| [PDFOptions](./puppeteer.pdfoptions.md) | Valid options to configure PDF generation via [Page.pdf()](./puppeteer.page.pdf.md). |
| [Point](./puppeteer.point.md) | |
| [PressOptions](./puppeteer.pressoptions.md) | |
| [ProductLauncher](./puppeteer.productlauncher.md) | Describes a launcher - a class that is able to create and launch a browser instance. |
| [PuppeteerErrors](./puppeteer.puppeteererrors.md) | |
| [PuppeteerLaunchOptions](./puppeteer.puppeteerlaunchoptions.md) | |
| [RemoteAddress](./puppeteer.remoteaddress.md) | |
| [ResponseForRequest](./puppeteer.responseforrequest.md) | Required response data to fulfill a request with. |
| [ScreenshotClip](./puppeteer.screenshotclip.md) | |
| [ScreenshotOptions](./puppeteer.screenshotoptions.md) | |
| [SerializedAXNode](./puppeteer.serializedaxnode.md) | Represents a Node and the properties of it that are relevant to Accessibility. |
| [SnapshotOptions](./puppeteer.snapshotoptions.md) | |
| [TracingOptions](./puppeteer.tracingoptions.md) | |
| [Viewport](./puppeteer.viewport.md) | Sets the viewport of the page. |
| [WaitForOptions](./puppeteer.waitforoptions.md) | |
| [WaitForSelectorOptions](./puppeteer.waitforselectoroptions.md) | |
| [WaitForTargetOptions](./puppeteer.waitfortargetoptions.md) | |
| [WaitTimeoutOptions](./puppeteer.waittimeoutoptions.md) | |
## Variables
| Variable | Description |
| --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [connect](./puppeteer.connect.md) | |
| [createBrowserFetcher](./puppeteer.createbrowserfetcher.md) | |
| [DEFAULT_INTERCEPT_RESOLUTION_PRIORITY](./puppeteer.default_intercept_resolution_priority.md) | The default cooperative request interception resolution priority |
| [defaultArgs](./puppeteer.defaultargs.md) | |
| [devices](./puppeteer.devices.md) | A list of devices to be used with <code>page.emulate(options)</code>. Actual list of devices can be found in [src/common/DeviceDescriptors.ts](https://github.com/puppeteer/puppeteer/blob/main/src/common/DeviceDescriptors.ts). |
| [errors](./puppeteer.errors.md) | <p>Puppeteer methods might throw errors if they are unable to fulfill a request. For example, <code>page.waitForSelector(selector[, options])</code> might fail if the selector doesn't match any nodes during the given timeframe.</p><p>For certain types of errors Puppeteer uses specific error classes. These classes are available via <code>puppeteer.errors</code>.</p> |
| [EVALUATION_SCRIPT_URL](./puppeteer.evaluation_script_url.md) | |
| [executablePath](./puppeteer.executablepath.md) | |
| [launch](./puppeteer.launch.md) | |
| [networkConditions](./puppeteer.networkconditions.md) | A list of network conditions to be used with <code>page.emulateNetworkConditions(networkConditions)</code>. Actual list of predefined conditions can be found in [src/common/NetworkConditions.ts](https://github.com/puppeteer/puppeteer/blob/main/src/common/NetworkConditions.ts). |
| Variable | Description |
| --- | --- |
| [connect](./puppeteer.connect.md) | |
| [createBrowserFetcher](./puppeteer.createbrowserfetcher.md) | |
| [DEFAULT\_INTERCEPT\_RESOLUTION\_PRIORITY](./puppeteer.default_intercept_resolution_priority.md) | The default cooperative request interception resolution priority |
| [defaultArgs](./puppeteer.defaultargs.md) | |
| [devices](./puppeteer.devices.md) | A list of devices to be used with <code>page.emulate(options)</code>. Actual list of devices can be found in [src/common/DeviceDescriptors.ts](https://github.com/puppeteer/puppeteer/blob/main/src/common/DeviceDescriptors.ts). |
| [errors](./puppeteer.errors.md) | <p>Puppeteer methods might throw errors if they are unable to fulfill a request. For example, <code>page.waitForSelector(selector[, options])</code> might fail if the selector doesn't match any nodes during the given timeframe.</p><p>For certain types of errors Puppeteer uses specific error classes. These classes are available via <code>puppeteer.errors</code>.</p> |
| [EVALUATION\_SCRIPT\_URL](./puppeteer.evaluation_script_url.md) | |
| [executablePath](./puppeteer.executablepath.md) | |
| [launch](./puppeteer.launch.md) | |
| [networkConditions](./puppeteer.networkconditions.md) | A list of network conditions to be used with <code>page.emulateNetworkConditions(networkConditions)</code>. Actual list of predefined conditions can be found in [src/common/NetworkConditions.ts](https://github.com/puppeteer/puppeteer/blob/main/src/common/NetworkConditions.ts). |
## Type Aliases
| Type Alias | Description |
| ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [ActionResult](./puppeteer.actionresult.md) | |
| [Awaitable](./puppeteer.awaitable.md) | |
| [ChromeReleaseChannel](./puppeteer.chromereleasechannel.md) | |
| [ConsoleMessageType](./puppeteer.consolemessagetype.md) | The supported types for console messages. |
| [DevicesMap](./puppeteer.devicesmap.md) | |
| [ErrorCode](./puppeteer.errorcode.md) | |
| [EvaluateFunc](./puppeteer.evaluatefunc.md) | |
| [EventType](./puppeteer.eventtype.md) | |
| [FlattenHandle](./puppeteer.flattenhandle.md) | |
| [HandleFor](./puppeteer.handlefor.md) | |
| [HandleOr](./puppeteer.handleor.md) | |
| [Handler](./puppeteer.handler.md) | |
| [InnerParams](./puppeteer.innerparams.md) | |
| [InterceptResolutionStrategy](./puppeteer.interceptresolutionstrategy.md) | |
| [KeyInput](./puppeteer.keyinput.md) | All the valid keys that can be passed to functions that take user input, such as [keyboard.press](./puppeteer.keyboard.press.md) |
| [LowerCasePaperFormat](./puppeteer.lowercasepaperformat.md) | |
| [MouseButton](./puppeteer.mousebutton.md) | |
| [PaperFormat](./puppeteer.paperformat.md) | All the valid paper format types when printing a PDF. |
| [Permission](./puppeteer.permission.md) | |
| [Platform](./puppeteer.platform.md) | Supported platforms. |
| [Product](./puppeteer.product.md) | Supported products. |
| [ProtocolLifeCycleEvent](./puppeteer.protocollifecycleevent.md) | |
| [PuppeteerLifeCycleEvent](./puppeteer.puppeteerlifecycleevent.md) | |
| [PuppeteerNodeLaunchOptions](./puppeteer.puppeteernodelaunchoptions.md) | Utility type exposed to enable users to define options that can be passed to <code>puppeteer.launch</code> without having to list the set of all types. |
| [ResourceType](./puppeteer.resourcetype.md) | Resource types for HTTPRequests as perceived by the rendering engine. |
| [TargetFilterCallback](./puppeteer.targetfiltercallback.md) | |
| Type Alias | Description |
| --- | --- |
| [ActionResult](./puppeteer.actionresult.md) | |
| [Awaitable](./puppeteer.awaitable.md) | |
| [ChromeReleaseChannel](./puppeteer.chromereleasechannel.md) | |
| [ConsoleMessageType](./puppeteer.consolemessagetype.md) | The supported types for console messages. |
| [DevicesMap](./puppeteer.devicesmap.md) | |
| [ErrorCode](./puppeteer.errorcode.md) | |
| [EvaluateFunc](./puppeteer.evaluatefunc.md) | |
| [EventType](./puppeteer.eventtype.md) | |
| [FlattenHandle](./puppeteer.flattenhandle.md) | |
| [HandleFor](./puppeteer.handlefor.md) | |
| [HandleOr](./puppeteer.handleor.md) | |
| [Handler](./puppeteer.handler.md) | |
| [InnerParams](./puppeteer.innerparams.md) | |
| [InterceptResolutionStrategy](./puppeteer.interceptresolutionstrategy.md) | |
| [KeyInput](./puppeteer.keyinput.md) | All the valid keys that can be passed to functions that take user input, such as [keyboard.press](./puppeteer.keyboard.press.md) |
| [LowerCasePaperFormat](./puppeteer.lowercasepaperformat.md) | |
| [MouseButton](./puppeteer.mousebutton.md) | |
| [PaperFormat](./puppeteer.paperformat.md) | All the valid paper format types when printing a PDF. |
| [Permission](./puppeteer.permission.md) | |
| [Platform](./puppeteer.platform.md) | Supported platforms. |
| [Product](./puppeteer.product.md) | Supported products. |
| [ProtocolLifeCycleEvent](./puppeteer.protocollifecycleevent.md) | |
| [PuppeteerLifeCycleEvent](./puppeteer.puppeteerlifecycleevent.md) | |
| [PuppeteerNodeLaunchOptions](./puppeteer.puppeteernodelaunchoptions.md) | Utility type exposed to enable users to define options that can be passed to <code>puppeteer.launch</code> without having to list the set of all types. |
| [ResourceType](./puppeteer.resourcetype.md) | Resource types for HTTPRequests as perceived by the rendering engine. |
| [TargetFilterCallback](./puppeteer.targetfiltercallback.md) | |

8
docs/api/puppeteer.accessibility.md
View File

@ -1,7 +1,6 @@
---
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).
@ -24,6 +23,7 @@ The constructor for this class is marked as internal. Third-party code should no
## 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. |
| 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. |

15
docs/api/puppeteer.accessibility.snapshot.md
View File

@ -1,7 +1,6 @@
---
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.
@ -9,16 +8,14 @@ Captures the current state of the accessibility tree. The returned object repres
**Signature:**
```typescript
class Accessibility {
snapshot(options?: SnapshotOptions): Promise<SerializedAXNode | null>;
}
class Accessibility {snapshot(options?: SnapshotOptions): Promise<SerializedAXNode | null>;}
```
## Parameters
| Parameter | Type | Description |
| --------- | ------------------------------------------------- | ----------------- |
| options | [SnapshotOptions](./puppeteer.snapshotoptions.md) | <i>(Optional)</i> |
| Parameter | Type | Description |
| --- | --- | --- |
| options | [SnapshotOptions](./puppeteer.snapshotoptions.md) | <i>(Optional)</i> |
**Returns:**
@ -49,7 +46,8 @@ const node = findFocusedNode(snapshot);
console.log(node && node.name);
function findFocusedNode(node) {
if (node.focused) return node;
if (node.focused)
return node;
for (const child of node.children || []) {
const foundNode = findFocusedNode(child);
return foundNode;
@ -57,3 +55,4 @@ function findFocusedNode(node) {
return null;
}
```

2
docs/api/puppeteer.actionresult.md
View File

@ -1,9 +1,9 @@
---
sidebar_label: ActionResult
---
# ActionResult type
**Signature:**
```typescript

2
docs/api/puppeteer.awaitable.md
View File

@ -1,9 +1,9 @@
---
sidebar_label: Awaitable
---
# Awaitable type
**Signature:**
```typescript

5
docs/api/puppeteer.boundingbox.height.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: BoundingBox.height
---
# BoundingBox.height property
the height of the element in pixels.
@ -9,7 +8,5 @@ the height of the element in pixels.
**Signature:**
```typescript
interface BoundingBox {
height: number;
}
interface BoundingBox {height: number;}
```

12
docs/api/puppeteer.boundingbox.md
View File

@ -1,20 +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. |
| 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. |

5
docs/api/puppeteer.boundingbox.width.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: BoundingBox.width
---
# BoundingBox.width property
the width of the element in pixels.
@ -9,7 +8,5 @@ the width of the element in pixels.
**Signature:**
```typescript
interface BoundingBox {
width: number;
}
interface BoundingBox {width: number;}
```

5
docs/api/puppeteer.boxmodel.border.md
View File

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

5
docs/api/puppeteer.boxmodel.content.md
View File

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

5
docs/api/puppeteer.boxmodel.height.md
View File

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

5
docs/api/puppeteer.boxmodel.margin.md
View File

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

19
docs/api/puppeteer.boxmodel.md
View File

@ -1,9 +1,9 @@
---
sidebar_label: BoxModel
---
# BoxModel interface
**Signature:**
```typescript
@ -12,11 +12,12 @@ 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 | |
| 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 | |

5
docs/api/puppeteer.boxmodel.padding.md
View File

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

5
docs/api/puppeteer.boxmodel.width.md
View File

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

7
docs/api/puppeteer.browser.browsercontexts.md
View File

@ -1,7 +1,6 @@
---
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).
@ -9,11 +8,9 @@ Returns an array of all open browser contexts. In a newly created browser, this
**Signature:**
```typescript
class Browser {
browserContexts(): BrowserContext[];
}
class Browser {browserContexts(): BrowserContext[];}
```
**Returns:**
[BrowserContext](./puppeteer.browsercontext.md)\[\]

7
docs/api/puppeteer.browser.close.md
View File

@ -1,7 +1,6 @@
---
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.
@ -9,11 +8,9 @@ Closes Chromium and all of its pages (if any were opened). The [Browser](./puppe
**Signature:**
```typescript
class Browser {
close(): Promise<void>;
}
class Browser {close(): Promise<void>;}
```
**Returns:**
Promise&lt;void&gt;

17
docs/api/puppeteer.browser.createincognitobrowsercontext.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: Browser.createIncognitoBrowserContext
---
# Browser.createIncognitoBrowserContext() method
Creates a new incognito browser context. This won't share cookies/cache with other browser contexts.
@ -9,18 +8,14 @@ Creates a new incognito browser context. This won't share cookies/cache with oth
**Signature:**
```typescript
class Browser {
createIncognitoBrowserContext(
options?: BrowserContextOptions
): Promise<BrowserContext>;
}
class Browser {createIncognitoBrowserContext(options?: BrowserContextOptions): Promise<BrowserContext>;}
```
## Parameters
| Parameter | Type | Description |
| --------- | ------------------------------------------------------------- | ----------------- |
| options | [BrowserContextOptions](./puppeteer.browsercontextoptions.md) | <i>(Optional)</i> |
| Parameter | Type | Description |
| --- | --- | --- |
| options | [BrowserContextOptions](./puppeteer.browsercontextoptions.md) | <i>(Optional)</i> |
**Returns:**
@ -28,9 +23,10 @@ Promise&lt;[BrowserContext](./puppeteer.browsercontext.md)&gt;
## Example
```ts
(async () => {
const browser = await puppeteer.launch();
const browser = await puppeteer.launch();
// Create a new incognito browser context.
const context = await browser.createIncognitoBrowserContext();
// Create a new page in a pristine context.
@ -39,3 +35,4 @@ Promise&lt;[BrowserContext](./puppeteer.browsercontext.md)&gt;
await page.goto('https://example.com');
})();
```

7
docs/api/puppeteer.browser.defaultbrowsercontext.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: Browser.defaultBrowserContext
---
# Browser.defaultBrowserContext() method
Returns the default browser context. The default browser context cannot be closed.
@ -9,11 +8,9 @@ Returns the default browser context. The default browser context cannot be close
**Signature:**
```typescript
class Browser {
defaultBrowserContext(): BrowserContext;
}
class Browser {defaultBrowserContext(): BrowserContext;}
```
**Returns:**
[BrowserContext](./puppeteer.browsercontext.md)

7
docs/api/puppeteer.browser.disconnect.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: Browser.disconnect
---
# Browser.disconnect() method
Disconnects Puppeteer from the browser, but leaves the Chromium process running. After calling `disconnect`, the [Browser](./puppeteer.browser.md) object is considered disposed and cannot be used anymore.
@ -9,11 +8,9 @@ Disconnects Puppeteer from the browser, but leaves the Chromium process running.
**Signature:**
```typescript
class Browser {
disconnect(): void;
}
class Browser {disconnect(): void;}
```
**Returns:**
void

7
docs/api/puppeteer.browser.isconnected.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: Browser.isConnected
---
# Browser.isConnected() method
Indicates that the browser is connected.
@ -9,11 +8,9 @@ Indicates that the browser is connected.
**Signature:**
```typescript
class Browser {
isConnected(): boolean;
}
class Browser {isConnected(): boolean;}
```
**Returns:**
boolean

37
docs/api/puppeteer.browser.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: Browser
---
# Browser class
A Browser is created when Puppeteer connects to a Chromium instance, either through [PuppeteerNode.launch()](./puppeteer.puppeteernode.launch.md) or [Puppeteer.connect()](./puppeteer.puppeteer.connect.md).
@ -11,7 +10,6 @@ A Browser is created when Puppeteer connects to a Chromium instance, either thro
```typescript
export declare class Browser extends EventEmitter
```
**Extends:** [EventEmitter](./puppeteer.eventemitter.md)
## Remarks
@ -58,20 +56,21 @@ const puppeteer = require('puppeteer');
## Methods
| Method | Modifiers | Description |
| ---------------------------------------------------------------------------------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [browserContexts()](./puppeteer.browser.browsercontexts.md) | | Returns an array of all open browser contexts. In a newly created browser, this will return a single instance of [BrowserContext](./puppeteer.browsercontext.md). |
| [close()](./puppeteer.browser.close.md) | | 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. |
| [createIncognitoBrowserContext(options)](./puppeteer.browser.createincognitobrowsercontext.md) | | Creates a new incognito browser context. This won't share cookies/cache with other browser contexts. |
| [defaultBrowserContext()](./puppeteer.browser.defaultbrowsercontext.md) | | Returns the default browser context. The default browser context cannot be closed. |
| [disconnect()](./puppeteer.browser.disconnect.md) | | Disconnects Puppeteer from the browser, but leaves the Chromium process running. After calling <code>disconnect</code>, the [Browser](./puppeteer.browser.md) object is considered disposed and cannot be used anymore. |
| [isConnected()](./puppeteer.browser.isconnected.md) | | Indicates that the browser is connected. |
| [newPage()](./puppeteer.browser.newpage.md) | | Promise which resolves to a new [Page](./puppeteer.page.md) object. The Page is created in a default browser context. |
| [pages()](./puppeteer.browser.pages.md) | | An array of all open pages inside the Browser. |
| [process()](./puppeteer.browser.process.md) | | The spawned browser process. Returns <code>null</code> if the browser instance was created with [Puppeteer.connect()](./puppeteer.puppeteer.connect.md). |
| [target()](./puppeteer.browser.target.md) | | The target associated with the browser. |
| [targets()](./puppeteer.browser.targets.md) | | All active targets inside the Browser. In case of multiple browser contexts, returns an array with all the targets in all browser contexts. |
| [userAgent()](./puppeteer.browser.useragent.md) | | The browser's original user agent. Pages can override the browser user agent with [Page.setUserAgent()](./puppeteer.page.setuseragent.md). |
| [version()](./puppeteer.browser.version.md) | | A string representing the browser name and version. |
| [waitForTarget(predicate, options)](./puppeteer.browser.waitfortarget.md) | | Searches for a target in all browser contexts. |
| [wsEndpoint()](./puppeteer.browser.wsendpoint.md) | | The browser websocket endpoint which can be used as an argument to [Puppeteer.connect()](./puppeteer.puppeteer.connect.md). |
| Method | Modifiers | Description |
| --- | --- | --- |
| [browserContexts()](./puppeteer.browser.browsercontexts.md) | | Returns an array of all open browser contexts. In a newly created browser, this will return a single instance of [BrowserContext](./puppeteer.browsercontext.md). |
| [close()](./puppeteer.browser.close.md) | | 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. |
| [createIncognitoBrowserContext(options)](./puppeteer.browser.createincognitobrowsercontext.md) | | Creates a new incognito browser context. This won't share cookies/cache with other browser contexts. |
| [defaultBrowserContext()](./puppeteer.browser.defaultbrowsercontext.md) | | Returns the default browser context. The default browser context cannot be closed. |
| [disconnect()](./puppeteer.browser.disconnect.md) | | Disconnects Puppeteer from the browser, but leaves the Chromium process running. After calling <code>disconnect</code>, the [Browser](./puppeteer.browser.md) object is considered disposed and cannot be used anymore. |
| [isConnected()](./puppeteer.browser.isconnected.md) | | Indicates that the browser is connected. |
| [newPage()](./puppeteer.browser.newpage.md) | | Promise which resolves to a new [Page](./puppeteer.page.md) object. The Page is created in a default browser context. |
| [pages()](./puppeteer.browser.pages.md) | | An array of all open pages inside the Browser. |
| [process()](./puppeteer.browser.process.md) | | The spawned browser process. Returns <code>null</code> if the browser instance was created with [Puppeteer.connect()](./puppeteer.puppeteer.connect.md). |
| [target()](./puppeteer.browser.target.md) | | The target associated with the browser. |
| [targets()](./puppeteer.browser.targets.md) | | All active targets inside the Browser. In case of multiple browser contexts, returns an array with all the targets in all browser contexts. |
| [userAgent()](./puppeteer.browser.useragent.md) | | The browser's original user agent. Pages can override the browser user agent with [Page.setUserAgent()](./puppeteer.page.setuseragent.md). |
| [version()](./puppeteer.browser.version.md) | | A string representing the browser name and version. |
| [waitForTarget(predicate, options)](./puppeteer.browser.waitfortarget.md) | | Searches for a target in all browser contexts. |
| [wsEndpoint()](./puppeteer.browser.wsendpoint.md) | | The browser websocket endpoint which can be used as an argument to [Puppeteer.connect()](./puppeteer.puppeteer.connect.md). |

7
docs/api/puppeteer.browser.newpage.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: Browser.newPage
---
# Browser.newPage() method
Promise which resolves to a new [Page](./puppeteer.page.md) object. The Page is created in a default browser context.
@ -9,11 +8,9 @@ Promise which resolves to a new [Page](./puppeteer.page.md) object. The Page is
**Signature:**
```typescript
class Browser {
newPage(): Promise<Page>;
}
class Browser {newPage(): Promise<Page>;}
```
**Returns:**
Promise&lt;[Page](./puppeteer.page.md)&gt;

7
docs/api/puppeteer.browser.pages.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: Browser.pages
---
# Browser.pages() method
An array of all open pages inside the Browser.
@ -9,11 +8,8 @@ An array of all open pages inside the Browser.
**Signature:**
```typescript
class Browser {
pages(): Promise<Page[]>;
}
class Browser {pages(): Promise<Page[]>;}
```
**Returns:**
Promise&lt;[Page](./puppeteer.page.md)\[\]&gt;
@ -21,3 +17,4 @@ Promise&lt;[Page](./puppeteer.page.md)\[\]&gt;
## Remarks
In case of multiple browser contexts, returns an array with all the pages in all browser contexts. Non-visible pages, such as `"background_page"`, will not be listed here. You can find them using [Target.page()](./puppeteer.target.page.md).

7
docs/api/puppeteer.browser.process.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: Browser.process
---
# Browser.process() method
The spawned browser process. Returns `null` if the browser instance was created with [Puppeteer.connect()](./puppeteer.puppeteer.connect.md).
@ -9,11 +8,9 @@ The spawned browser process. Returns `null` if the browser instance was created
**Signature:**
```typescript
class Browser {
process(): ChildProcess | null;
}
class Browser {process(): ChildProcess | null;}
```
**Returns:**
ChildProcess \| null

7
docs/api/puppeteer.browser.target.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: Browser.target
---
# Browser.target() method
The target associated with the browser.
@ -9,11 +8,9 @@ The target associated with the browser.
**Signature:**
```typescript
class Browser {
target(): Target;
}
class Browser {target(): Target;}
```
**Returns:**
[Target](./puppeteer.target.md)

7
docs/api/puppeteer.browser.targets.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: Browser.targets
---
# Browser.targets() method
All active targets inside the Browser. In case of multiple browser contexts, returns an array with all the targets in all browser contexts.
@ -9,11 +8,9 @@ All active targets inside the Browser. In case of multiple browser contexts, ret
**Signature:**
```typescript
class Browser {
targets(): Target[];
}
class Browser {targets(): Target[];}
```
**Returns:**
[Target](./puppeteer.target.md)\[\]

7
docs/api/puppeteer.browser.useragent.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: Browser.userAgent
---
# Browser.userAgent() method
The browser's original user agent. Pages can override the browser user agent with [Page.setUserAgent()](./puppeteer.page.setuseragent.md).
@ -9,11 +8,9 @@ The browser's original user agent. Pages can override the browser user agent wit
**Signature:**
```typescript
class Browser {
userAgent(): Promise<string>;
}
class Browser {userAgent(): Promise<string>;}
```
**Returns:**
Promise&lt;string&gt;

7
docs/api/puppeteer.browser.version.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: Browser.version
---
# Browser.version() method
A string representing the browser name and version.
@ -9,11 +8,8 @@ A string representing the browser name and version.
**Signature:**
```typescript
class Browser {
version(): Promise<string>;
}
class Browser {version(): Promise<string>;}
```
**Returns:**
Promise&lt;string&gt;
@ -23,3 +19,4 @@ Promise&lt;string&gt;
For headless Chromium, this is similar to `HeadlessChrome/61.0.3153.0`. For non-headless, this is similar to `Chrome/61.0.3153.0`.
The format of browser.version() might change with future releases of Chromium.

21
docs/api/puppeteer.browser.waitfortarget.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: Browser.waitForTarget
---
# Browser.waitForTarget() method
Searches for a target in all browser contexts.
@ -9,20 +8,15 @@ Searches for a target in all browser contexts.
**Signature:**
```typescript
class Browser {
waitForTarget(
predicate: (x: Target) => boolean | Promise<boolean>,
options?: WaitForTargetOptions
): Promise<Target>;
}
class Browser {waitForTarget(predicate: (x: Target) => boolean | Promise<boolean>, options?: WaitForTargetOptions): Promise<Target>;}
```
## Parameters
| Parameter | Type | Description |
| --------- | ---------------------------------------------------------------------------- | -------------------------------------- |
| predicate | (x: [Target](./puppeteer.target.md)) =&gt; boolean \| Promise&lt;boolean&gt; | A function to be run for every target. |
| options | [WaitForTargetOptions](./puppeteer.waitfortargetoptions.md) | <i>(Optional)</i> |
| Parameter | Type | Description |
| --- | --- | --- |
| predicate | (x: [Target](./puppeteer.target.md)) =&gt; boolean \| Promise&lt;boolean&gt; | A function to be run for every target. |
| options | [WaitForTargetOptions](./puppeteer.waitfortargetoptions.md) | <i>(Optional)</i> |
**Returns:**
@ -36,7 +30,6 @@ An example of finding a target for a page opened via `window.open`:
```ts
await page.evaluate(() => window.open('https://www.example.com/'));
const newWindowTarget = await browser.waitForTarget(
target => target.url() === 'https://www.example.com/'
);
const newWindowTarget = await browser.waitForTarget(target => target.url() === 'https://www.example.com/');
```

7
docs/api/puppeteer.browser.wsendpoint.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: Browser.wsEndpoint
---
# Browser.wsEndpoint() method
The browser websocket endpoint which can be used as an argument to [Puppeteer.connect()](./puppeteer.puppeteer.connect.md).
@ -9,11 +8,8 @@ The browser websocket endpoint which can be used as an argument to [Puppeteer.co
**Signature:**
```typescript
class Browser {
wsEndpoint(): string;
}
class Browser {wsEndpoint(): string;}
```
**Returns:**
string
@ -25,3 +21,4 @@ The Browser websocket url.
The format is `ws://${host}:${port}/devtools/browser/<id>`.
You can find the `webSocketDebuggerUrl` from `http://${host}:${port}/json/version`. Learn more about the [devtools protocol](https://chromedevtools.github.io/devtools-protocol) and the [browser endpoint](https://chromedevtools.github.io/devtools-protocol/#how-do-i-access-the-browser-target).

5
docs/api/puppeteer.browserconnectoptions.defaultviewport.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: BrowserConnectOptions.defaultViewport
---
# BrowserConnectOptions.defaultViewport property
Sets the viewport for each page.
@ -9,7 +8,5 @@ Sets the viewport for each page.
**Signature:**
```typescript
interface BrowserConnectOptions {
defaultViewport?: Viewport | null;
}
interface BrowserConnectOptions {defaultViewport?: Viewport | null;}
```

5
docs/api/puppeteer.browserconnectoptions.ignorehttpserrors.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: BrowserConnectOptions.ignoreHTTPSErrors
---
# BrowserConnectOptions.ignoreHTTPSErrors property
Whether to ignore HTTPS errors during navigation.
@ -9,7 +8,5 @@ Whether to ignore HTTPS errors during navigation.
**Signature:**
```typescript
interface BrowserConnectOptions {
ignoreHTTPSErrors?: boolean;
}
interface BrowserConnectOptions {ignoreHTTPSErrors?: boolean;}
```

14
docs/api/puppeteer.browserconnectoptions.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: BrowserConnectOptions
---
# BrowserConnectOptions interface
Generic browser options that can be passed when launching any browser or when connecting to an existing browser instance.
@ -14,9 +13,10 @@ export interface BrowserConnectOptions
## Properties
| Property | Modifiers | Type | Description |
| ---------------------------------------------------------------------------- | --------- | ----------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| [defaultViewport?](./puppeteer.browserconnectoptions.defaultviewport.md) | | [Viewport](./puppeteer.viewport.md) \| null | <i>(Optional)</i> Sets the viewport for each page. |
| [ignoreHTTPSErrors?](./puppeteer.browserconnectoptions.ignorehttpserrors.md) | | boolean | <i>(Optional)</i> Whether to ignore HTTPS errors during navigation. |
| [slowMo?](./puppeteer.browserconnectoptions.slowmo.md) | | number | <i>(Optional)</i> Slows down Puppeteer operations by the specified amount of milliseconds to aid debugging. |
| [targetFilter?](./puppeteer.browserconnectoptions.targetfilter.md) | | [TargetFilterCallback](./puppeteer.targetfiltercallback.md) | <i>(Optional)</i> Callback to decide if Puppeteer should connect to a given target or not. |
| Property | Modifiers | Type | Description |
| --- | --- | --- | --- |
| [defaultViewport?](./puppeteer.browserconnectoptions.defaultviewport.md) | | [Viewport](./puppeteer.viewport.md) \| null | <i>(Optional)</i> Sets the viewport for each page. |
| [ignoreHTTPSErrors?](./puppeteer.browserconnectoptions.ignorehttpserrors.md) | | boolean | <i>(Optional)</i> Whether to ignore HTTPS errors during navigation. |
| [slowMo?](./puppeteer.browserconnectoptions.slowmo.md) | | number | <i>(Optional)</i> Slows down Puppeteer operations by the specified amount of milliseconds to aid debugging. |
| [targetFilter?](./puppeteer.browserconnectoptions.targetfilter.md) | | [TargetFilterCallback](./puppeteer.targetfiltercallback.md) | <i>(Optional)</i> Callback to decide if Puppeteer should connect to a given target or not. |

5
docs/api/puppeteer.browserconnectoptions.slowmo.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: BrowserConnectOptions.slowMo
---
# BrowserConnectOptions.slowMo property
Slows down Puppeteer operations by the specified amount of milliseconds to aid debugging.
@ -9,7 +8,5 @@ Slows down Puppeteer operations by the specified amount of milliseconds to aid d
**Signature:**
```typescript
interface BrowserConnectOptions {
slowMo?: number;
}
interface BrowserConnectOptions {slowMo?: number;}
```

5
docs/api/puppeteer.browserconnectoptions.targetfilter.md
View File

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

7
docs/api/puppeteer.browsercontext.browser.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: BrowserContext.browser
---
# BrowserContext.browser() method
The browser this browser context belongs to.
@ -9,11 +8,9 @@ The browser this browser context belongs to.
**Signature:**
```typescript
class BrowserContext {
browser(): Browser;
}
class BrowserContext {browser(): Browser;}
```
**Returns:**
[Browser](./puppeteer.browser.md)

8
docs/api/puppeteer.browsercontext.clearpermissionoverrides.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: BrowserContext.clearPermissionOverrides
---
# BrowserContext.clearPermissionOverrides() method
Clears all permission overrides for the browser context.
@ -9,20 +8,19 @@ Clears all permission overrides for the browser context.
**Signature:**
```typescript
class BrowserContext {
clearPermissionOverrides(): Promise<void>;
}
class BrowserContext {clearPermissionOverrides(): Promise<void>;}
```
**Returns:**
Promise&lt;void&gt;
## Example
```ts
const context = browser.defaultBrowserContext();
context.overridePermissions('https://example.com', ['clipboard-read']);
// do stuff ..
context.clearPermissionOverrides();
```

7
docs/api/puppeteer.browsercontext.close.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: BrowserContext.close
---
# BrowserContext.close() method
Closes the browser context. All the targets that belong to the browser context will be closed.
@ -9,11 +8,8 @@ Closes the browser context. All the targets that belong to the browser context w
**Signature:**
```typescript
class BrowserContext {
close(): Promise<void>;
}
class BrowserContext {close(): Promise<void>;}
```
**Returns:**
Promise&lt;void&gt;
@ -21,3 +17,4 @@ Promise&lt;void&gt;
## Remarks
Only incognito browser contexts can be closed.

7
docs/api/puppeteer.browsercontext.isincognito.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: BrowserContext.isIncognito
---
# BrowserContext.isIncognito() method
Returns whether BrowserContext is incognito. The default browser context is the only non-incognito browser context.
@ -9,11 +8,8 @@ Returns whether BrowserContext is incognito. The default browser context is the
**Signature:**
```typescript
class BrowserContext {
isIncognito(): boolean;
}
class BrowserContext {isIncognito(): boolean;}
```
**Returns:**
boolean
@ -21,3 +17,4 @@ boolean
## Remarks
The default browser context cannot be closed.

26
docs/api/puppeteer.browsercontext.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: BrowserContext
---
# BrowserContext class
BrowserContexts provide a way to operate multiple independent browser sessions. When a browser is launched, it has a single BrowserContext used by default. The method [Browser.newPage](./puppeteer.browser.newpage.md) creates a page in the default browser context.
@ -11,7 +10,6 @@ BrowserContexts provide a way to operate multiple independent browser sessions.
```typescript
export declare class BrowserContext extends EventEmitter
```
**Extends:** [EventEmitter](./puppeteer.eventemitter.md)
## Remarks
@ -26,6 +24,7 @@ The constructor for this class is marked as internal. Third-party code should no
## Example
```ts
// Create a new incognito browser context
const context = await browser.createIncognitoBrowserContext();
@ -39,14 +38,15 @@ await context.close();
## Methods
| Method | Modifiers | Description |
| --------------------------------------------------------------------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------- |
| [browser()](./puppeteer.browsercontext.browser.md) | | The browser this browser context belongs to. |
| [clearPermissionOverrides()](./puppeteer.browsercontext.clearpermissionoverrides.md) | | Clears all permission overrides for the browser context. |
| [close()](./puppeteer.browsercontext.close.md) | | Closes the browser context. All the targets that belong to the browser context will be closed. |
| [isIncognito()](./puppeteer.browsercontext.isincognito.md) | | Returns whether BrowserContext is incognito. The default browser context is the only non-incognito browser context. |
| [newPage()](./puppeteer.browsercontext.newpage.md) | | Creates a new page in the browser context. |
| [overridePermissions(origin, permissions)](./puppeteer.browsercontext.overridepermissions.md) | | |
| [pages()](./puppeteer.browsercontext.pages.md) | | An array of all pages inside the browser context. |
| [targets()](./puppeteer.browsercontext.targets.md) | | An array of all active targets inside the browser context. |
| [waitForTarget(predicate, options)](./puppeteer.browsercontext.waitfortarget.md) | | This searches for a target in this specific browser context. |
| Method | Modifiers | Description |
| --- | --- | --- |
| [browser()](./puppeteer.browsercontext.browser.md) | | The browser this browser context belongs to. |
| [clearPermissionOverrides()](./puppeteer.browsercontext.clearpermissionoverrides.md) | | Clears all permission overrides for the browser context. |
| [close()](./puppeteer.browsercontext.close.md) | | Closes the browser context. All the targets that belong to the browser context will be closed. |
| [isIncognito()](./puppeteer.browsercontext.isincognito.md) | | Returns whether BrowserContext is incognito. The default browser context is the only non-incognito browser context. |
| [newPage()](./puppeteer.browsercontext.newpage.md) | | Creates a new page in the browser context. |
| [overridePermissions(origin, permissions)](./puppeteer.browsercontext.overridepermissions.md) | | |
| [pages()](./puppeteer.browsercontext.pages.md) | | An array of all pages inside the browser context. |
| [targets()](./puppeteer.browsercontext.targets.md) | | An array of all active targets inside the browser context. |
| [waitForTarget(predicate, options)](./puppeteer.browsercontext.waitfortarget.md) | | This searches for a target in this specific browser context. |

7
docs/api/puppeteer.browsercontext.newpage.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: BrowserContext.newPage
---
# BrowserContext.newPage() method
Creates a new page in the browser context.
@ -9,11 +8,9 @@ Creates a new page in the browser context.
**Signature:**
```typescript
class BrowserContext {
newPage(): Promise<Page>;
}
class BrowserContext {newPage(): Promise<Page>;}
```
**Returns:**
Promise&lt;[Page](./puppeteer.page.md)&gt;

15
docs/api/puppeteer.browsercontext.overridepermissions.md
View File

@ -1,23 +1,20 @@
---
sidebar_label: BrowserContext.overridePermissions
---
# BrowserContext.overridePermissions() method
**Signature:**
```typescript
class BrowserContext {
overridePermissions(origin: string, permissions: Permission[]): Promise<void>;
}
class BrowserContext {overridePermissions(origin: string, permissions: Permission[]): Promise<void>;}
```
## Parameters
| Parameter | Type | Description |
| ----------- | ------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| origin | string | The origin to grant permissions to, e.g. "https://example.com". |
| permissions | [Permission](./puppeteer.permission.md)\[\] | An array of permissions to grant. All permissions that are not listed here will be automatically denied. |
| Parameter | Type | Description |
| --- | --- | --- |
| origin | string | The origin to grant permissions to, e.g. "https://example.com". |
| permissions | [Permission](./puppeteer.permission.md)\[\] | An array of permissions to grant. All permissions that are not listed here will be automatically denied. |
**Returns:**
@ -25,7 +22,9 @@ Promise&lt;void&gt;
## Example
```ts
const context = browser.defaultBrowserContext();
await context.overridePermissions('https://html5demos.com', ['geolocation']);
```

7
docs/api/puppeteer.browsercontext.pages.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: BrowserContext.pages
---
# BrowserContext.pages() method
An array of all pages inside the browser context.
@ -9,13 +8,11 @@ An array of all pages inside the browser context.
**Signature:**
```typescript
class BrowserContext {
pages(): Promise<Page[]>;
}
class BrowserContext {pages(): Promise<Page[]>;}
```
**Returns:**
Promise&lt;[Page](./puppeteer.page.md)\[\]&gt;
Promise which resolves to an array of all open pages. Non visible pages, such as `"background_page"`, will not be listed here. You can find them using [the target page](./puppeteer.target.page.md).

7
docs/api/puppeteer.browsercontext.targets.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: BrowserContext.targets
---
# BrowserContext.targets() method
An array of all active targets inside the browser context.
@ -9,11 +8,9 @@ An array of all active targets inside the browser context.
**Signature:**
```typescript
class BrowserContext {
targets(): Target[];
}
class BrowserContext {targets(): Target[];}
```
**Returns:**
[Target](./puppeteer.target.md)\[\]

25
docs/api/puppeteer.browsercontext.waitfortarget.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: BrowserContext.waitForTarget
---
# BrowserContext.waitForTarget() method
This searches for a target in this specific browser context.
@ -9,22 +8,17 @@ This searches for a target in this specific browser context.
**Signature:**
```typescript
class BrowserContext {
waitForTarget(
predicate: (x: Target) => boolean | Promise<boolean>,
options?: {
timeout?: number;
}
): Promise<Target>;
}
class BrowserContext {waitForTarget(predicate: (x: Target) => boolean | Promise<boolean>, options?: {
timeout?: number;
}): Promise<Target>;}
```
## Parameters
| Parameter | Type | Description |
| --------- | ---------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| predicate | (x: [Target](./puppeteer.target.md)) =&gt; boolean \| Promise&lt;boolean&gt; | A function to be run for every target |
| options | { timeout?: number; } | <i>(Optional)</i> An object of options. Accepts a timout, which is the maximum wait time in milliseconds. Pass <code>0</code> to disable the timeout. Defaults to 30 seconds. |
| Parameter | Type | Description |
| --- | --- | --- |
| predicate | (x: [Target](./puppeteer.target.md)) =&gt; boolean \| Promise&lt;boolean&gt; | A function to be run for every target |
| options | { timeout?: number; } | <i>(Optional)</i> An object of options. Accepts a timout, which is the maximum wait time in milliseconds. Pass <code>0</code> to disable the timeout. Defaults to 30 seconds. |
**Returns:**
@ -38,7 +32,6 @@ An example of finding a target for a page opened via `window.open`:
```ts
await page.evaluate(() => window.open('https://www.example.com/'));
const newWindowTarget = await browserContext.waitForTarget(
target => target.url() === 'https://www.example.com/'
);
const newWindowTarget = await browserContext.waitForTarget(target => target.url() === 'https://www.example.com/');
```

13
docs/api/puppeteer.browsercontextemittedevents.md
View File

@ -1,9 +1,9 @@
---
sidebar_label: BrowserContextEmittedEvents
---
# BrowserContextEmittedEvents enum
**Signature:**
```typescript
@ -12,8 +12,9 @@ export declare const enum BrowserContextEmittedEvents
## Enumeration Members
| Member | Value | Description |
| --------------- | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| TargetChanged | <code>&quot;targetchanged&quot;</code> | Emitted when the url of a target inside the browser context changes. Contains a [Target](./puppeteer.target.md) instance. |
| TargetCreated | <code>&quot;targetcreated&quot;</code> | <p>Emitted when a target is created within the browser context, for example when a new page is opened by [window.open](https://developer.mozilla.org/en-US/docs/Web/API/Window/open) or by [browserContext.newPage](./puppeteer.browsercontext.newpage.md)</p><p>Contains a [Target](./puppeteer.target.md) instance.</p> |
| TargetDestroyed | <code>&quot;targetdestroyed&quot;</code> | Emitted when a target is destroyed within the browser context, for example when a page is closed. Contains a [Target](./puppeteer.target.md) instance. |
| Member | Value | Description |
| --- | --- | --- |
| TargetChanged | <code>&quot;targetchanged&quot;</code> | Emitted when the url of a target inside the browser context changes. Contains a [Target](./puppeteer.target.md) instance. |
| TargetCreated | <code>&quot;targetcreated&quot;</code> | <p>Emitted when a target is created within the browser context, for example when a new page is opened by [window.open](https://developer.mozilla.org/en-US/docs/Web/API/Window/open) or by [browserContext.newPage](./puppeteer.browsercontext.newpage.md)</p><p>Contains a [Target](./puppeteer.target.md) instance.</p> |
| TargetDestroyed | <code>&quot;targetdestroyed&quot;</code> | Emitted when a target is destroyed within the browser context, for example when a page is closed. Contains a [Target](./puppeteer.target.md) instance. |

10
docs/api/puppeteer.browsercontextoptions.md
View File

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

5
docs/api/puppeteer.browsercontextoptions.proxybypasslist.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: BrowserContextOptions.proxyBypassList
---
# BrowserContextOptions.proxyBypassList property
Bypass the proxy for the given semi-colon-separated list of hosts.
@ -9,7 +8,5 @@ Bypass the proxy for the given semi-colon-separated list of hosts.
**Signature:**
```typescript
interface BrowserContextOptions {
proxyBypassList?: string[];
}
interface BrowserContextOptions {proxyBypassList?: string[];}
```

5
docs/api/puppeteer.browsercontextoptions.proxyserver.md
View File

@ -1,7 +1,6 @@
---
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`.
@ -9,7 +8,5 @@ Proxy server with optional port to use for all requests. Username and password c
**Signature:**
```typescript
interface BrowserContextOptions {
proxyServer?: string;
}
interface BrowserContextOptions {proxyServer?: string;}
```

14
docs/api/puppeteer.browseremittedevents.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: BrowserEmittedEvents
---
# BrowserEmittedEvents enum
All the events a [browser instance](./puppeteer.browser.md) may emit.
@ -14,9 +13,10 @@ export declare const enum BrowserEmittedEvents
## Enumeration Members
| Member | Value | Description |
| --------------- | ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Disconnected | <code>&quot;disconnected&quot;</code> | <p>Emitted when Puppeteer gets disconnected from the Chromium instance. This might happen because of one of the following:</p><p>- Chromium is closed or crashed</p><p>- The [browser.disconnect](./puppeteer.browser.disconnect.md) method was called.</p> |
| TargetChanged | <code>&quot;targetchanged&quot;</code> | Emitted when the url of a target changes. Contains a [Target](./puppeteer.target.md) instance. |
| TargetCreated | <code>&quot;targetcreated&quot;</code> | <p>Emitted when a target is created, for example when a new page is opened by [window.open](https://developer.mozilla.org/en-US/docs/Web/API/Window/open) or by [browser.newPage](./puppeteer.browser.newpage.md)</p><p>Contains a [Target](./puppeteer.target.md) instance.</p> |
| TargetDestroyed | <code>&quot;targetdestroyed&quot;</code> | Emitted when a target is destroyed, for example when a page is closed. Contains a [Target](./puppeteer.target.md) instance. |
| Member | Value | Description |
| --- | --- | --- |
| Disconnected | <code>&quot;disconnected&quot;</code> | <p>Emitted when Puppeteer gets disconnected from the Chromium instance. This might happen because of one of the following:</p><p>- Chromium is closed or crashed</p><p>- The [browser.disconnect](./puppeteer.browser.disconnect.md) method was called.</p> |
| TargetChanged | <code>&quot;targetchanged&quot;</code> | Emitted when the url of a target changes. Contains a [Target](./puppeteer.target.md) instance. |
| TargetCreated | <code>&quot;targetcreated&quot;</code> | <p>Emitted when a target is created, for example when a new page is opened by [window.open](https://developer.mozilla.org/en-US/docs/Web/API/Window/open) or by [browser.newPage](./puppeteer.browser.newpage.md)</p><p>Contains a [Target](./puppeteer.target.md) instance.</p> |
| TargetDestroyed | <code>&quot;targetdestroyed&quot;</code> | Emitted when a target is destroyed, for example when a page is closed. Contains a [Target](./puppeteer.target.md) instance. |

12
docs/api/puppeteer.browserfetcher.candownload.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: BrowserFetcher.canDownload
---
# BrowserFetcher.canDownload() method
Initiates a HEAD request to check if the revision is available.
@ -9,16 +8,14 @@ Initiates a HEAD request to check if the revision is available.
**Signature:**
```typescript
class BrowserFetcher {
canDownload(revision: string): Promise<boolean>;
}
class BrowserFetcher {canDownload(revision: string): Promise<boolean>;}
```
## Parameters
| Parameter | Type | Description |
| --------- | ------ | --------------------------------------- |
| revision | string | The revision to check availability for. |
| Parameter | Type | Description |
| --- | --- | --- |
| revision | string | The revision to check availability for. |
**Returns:**
@ -29,3 +26,4 @@ A promise that resolves to `true` if the revision could be downloaded from the h
## Remarks
This method is affected by the current `product`.

17
docs/api/puppeteer.browserfetcher.download.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: BrowserFetcher.download
---
# BrowserFetcher.download() method
Initiates a GET request to download the revision from the host.
@ -9,20 +8,15 @@ Initiates a GET request to download the revision from the host.
**Signature:**
```typescript
class BrowserFetcher {
download(
revision: string,
progressCallback?: (x: number, y: number) => void
): Promise<BrowserFetcherRevisionInfo | undefined>;
}
class BrowserFetcher {download(revision: string, progressCallback?: (x: number, y: number) => void): Promise<BrowserFetcherRevisionInfo | undefined>;}
```
## Parameters
| Parameter | Type | Description |
| ---------------- | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| revision | string | The revision to download. |
| progressCallback | (x: number, y: number) =&gt; void | <i>(Optional)</i> A function that will be called with two arguments: How many bytes have been downloaded and the total number of bytes of the download. |
| Parameter | Type | Description |
| --- | --- | --- |
| revision | string | The revision to download. |
| progressCallback | (x: number, y: number) =&gt; void | <i>(Optional)</i> A function that will be called with two arguments: How many bytes have been downloaded and the total number of bytes of the download. |
**Returns:**
@ -33,3 +27,4 @@ A promise with revision information when the revision is downloaded and extracte
## Remarks
This method is affected by the current `product`.

7
docs/api/puppeteer.browserfetcher.host.md
View File

@ -1,19 +1,16 @@
---
sidebar_label: BrowserFetcher.host
---
# BrowserFetcher.host() method
**Signature:**
```typescript
class BrowserFetcher {
host(): string;
}
class BrowserFetcher {host(): string;}
```
**Returns:**
string
The download host being used.

7
docs/api/puppeteer.browserfetcher.localrevisions.md
View File

@ -1,17 +1,13 @@
---
sidebar_label: BrowserFetcher.localRevisions
---
# BrowserFetcher.localRevisions() method
**Signature:**
```typescript
class BrowserFetcher {
localRevisions(): Promise<string[]>;
}
class BrowserFetcher {localRevisions(): Promise<string[]>;}
```
**Returns:**
Promise&lt;string\[\]&gt;
@ -21,3 +17,4 @@ A promise with a list of all revision strings (for the current `product`) availa
## Remarks
This method is affected by the current `product`.

27
docs/api/puppeteer.browserfetcher.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: BrowserFetcher
---
# BrowserFetcher class
BrowserFetcher can download and manage different versions of Chromium and Firefox.
@ -25,22 +24,20 @@ An example of using BrowserFetcher to download a specific version of Chromium an
```ts
const browserFetcher = puppeteer.createBrowserFetcher();
const revisionInfo = await browserFetcher.download('533271');
const browser = await puppeteer.launch({
executablePath: revisionInfo.executablePath,
});
const browser = await puppeteer.launch({executablePath: revisionInfo.executablePath})
```
\*\*NOTE\*\* BrowserFetcher is not designed to work concurrently with other instances of BrowserFetcher that share the same downloads directory.
## Methods
| Method | Modifiers | Description |
| ------------------------------------------------------------------------------ | --------- | --------------------------------------------------------------- |
| [canDownload(revision)](./puppeteer.browserfetcher.candownload.md) | | Initiates a HEAD request to check if the revision is available. |
| [download(revision, progressCallback)](./puppeteer.browserfetcher.download.md) | | Initiates a GET request to download the revision from the host. |
| [host()](./puppeteer.browserfetcher.host.md) | | |
| [localRevisions()](./puppeteer.browserfetcher.localrevisions.md) | | |
| [platform()](./puppeteer.browserfetcher.platform.md) | | |
| [product()](./puppeteer.browserfetcher.product.md) | | |
| [remove(revision)](./puppeteer.browserfetcher.remove.md) | | |
| [revisionInfo(revision)](./puppeteer.browserfetcher.revisioninfo.md) | | |
| Method | Modifiers | Description |
| --- | --- | --- |
| [canDownload(revision)](./puppeteer.browserfetcher.candownload.md) | | Initiates a HEAD request to check if the revision is available. |
| [download(revision, progressCallback)](./puppeteer.browserfetcher.download.md) | | Initiates a GET request to download the revision from the host. |
| [host()](./puppeteer.browserfetcher.host.md) | | |
| [localRevisions()](./puppeteer.browserfetcher.localrevisions.md) | | |
| [platform()](./puppeteer.browserfetcher.platform.md) | | |
| [product()](./puppeteer.browserfetcher.product.md) | | |
| [remove(revision)](./puppeteer.browserfetcher.remove.md) | | |
| [revisionInfo(revision)](./puppeteer.browserfetcher.revisioninfo.md) | | |

7
docs/api/puppeteer.browserfetcher.platform.md
View File

@ -1,19 +1,16 @@
---
sidebar_label: BrowserFetcher.platform
---
# BrowserFetcher.platform() method
**Signature:**
```typescript
class BrowserFetcher {
platform(): Platform;
}
class BrowserFetcher {platform(): Platform;}
```
**Returns:**
[Platform](./puppeteer.platform.md)
Returns the current `Platform`, which is one of `mac`, `linux`, `win32` or `win64`.

7
docs/api/puppeteer.browserfetcher.product.md
View File

@ -1,19 +1,16 @@
---
sidebar_label: BrowserFetcher.product
---
# BrowserFetcher.product() method
**Signature:**
```typescript
class BrowserFetcher {
product(): Product;
}
class BrowserFetcher {product(): Product;}
```
**Returns:**
[Product](./puppeteer.product.md)
Returns the current `Product`, which is one of `chrome` or `firefox`.

12
docs/api/puppeteer.browserfetcher.remove.md
View File

@ -1,22 +1,19 @@
---
sidebar_label: BrowserFetcher.remove
---
# BrowserFetcher.remove() method
**Signature:**
```typescript
class BrowserFetcher {
remove(revision: string): Promise<void>;
}
class BrowserFetcher {remove(revision: string): Promise<void>;}
```
## Parameters
| Parameter | Type | Description |
| --------- | ------ | ---------------------------------------------------------- |
| revision | string | A revision to remove for the current <code>product</code>. |
| Parameter | Type | Description |
| --- | --- | --- |
| revision | string | A revision to remove for the current <code>product</code>. |
**Returns:**
@ -27,3 +24,4 @@ A promise that resolves when the revision has been removes or throws if the revi
## Remarks
This method is affected by the current `product`.

12
docs/api/puppeteer.browserfetcher.revisioninfo.md
View File

@ -1,25 +1,23 @@
---
sidebar_label: BrowserFetcher.revisionInfo
---
# BrowserFetcher.revisionInfo() method
**Signature:**
```typescript
class BrowserFetcher {
revisionInfo(revision: string): BrowserFetcherRevisionInfo;
}
class BrowserFetcher {revisionInfo(revision: string): BrowserFetcherRevisionInfo;}
```
## Parameters
| Parameter | Type | Description |
| --------- | ------ | ----------------------------- |
| revision | string | The revision to get info for. |
| Parameter | Type | Description |
| --- | --- | --- |
| revision | string | The revision to get info for. |
**Returns:**
[BrowserFetcherRevisionInfo](./puppeteer.browserfetcherrevisioninfo.md)
The revision info for the given revision.

5
docs/api/puppeteer.browserfetcheroptions.host.md
View File

@ -1,13 +1,10 @@
---
sidebar_label: BrowserFetcherOptions.host
---
# BrowserFetcherOptions.host property
**Signature:**
```typescript
interface BrowserFetcherOptions {
host?: string;
}
interface BrowserFetcherOptions {host?: string;}
```

15
docs/api/puppeteer.browserfetcheroptions.md
View File

@ -1,9 +1,9 @@
---
sidebar_label: BrowserFetcherOptions
---
# BrowserFetcherOptions interface
**Signature:**
```typescript
@ -12,9 +12,10 @@ export interface BrowserFetcherOptions
## Properties
| Property | Modifiers | Type | Description |
| ---------------------------------------------------------- | --------- | ----------------------------------- | ----------------- |
| [host?](./puppeteer.browserfetcheroptions.host.md) | | string | <i>(Optional)</i> |
| [path?](./puppeteer.browserfetcheroptions.path.md) | | string | <i>(Optional)</i> |
| [platform?](./puppeteer.browserfetcheroptions.platform.md) | | [Platform](./puppeteer.platform.md) | <i>(Optional)</i> |
| [product?](./puppeteer.browserfetcheroptions.product.md) | | string | <i>(Optional)</i> |
| Property | Modifiers | Type | Description |
| --- | --- | --- | --- |
| [host?](./puppeteer.browserfetcheroptions.host.md) | | string | <i>(Optional)</i> |
| [path?](./puppeteer.browserfetcheroptions.path.md) | | string | <i>(Optional)</i> |
| [platform?](./puppeteer.browserfetcheroptions.platform.md) | | [Platform](./puppeteer.platform.md) | <i>(Optional)</i> |
| [product?](./puppeteer.browserfetcheroptions.product.md) | | string | <i>(Optional)</i> |

5
docs/api/puppeteer.browserfetcheroptions.path.md
View File

@ -1,13 +1,10 @@
---
sidebar_label: BrowserFetcherOptions.path
---
# BrowserFetcherOptions.path property
**Signature:**
```typescript
interface BrowserFetcherOptions {
path?: string;
}
interface BrowserFetcherOptions {path?: string;}
```

5
docs/api/puppeteer.browserfetcheroptions.platform.md
View File

@ -1,13 +1,10 @@
---
sidebar_label: BrowserFetcherOptions.platform
---
# BrowserFetcherOptions.platform property
**Signature:**
```typescript
interface BrowserFetcherOptions {
platform?: Platform;
}
interface BrowserFetcherOptions {platform?: Platform;}
```

5
docs/api/puppeteer.browserfetcheroptions.product.md
View File

@ -1,13 +1,10 @@
---
sidebar_label: BrowserFetcherOptions.product
---
# BrowserFetcherOptions.product property
**Signature:**
```typescript
interface BrowserFetcherOptions {
product?: string;
}
interface BrowserFetcherOptions {product?: string;}
```

5
docs/api/puppeteer.browserfetcherrevisioninfo.executablepath.md
View File

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

5
docs/api/puppeteer.browserfetcherrevisioninfo.folderpath.md
View File

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

5
docs/api/puppeteer.browserfetcherrevisioninfo.local.md
View File

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

19
docs/api/puppeteer.browserfetcherrevisioninfo.md
View File

@ -1,9 +1,9 @@
---
sidebar_label: BrowserFetcherRevisionInfo
---
# BrowserFetcherRevisionInfo interface
**Signature:**
```typescript
@ -12,11 +12,12 @@ export interface BrowserFetcherRevisionInfo
## Properties
| Property | Modifiers | Type | Description |
| -------------------------------------------------------------------------- | --------- | ------- | ----------- |
| [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 | |
| Property | Modifiers | Type | Description |
| --- | --- | --- | --- |
| [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 | |

5
docs/api/puppeteer.browserfetcherrevisioninfo.product.md
View File

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

5
docs/api/puppeteer.browserfetcherrevisioninfo.revision.md
View File

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

5
docs/api/puppeteer.browserfetcherrevisioninfo.url.md
View File

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

5
docs/api/puppeteer.browserlaunchargumentoptions.args.md
View File

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

5
docs/api/puppeteer.browserlaunchargumentoptions.debuggingport.md
View File

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

5
docs/api/puppeteer.browserlaunchargumentoptions.devtools.md
View File

@ -1,7 +1,6 @@
---
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`.
@ -9,7 +8,5 @@ Whether to auto-open a DevTools panel for each tab. If this is set to `true`, th
**Signature:**
```typescript
interface BrowserLaunchArgumentOptions {
devtools?: boolean;
}
interface BrowserLaunchArgumentOptions {devtools?: boolean;}
```

5
docs/api/puppeteer.browserlaunchargumentoptions.headless.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: BrowserLaunchArgumentOptions.headless
---
# BrowserLaunchArgumentOptions.headless property
Whether to run the browser in headless mode.
@ -9,7 +8,5 @@ Whether to run the browser in headless mode.
**Signature:**
```typescript
interface BrowserLaunchArgumentOptions {
headless?: boolean | 'chrome';
}
interface BrowserLaunchArgumentOptions {headless?: boolean | 'chrome';}
```

16
docs/api/puppeteer.browserlaunchargumentoptions.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: BrowserLaunchArgumentOptions
---
# BrowserLaunchArgumentOptions interface
Launcher options that only apply to Chrome.
@ -14,10 +13,11 @@ export interface BrowserLaunchArgumentOptions
## Properties
| Property | Modifiers | Type | Description |
| --------------------------------------------------------------------------- | --------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [args?](./puppeteer.browserlaunchargumentoptions.args.md) | | string\[\] | <i>(Optional)</i> Additional command line arguments to pass to the browser instance. |
| [debuggingPort?](./puppeteer.browserlaunchargumentoptions.debuggingport.md) | | number | <i>(Optional)</i> |
| [devtools?](./puppeteer.browserlaunchargumentoptions.devtools.md) | | boolean | <i>(Optional)</i> 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>. |
| [headless?](./puppeteer.browserlaunchargumentoptions.headless.md) | | boolean \| 'chrome' | <i>(Optional)</i> Whether to run the browser in headless mode. |
| [userDataDir?](./puppeteer.browserlaunchargumentoptions.userdatadir.md) | | string | <i>(Optional)</i> 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. |
| Property | Modifiers | Type | Description |
| --- | --- | --- | --- |
| [args?](./puppeteer.browserlaunchargumentoptions.args.md) | | string\[\] | <i>(Optional)</i> Additional command line arguments to pass to the browser instance. |
| [debuggingPort?](./puppeteer.browserlaunchargumentoptions.debuggingport.md) | | number | <i>(Optional)</i> |
| [devtools?](./puppeteer.browserlaunchargumentoptions.devtools.md) | | boolean | <i>(Optional)</i> 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>. |
| [headless?](./puppeteer.browserlaunchargumentoptions.headless.md) | | boolean \| 'chrome' | <i>(Optional)</i> Whether to run the browser in headless mode. |
| [userDataDir?](./puppeteer.browserlaunchargumentoptions.userdatadir.md) | | string | <i>(Optional)</i> 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. |

5
docs/api/puppeteer.browserlaunchargumentoptions.userdatadir.md
View File

@ -1,7 +1,6 @@
---
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.
@ -9,7 +8,5 @@ Path to a user data directory. [see the Chromium docs](https://chromium.googleso
**Signature:**
```typescript
interface BrowserLaunchArgumentOptions {
userDataDir?: string;
}
interface BrowserLaunchArgumentOptions {userDataDir?: string;}
```

7
docs/api/puppeteer.cdpsession.connection.md
View File

@ -1,17 +1,14 @@
---
sidebar_label: CDPSession.connection
---
# CDPSession.connection() method
**Signature:**
```typescript
class CDPSession {
connection(): Connection | undefined;
}
class CDPSession {connection(): Connection | undefined;}
```
**Returns:**
[Connection](./puppeteer.connection.md) \| undefined

7
docs/api/puppeteer.cdpsession.detach.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: CDPSession.detach
---
# CDPSession.detach() method
Detaches the cdpSession from the target. Once detached, the cdpSession object won't emit any events and can't be used to send messages.
@ -9,11 +8,9 @@ Detaches the cdpSession from the target. Once detached, the cdpSession object wo
**Signature:**
```typescript
class CDPSession {
detach(): Promise<void>;
}
class CDPSession {detach(): Promise<void>;}
```
**Returns:**
Promise&lt;void&gt;

7
docs/api/puppeteer.cdpsession.id.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: CDPSession.id
---
# CDPSession.id() method
Returns the session's id.
@ -9,11 +8,9 @@ Returns the session's id.
**Signature:**
```typescript
class CDPSession {
id(): string;
}
class CDPSession {id(): string;}
```
**Returns:**
string

22
docs/api/puppeteer.cdpsession.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: CDPSession
---
# CDPSession class
The `CDPSession` instances are used to talk raw Chrome Devtools Protocol.
@ -11,7 +10,6 @@ The `CDPSession` instances are used to talk raw Chrome Devtools Protocol.
```typescript
export declare class CDPSession extends EventEmitter
```
**Extends:** [EventEmitter](./puppeteer.eventemitter.md)
## Remarks
@ -24,24 +22,24 @@ The constructor for this class is marked as internal. Third-party code should no
## Example
```ts
const client = await page.target().createCDPSession();
await client.send('Animation.enable');
client.on('Animation.animationCreated', () =>
console.log('Animation created!')
);
client.on('Animation.animationCreated', () => console.log('Animation created!'));
const response = await client.send('Animation.getPlaybackRate');
console.log('playback rate is ' + response.playbackRate);
await client.send('Animation.setPlaybackRate', {
playbackRate: response.playbackRate / 2,
playbackRate: response.playbackRate / 2
});
```
## Methods
| Method | Modifiers | Description |
| --------------------------------------------------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| [connection()](./puppeteer.cdpsession.connection.md) | | |
| [detach()](./puppeteer.cdpsession.detach.md) | | Detaches the cdpSession from the target. Once detached, the cdpSession object won't emit any events and can't be used to send messages. |
| [id()](./puppeteer.cdpsession.id.md) | | Returns the session's id. |
| [send(method, paramArgs)](./puppeteer.cdpsession.send.md) | | |
| Method | Modifiers | Description |
| --- | --- | --- |
| [connection()](./puppeteer.cdpsession.connection.md) | | |
| [detach()](./puppeteer.cdpsession.detach.md) | | Detaches the cdpSession from the target. Once detached, the cdpSession object won't emit any events and can't be used to send messages. |
| [id()](./puppeteer.cdpsession.id.md) | | Returns the session's id. |
| [send(method, paramArgs)](./puppeteer.cdpsession.send.md) | | |

17
docs/api/puppeteer.cdpsession.send.md
View File

@ -1,27 +1,22 @@
---
sidebar_label: CDPSession.send
---
# CDPSession.send() method
**Signature:**
```typescript
class CDPSession {
send<T extends keyof ProtocolMapping.Commands>(
method: T,
...paramArgs: ProtocolMapping.Commands[T]['paramsType']
): Promise<ProtocolMapping.Commands[T]['returnType']>;
}
class CDPSession {send<T extends keyof ProtocolMapping.Commands>(method: T, ...paramArgs: ProtocolMapping.Commands[T]['paramsType']): Promise<ProtocolMapping.Commands[T]['returnType']>;}
```
## Parameters
| Parameter | Type | Description |
| --------- | --------------------------------------------- | ----------- |
| method | T | |
| paramArgs | ProtocolMapping.Commands\[T\]\['paramsType'\] | |
| Parameter | Type | Description |
| --- | --- | --- |
| method | T | |
| paramArgs | ProtocolMapping.Commands\[T\]\['paramsType'\] | |
**Returns:**
Promise&lt;ProtocolMapping.Commands\[T\]\['returnType'\]&gt;

13
docs/api/puppeteer.cdpsessiononmessageobject.error.md
View File

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

5
docs/api/puppeteer.cdpsessiononmessageobject.id.md
View File

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

17
docs/api/puppeteer.cdpsessiononmessageobject.md
View File

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

5
docs/api/puppeteer.cdpsessiononmessageobject.method.md
View File

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

5
docs/api/puppeteer.cdpsessiononmessageobject.params.md
View File

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

5
docs/api/puppeteer.cdpsessiononmessageobject.result.md
View File

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

8
docs/api/puppeteer.chromereleasechannel.md
View File

@ -1,15 +1,11 @@
---
sidebar_label: ChromeReleaseChannel
---
# ChromeReleaseChannel type
**Signature:**
```typescript
export declare type ChromeReleaseChannel =
| 'chrome'
| 'chrome-beta'
| 'chrome-canary'
| 'chrome-dev';
export declare type ChromeReleaseChannel = 'chrome' | 'chrome-beta' | 'chrome-canary' | 'chrome-dev';
```

3
docs/api/puppeteer.clearcustomqueryhandlers.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: clearCustomQueryHandlers
---
# clearCustomQueryHandlers() function
Clears all registered handlers.
@ -11,7 +10,7 @@ Clears all registered handlers.
```typescript
export declare function clearCustomQueryHandlers(): void;
```
**Returns:**
void

5
docs/api/puppeteer.clickoptions.button.md
View File

@ -1,13 +1,10 @@
---
sidebar_label: ClickOptions.button
---
# ClickOptions.button property
**Signature:**
```typescript
interface ClickOptions {
button?: MouseButton;
}
interface ClickOptions {button?: MouseButton;}
```

5
docs/api/puppeteer.clickoptions.clickcount.md
View File

@ -1,13 +1,10 @@
---
sidebar_label: ClickOptions.clickCount
---
# ClickOptions.clickCount property
**Signature:**
```typescript
interface ClickOptions {
clickCount?: number;
}
interface ClickOptions {clickCount?: number;}
```

5
docs/api/puppeteer.clickoptions.delay.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: ClickOptions.delay
---
# ClickOptions.delay property
Time to wait between `mousedown` and `mouseup` in milliseconds.
@ -9,7 +8,5 @@ Time to wait between `mousedown` and `mouseup` in milliseconds.
**Signature:**
```typescript
interface ClickOptions {
delay?: number;
}
interface ClickOptions {delay?: number;}
```

15
docs/api/puppeteer.clickoptions.md
View File

@ -1,9 +1,9 @@
---
sidebar_label: ClickOptions
---
# ClickOptions interface
**Signature:**
```typescript
@ -12,9 +12,10 @@ export interface ClickOptions
## Properties
| Property | Modifiers | Type | Description |
| ----------------------------------------------------- | --------- | ----------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| [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. |
| Property | Modifiers | Type | Description |
| --- | --- | --- | --- |
| [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. |

5
docs/api/puppeteer.clickoptions.offset.md
View File

@ -1,7 +1,6 @@
---
sidebar_label: ClickOptions.offset
---
# ClickOptions.offset property
Offset for the clickable point relative to the top-left corder of the border box.
@ -9,7 +8,5 @@ Offset for the clickable point relative to the top-left corder of the border box
**Signature:**
```typescript
interface ClickOptions {
offset?: Offset;
}
interface ClickOptions {offset?: Offset;}
```

14
docs/api/puppeteer.commoneventemitter.addlistener.md
View File

@ -1,24 +1,22 @@
---
sidebar_label: CommonEventEmitter.addListener
---
# CommonEventEmitter.addListener() method
**Signature:**
```typescript
interface CommonEventEmitter {
addListener(event: EventType, handler: Handler): CommonEventEmitter;
}
interface CommonEventEmitter {addListener(event: EventType, handler: Handler): CommonEventEmitter;}
```
## Parameters
| Parameter | Type | Description |
| --------- | ------------------------------------- | ----------- |
| event | [EventType](./puppeteer.eventtype.md) | |
| handler | [Handler](./puppeteer.handler.md) | |
| Parameter | Type | Description |
| --- | --- | --- |
| event | [EventType](./puppeteer.eventtype.md) | |
| handler | [Handler](./puppeteer.handler.md) | |
**Returns:**
[CommonEventEmitter](./puppeteer.commoneventemitter.md)

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