https://github.com/GoogleChrome/puppeteer
JavaScript API for Chrome and Firefox
https://github.com/GoogleChrome/puppeteer
automation chrome chromium developer-tools firefox headless-chrome node-module testing web
Last synced: 21 days ago
JSON representation
JavaScript API for Chrome and Firefox
- Host: GitHub
- URL: https://github.com/GoogleChrome/puppeteer
- Owner: puppeteer
- License: apache-2.0
- Created: 2017-05-09T22:16:13.000Z (almost 8 years ago)
- Default Branch: main
- Last Pushed: 2025-03-24T09:48:27.000Z (21 days ago)
- Last Synced: 2025-03-24T13:39:21.583Z (21 days ago)
- Topics: automation, chrome, chromium, developer-tools, firefox, headless-chrome, node-module, testing, web
- Language: TypeScript
- Homepage: https://pptr.dev
- Size: 1010 MB
- Stars: 90,130
- Watchers: 1,190
- Forks: 9,166
- Open Issues: 266
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: docs/contributing.md
- License: LICENSE
- Security: SECURITY.md
- Support: docs/supported-browsers.md
Awesome Lists containing this project
- awesome-puppeteer - Offical site
- awesome-node - Puppeteer - Headless Chrome. (Packages / Testing)
- awesome-fe - **puppeteer**
- awesome - puppeteer - Headless Chrome Node.js API (JavaScript)
- awesome-star-libs - GoogleChrome / puppeteer
- awesome-f2e-libs - **puppeteer**
- awesome-puppeteer-zh - GitHub - 官方GitHub存储库. (官方 / 贡献)
- awesome-docs - Puppeteer
- awesome-nodejs-cn - Puppeteer - 无界面Chrome. (目录 / 测试相关)
- awesome-javascript - puppeteer - Headless Chrome Node.js API by official Google Chrome team. (Testing Frameworks / Runner)
- awesome-regression-testing - Puppeteer - Headless Google Chrome Node API. (Tools and frameworks)
- awesome-browser-automation - Puppeteer - High level API in Node.js to control Chrome. (Tools)
- awesome-nodejs-cn - Puppeteer - 无头 Chrome (包 / 测试)
- awesome-regression-testing - Puppeteer - Headless Google Chrome Node API. (Tools and frameworks (a-z↓))
- awesome-puppeteer - GitHub - Official GitHub repository. (Official)
- awesome-web-browsers - Pupeteer
README
# Puppeteer
[](https://github.com/puppeteer/puppeteer/actions/workflows/ci.yml)
[](https://npmjs.org/package/puppeteer)
> Puppeteer is a JavaScript library which provides a high-level API to control
> Chrome or Firefox over the
> [DevTools Protocol](https://chromedevtools.github.io/devtools-protocol/) or [WebDriver BiDi](https://pptr.dev/webdriver-bidi).
> Puppeteer runs in the headless (no visible UI) by default
## [Get started](https://pptr.dev/docs) | [API](https://pptr.dev/api) | [FAQ](https://pptr.dev/faq) | [Contributing](https://pptr.dev/contributing) | [Troubleshooting](https://pptr.dev/troubleshooting)
## Installation
```bash npm2yarn
npm i puppeteer # Downloads compatible Chrome during installation.
npm i puppeteer-core # Alternatively, install as a library, without downloading Chrome.
```
## Example
```ts
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();
```