3.1 KiB
3.1 KiB
Puppeteer class
The main Puppeteer class. Provides the launch method to launch a browser.
When you require or import the Puppeteer npm package you get back an instance of this class.
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.
Example
The following is a typical example of using Puppeteer to drive automation:
const puppeteer = require('puppeteer');
(async () => {
const browser = await puppeteer.launch();
const page = await browser.newPage();
await page.goto('https://www.google.com');
// other actions...
await browser.close();
})();
Once you have created a page you have access to a large API to interact with the page, navigate, or find certain elements in that page. The `page` documentation lists all the available methods.
Properties
| Property | Modifiers | Type | Description |
|---|---|---|---|
| devices | DevicesMap | ||
| errors | PuppeteerErrors | ||
| product | string | The name of the browser that is under automation ("chrome" or "firefox") |
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. | |
| createBrowserFetcher(options) | ||
| defaultArgs(options) | ||
| executablePath() | ||
| launch(options) | Launches puppeteer and launches a browser instance with given arguments and options when specified. |