安装
要在您的项目中使用 Puppeteer,请运行
- npm
- Yarn
- pnpm
npm i puppeteer
yarn add puppeteer
pnpm add puppeteer
当您安装 Puppeteer 时,它会自动下载最新版本的 Chrome for Testing (~170MB macOS,~282MB Linux,~280MB Windows) 和一个 chrome-headless-shell
二进制文件(从 Puppeteer v21.6.0 开始),该文件保证与 Puppeteer 一起工作。浏览器默认下载到 $HOME/.cache/puppeteer
文件夹(从 Puppeteer v19.0.0 开始)。有关控制下载行为的配置选项和环境变量,请参阅配置。
自 v1.7.0 以来的每个版本,我们都发布两个软件包
puppeteer
是一个用于浏览器自动化的产品。安装后,它会下载一个 Chrome 版本,然后使用 puppeteer-core
驱动它。作为一个最终用户产品,puppeteer
使用合理的默认值自动化了多个工作流程,这些可以自定义。
puppeteer-core
是一个库,用于帮助驱动任何支持 DevTools 协议的东西。作为一个库,puppeteer-core
完全通过其编程接口驱动,这意味着不假设任何默认值,并且安装后 puppeteer-core
不会下载 Chrome。
如果您要连接到远程浏览器或自己管理浏览器,则应使用 puppeteer-core
。 如果您自己管理浏览器,则需要使用显式的executablePath
(或如果安装在标准位置,则使用channel
)调用 puppeteer.launch
。
使用 puppeteer-core
时,请记住更改导入
import puppeteer from 'puppeteer-core';