Puppeteer

Puppeteer is a JavaScript library which provides a high-level API to control Chrome or Firefox over the DevTools Protocol or WebDriver BiDi. Puppeteer runs in the headless (no visible UI) by default

Get started | API | FAQ | Contributing | Troubleshooting

Installation

1npm i puppeteer # Downloads compatible Chrome during installation.
2npm i puppeteer-core # Alternatively, install as a library, without downloading Chrome.

Example

1import puppeteer from 'puppeteer';
2// Or import puppeteer from 'puppeteer-core';
3
4// Launch the browser and open a new blank page
5const browser = await puppeteer.launch();
6const page = await browser.newPage();
7
8// Navigate the page to a URL.
9await page.goto('https://developer.chrome.com/');
10
11// Set screen size.
12await page.setViewport({width: 1080, height: 1024});
13
14// Type into search box using accessible input name.
15await page.locator('aria/Search').fill('automate beyond recorder');
16
17// Wait and click on first result.
18await page.locator('.devsite-result-item-link').click();
19
20// Locate the full title with a unique string.
21const textSelector = await page
22  .locator('text/Customize and automate')
23  .waitHandle();
24const fullTitle = await textSelector?.evaluate(el => el.textContent);
25
26// Print the full title.
27console.log('The title of this blog post is "%s".', fullTitle);
28
29await browser.close();