Puppeteer开源项目使用教程

Puppeteer开源项目使用教程

puppeteer 项目地址: https://gitcode.com/gh_mirrors/puppeteer1/puppeteer

1. 项目介绍

Puppeteer 是一个 Node 库，提供了一个高级 API 来通过 DevTools 协议或 WebDriver BiDi 控制 Chrome 或 Firefox。Puppeteer 默认以无头模式运行（不显示用户界面）。它允许开发者进行网页自动化操作，如生成网页截图、PDF 文件，抓取网页内容，以及模拟用户行为等。

2. 项目快速启动

首先，确保已经安装了 Node.js。然后，可以通过以下命令安装 Puppeteer：

npm i puppeteer

这将自动下载兼容版本的 Chrome。如果你希望不下载 Chrome，可以使用以下命令安装 Puppeteer 的核心库：

npm i puppeteer-core

以下是一个基本的 Puppeteer 脚本，它会启动浏览器，打开一个新页面，导航到指定 URL，并设置屏幕大小：

const puppeteer = require('puppeteer');

async function run() {
    const browser = await puppeteer.launch();
    const page = await browser.newPage();

    await page.goto('https://example.com');
    await page.setViewport({ width: 1080, height: 1024 });

    await browser.close();
}

run();

3. 应用案例和最佳实践

网页截图

await page.screenshot({ path: 'example.png' });

生成 PDF

await page.pdf({ path: 'example.pdf', format: 'A4' });

模拟用户行为

await page.type('#username', 'exampleUser');
await page.type('#password', 'examplePassword');
await page.click('button.login');

爬取网页数据

const data = await page.evaluate(() => {
    return Array.from(document.querySelectorAll('selector')).map(item => {
        return {
            title: item.innerText.trim(),
            // 其他需要的数据
        };
    });
});

4. 典型生态项目

• Puppeteer-Sharp: Puppeteer 的 .NET 移植版本，适用于 .NET 环境。
• Cypress: 一个端到端测试框架，使用 Puppeteer 作为其浏览器自动化工具。
• Selenium WebDriver: 一个用于自动化 web 应用程序测试的工具，可以通过插件使用 Puppeteer。
• TestCafe: 一个为所有现代浏览器设计的自动化测试工具，支持使用 Puppeteer 作为其测试运行器。

以上是关于 Puppeteer 的基本介绍和使用教程，希望对您有所帮助。

puppeteer 项目地址: https://gitcode.com/gh_mirrors/puppeteer1/puppeteer