e655bb6ca2
The `Puppeteer` class had two concerns: * connect to an existing browser * launch a new browser The first of those concerns is needed in all environments, but the second is only needed in Node. https://github.com/puppeteer/puppeteer/pull/6484 landing enabled us to pull the `Puppeteer` class apart into two: 1. `Puppeteer` which hosts the behaviour for connecting to existing browsers. 2. `PuppeteerNode`, which extends `Puppeteer` and also adds the ability to launch a new browser. This is a non-breaking change, because Node users will still get an instance of a class with all the methods they expect, but it'll be a `PuppeteerNode` rather than `Puppeteer`. I don't expect this to cause people any issues. We also now have new files that are effectively the entry points for Puppeteer: * `node.ts`: the main entry point for Puppeteer on Node. * `web.ts`: the main entry point for Puppeteer on the web. * `node-puppeteer-core.ts`: for those using puppeteer-core (which only exists in Node, not on the web).
2.3 KiB
2.3 KiB
Puppeteer class
The main Puppeteer class.
IMPORTANT: if you are using Puppeteer in a Node environment, you will get an instance of PuppeteerNode when you import or require puppeteer
. That class extends Puppeteer
, so has all the methods documented below as well as all that are defined on PuppeteerNode.
Signature:
export declare class Puppeteer
Remarks
The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the Puppeteer
class.
Properties
Property | Modifiers | Type | Description |
---|---|---|---|
_changedProduct | boolean | ||
_isPuppeteerCore | boolean | ||
devices | DevicesMap | ||
errors | PuppeteerErrors |
Methods
Method | Modifiers | Description |
---|---|---|
__experimental_clearQueryHandlers() | Clears all registered handlers. | |
__experimental_customQueryHandlerNames() | ||
__experimental_registerCustomQueryHandler(name, queryHandler) | Registers a custom query handler. After registration, the handler can be used everywhere where a selector is expected by prepending the selection string with <name>/ . The name is only allowed to consist of lower- and upper case latin letters. |
|
__experimental_unregisterCustomQueryHandler(name) | ||
connect(options) | This method attaches Puppeteer to an existing browser instance. |