📄 README.md

← 返回目录

Puppeteer

![build](https://github.com/puppeteer/puppeteer/actions/workflows/ci.yml) ![npm puppeteer package](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 or WebDriver BiDi.
Puppeteer runs in the headless (no visible UI) by default

Get started | API | FAQ | Contributing | Troubleshooting

Installation

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


MCP

Install chrome-devtools-mcp, a Puppeteer-based MCP server for browser automation and debugging.

Puppeteer also supports the experimental WebMCP API.

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 the screen size. await page.setViewport({width: 1080, height: 1024});

// Open the search menu using the keyboard. await page.keyboard.press('/');

// Type into search box using accessible input name. await page.locator('::-p-aria(Search)').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('::-p-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(); ``