快速开始

如果你用过其他浏览器测试框架，会觉得 Puppeteer 很眼熟。你先 launch（启动）/connect（连接） 一个 browser（浏览器），再 create（创建） 一些 page（页面），然后用 Puppeteer 的 API 操作它们。

下面的例子在 developer.chrome.com 上搜索包含 “automate beyond recorder” 的博客文章，点击第一个结果，并打印这篇博客的完整标题。

import puppeteer from 'puppeteer';
// 或者：import puppeteer from 'puppeteer-core';

// 启动浏览器并打开一个空白新页面。
const browser = await puppeteer.launch();
const page = await browser.newPage();

// 导航到指定 URL。
await page.goto('https://developer.chrome.com/');

// 设置屏幕尺寸。
await page.setViewport({width: 1080, height: 1024});

// 用键盘打开搜索菜单。
await page.keyboard.press('/');

// 通过无障碍输入名在搜索框中输入内容。
await page.locator('::-p-aria(Search)').fill('automate beyond recorder');

// 等待并点击第一个结果。
await page.locator('.devsite-result-item-link').click();

// 用唯一字符串定位完整标题。
const textSelector = await page
  .locator('::-p-text(Customize and automate)')
  .waitHandle();
const fullTitle = await textSelector?.evaluate(el => el.textContent);

// 打印完整标题。
console.log('The title of this blog post is "%s".', fullTitle);

await browser.close();

想了解更深入的用法，请查阅 文档 与 示例。