Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 5,218 Commits
.devcontainer		.devcontainer
.github		.github
.vscode		.vscode
docker		docker
docs		docs
examples		examples
packages		packages
test-d		test-d
test		test
tools		tools
website		website
.editorconfig		.editorconfig
.gitattributes		.gitattributes
.gitignore		.gitignore
.mocharc.cjs		.mocharc.cjs
.npmrc		.npmrc
.nvmrc		.nvmrc
.prettierignore		.prettierignore
.prettierrc.cjs		.prettierrc.cjs
.release-please-manifest.json		.release-please-manifest.json
Herebyfile.mjs		Herebyfile.mjs
LICENSE		LICENSE
README.md		README.md
SECURITY.md		SECURITY.md
eslint.config.mjs		eslint.config.mjs
eslint.types.config.mjs		eslint.types.config.mjs
package-lock.json		package-lock.json
package.json		package.json
puppeteer.config.cjs		puppeteer.config.cjs
release-please-config.json		release-please-config.json
tsconfig.base.json		tsconfig.base.json
tsdoc.json		tsdoc.json
versions.json		versions.json

Repository files navigation

Puppeteer

Puppeteer is a JavaScript library which provides a high-level API to controlChrome or Firefox over theDevTools Protocol orWebDriver 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

importpuppeteerfrom'puppeteer';// Or import puppeteer from 'puppeteer-core';// Launch the browser and open a new blank pageconstbrowser=awaitpuppeteer.launch();constpage=awaitbrowser.newPage();// Navigate the page to a URL.awaitpage.goto('https://developer.chrome.com/');// Set screen size.awaitpage.setViewport({width:1080,height:1024});// Type into search box.awaitpage.locator('.devsite-search-field').fill('automate beyond recorder');// Wait and click on first result.awaitpage.locator('.devsite-result-item-link').click();// Locate the full title with a unique string.consttextSelector=awaitpage.locator('text/Customize and automate').waitHandle();constfullTitle=awaittextSelector?.evaluate(el=>el.textContent);// Print the full title.console.log('The title of this blog post is "%s".',fullTitle);awaitbrowser.close();