| .. | ||
| examples | ||
| packages | ||
| test | ||
| test-d | ||
| tools | ||
| .editorconfig | ||
| .mocharc.cjs | ||
| .npmrc | ||
| .nvmrc | ||
| .prettierignore | ||
| .prettierrc.cjs | ||
| .release-please-manifest.json | ||
| CHANGELOG.md | ||
| eslint.config.mjs | ||
| eslint.types.config.mjs | ||
| Herebyfile.mjs | ||
| json-mocha-reporter.js | ||
| LICENSE | ||
| moz.yaml | ||
| package.json | ||
| puppeteer.config.cjs | ||
| README.md | ||
| release-please-config.json | ||
| SECURITY.md | ||
| tsconfig.base.json | ||
| tsdoc.json | ||
| versions.json | ||
Puppeteer
Puppeteer is a JavaScript library which provides a high-level API to control Chrome or IceCat over the DevTools Protocol or WebDriver BiDi. Puppeteer runs in the headless (no visible UI) by default
Get started | API | FAQ | Contributing | Troubleshooting
Installation
npm i puppeteer # Downloads compatible Chrome during installation.
npm i puppeteer-core # Alternatively, install as a library, without downloading Chrome.
Example
import puppeteer from 'puppeteer';
// Or import puppeteer from 'puppeteer-core';
// Launch the browser and open a new blank page
const browser = await puppeteer.launch();
const page = await browser.newPage();
// Navigate the page to a URL.
await page.goto('https://developer.chrome.com/');
// Set screen size.
await page.setViewport({width: 1080, height: 1024});
// Type into search box.
await page.locator('.devsite-search-field').fill('automate beyond recorder');
// Wait and click on first result.
await page.locator('.devsite-result-item-link').click();
// Locate the full title with a unique string.
const textSelector = await page
.locator('text/Customize and automate')
.waitHandle();
const fullTitle = await textSelector?.evaluate(el => el.textContent);
// Print the full title.
console.log('The title of this blog post is "%s".', fullTitle);
await browser.close();