puppeteer开发者工具

puppeteer

基于 DevTools Protocol 或 WebDriver BiDi 控制 Chrome 和 Firefox 的 JavaScript 自动化 Node.js 库。

前端
测试 / QA
后端
全栈
自动化
测试
库/框架
CLI
Windows
macOS
Linux
支持本地运行
支持 Docker

打开官网查看 GitHub

社区热度: 95.6k Stars; GitHub 收藏
最近活跃: 2026/10/1; 近 30 天还在更新
授权协议: APACHE-2.0; 宽松协议

为什么值得关注

不是看 Star 排名，而是看它解决了什么问题、实际有没有用，以及方法为什么值得关注。

近 90 天

解决的问题

解决了浏览器自动化测试、网页抓取及模拟用户操作的复杂性问题，提供了统一的控制接口。

实际价值

作为行业标准工具，其 API 设计成熟，广泛应用于自动化测试、性能监控及数据采集场景。

创新 / 差异化

通过直接对接 DevTools Protocol 和 WebDriver BiDi，实现了对浏览器底层行为的深度控制。

扩展潜力

极大地降低了编写浏览器自动化脚本的门槛，是构建各类网页交互工具的核心依赖。

为什么是现在

在现代 Web 开发中，自动化测试与数据采集需求持续增长，该工具依然是该领域的主流选择。

社区活跃度

近 90 天新增 32 个 Issue、269 个 PR；窗口内抽取的 Issue/PR 样本中有 25 位 Issue 发起者、22 位 PR 贡献者，并发布至少 23 个版本。

维护者响应

窗口内 31 个 Issue 样本关闭率 77%，100 个 PR 样本合并率 77%。维护者响应统计覆盖该 Issue 样本的 45%，响应率 14%，首次响应中位数 0.1 小时。

PR 样本 22 位贡献者至少 23 次 ReleaseIssue 响应率 14% · 样本 14（覆盖 45%）首次响应中位数 0.1hPR 合并率 77% · 100 条窗口样本

核心亮点

支持以无头（Headless）或有头（Headful）模式程序化控制 Chrome 和 Firefox
支持 DevTools Protocol 与 WebDriver BiDi 协议交互
提供轻量级 puppeteer-core 选项，不强行打包下载浏览器二进制文件

快速开始

安装方式、上手难度、开始步骤。

装在哪

本地运行

难不难

容易，照着走就行

支持 Docker支持本地运行

01使用 npm 安装 puppeteer 主程序包（安装过程中会自动下载兼容的 Chrome 浏览器版本）：npm i puppeteer
02若安装脚本被包管理器拦截，可手动下载所需浏览器：npx puppeteer browsers install
03在 Node.js 代码中导入 puppeteer 并启动浏览器实例与打开新页面
04使用 goto() 跳转网页，并使用 locator() 绑定 DOM 元素执行点击或文本填入动作
05完成自动化流程后调用 browser.close() 关闭浏览器实例

更适合谁

想在本机直接跑起来试用的开发者
习惯用 Docker 部署的人

更多介绍

Puppeteer 是一个 JavaScript 库，主要提供通过 DevTools Protocol 或 WebDriver BiDi 协议控制 Chrome 和 Firefox 的高级 API。默认情况下，Puppeteer 以无 UI 的无头模式（Headless）运行，但也可配置为有头模式进行可视化调试。

在实际研发与自动化工作流中，开发者可以借助 Puppeteer 完成页面导航、视图大小设置、键盘与鼠标输入模拟、DOM 元素查找以及页面内容提取。除标准安装外，项目还提供了 puppeteer-core 包，方便直接控制已有的本地或远程浏览器实例。项目同时也集成了 MCP（Model Context Protocol）生态以扩展自动化与调试能力。

信息来源

每条信息都标注了状态与出处，可展开查看。

12 条 · 展开

capability tags
已核验
automation、testing
来源： admin_cms · cms editor · 2026/8/17
最新版本
已核验
browsers-v3.2.3
来源： GitHub 官方接口 · latest_release=browsers-v3.2.3 · 2026/10/1
许可证
已核验
Apache-2.0
来源： GitHub 官方接口 · license.spdx_id=Apache-2.0 · 2026/10/1
needs api key
已核验
否
来源： admin_cms · cms editor · 2026/8/14
一句话用途
已核验
{"en":"A JavaScript library that provides a high-level API to control Chrome or Firefox over DevTools Protocol or WebDriver BiDi.","zh":"基于 DevTools Protocol 或 WebDriver BiDi 控制 Chrome 和 Firefox 的 JavaScript 自动化 Node.js 库。"}
来源： admin_cms · cms editor · 2026/8/14
平台
已核验
windows、macos、linux
来源： admin_cms · cms editor · 2026/8/14
分类线索
根据材料推断
automation
来源：项目说明文档 · hint=automation · 2026/8/14
product forms
已核验
library_framework、cli
来源： admin_cms · cms editor · 2026/8/17
role tags
已核验
frontend、qa、backend、fullstack
来源： admin_cms · cms editor · 2026/8/17
supports docker
已核验
是
来源：仓库文件 · dockerfile=true; compose=false · 2026/10/1
supports local
已核验
是
来源： admin_cms · cms editor · 2026/8/14
supports self host
已核验
否
来源： admin_cms · cms editor · 2026/8/14