puppeteer开发者工具

replay

用于重放、自定义执行及转译 Chrome DevTools Recorder 用户流程录制的 Node.js 库与 CLI 工具。

  • CLI
  • 库/框架
  • Linux
  • macOS
  • Windows
  • 支持本地运行
replay 截图
社区热度
1.4k Stars
GitHub 收藏
最近活跃
2026/9/20
近 30 天还在更新
授权协议
APACHE-2.0
宽松协议

为什么值得关注

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

近 90 天

解决的问题

解决了将浏览器录制的用户流程转换为可执行代码和自动化测试时的格式转换与重放问题。

实际价值

提供了直接运行 Chrome DevTools 录制文件的 Node.js 库与命令行工具,并支持转换为多种测试框架脚本。

创新 / 差异化

通过扩展机制允许开发者自定义每一步的执行逻辑和代码转译格式,生态连接较为开放。

扩展潜力

可作为多种主流测试框架扩展 Chrome 录制功能的基础层,被 Cypress、Nightwatch 和 WebdriverIO 等项目采用。

为什么是现在

随着浏览器内置录制工具的普及,对应的自动化测试生态工具链正在逐步完善。

社区活跃度

近 90 天新增 8 个 Issue、19 个 PR;窗口内抽取的 Issue/PR 样本中有 7 位 Issue 发起者、6 位 PR 贡献者,并发布 至少 0 个版本。

维护者响应

窗口内 8 个 Issue 样本关闭率 100%,17 个 PR 样本合并率 47%。维护者评论样本仅覆盖该 Issue 样本的 100%,不足以可靠判断首次响应率与响应速度。

PR 样本 6 位贡献者至少 0 次 ReleasePR 合并率 47% · 17 条窗口样本

核心亮点

  • 直接通过 CLI 或 JavaScript API 执行 DevTools 录制文件及批量文件夹
  • 支持继承 PuppeteerRunnerExtension 自定义步骤执行前后的钩子行为与截图逻辑
  • 支持通过 PuppeteerStringifyExtension 将录制流程转译为 Puppeteer 或第三方测试脚本

快速开始

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

装在哪

本地运行

难不难

容易,照着走就行

支持本地运行
  1. 01在项目中安装核心库及 Puppeteer 依赖:npm install @puppeteer/replay puppeteer --save
  2. 02从 Chrome DevTools Recorder 面板录制并导出 JSON 格式的用户流程文件(如 recording.json)。
  3. 03使用 CLI 快速重放录制:npx @puppeteer/replay recording.json
  4. 04在 Node.js 中通过 createRunner 和 parse 编程式加载并执行录制流程。

更适合谁

  • 想在本机直接跑起来试用的开发者

更多介绍

@puppeteer/replay 是 Google Chrome 团队维护的工具库,用于连接 Chrome DevTools Recorder 面板录制的用户交互流程(User Flows)与自动化执行环境。

该工具提供了命令行工具(CLI)与 Node.js 编程式 API,开发者可以直接运行录制好的 JSON 文件,设置无头或有头模式,或者在每个操作步骤前后插入自定义拦截逻辑。

除了直接重放,项目还提供了代码转译能力,允许开发者自定义将录制数据转换为 Cypress、Nightwatch、WebdriverIO 等测试框架的测试脚本,或作为构建 Chrome DevTools 扩展的底层库。

信息来源

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

11 条 · 展开
  • capability tags

    已核验

    来源: admin_cms · cms editor · 2026/8/15

  • 最新版本

    已核验

    v4.0.2

    来源: GitHub 官方接口 · latest_release=v4.0.2 · 2026/10/3

  • 许可证

    已核验

    Apache-2.0

    来源: GitHub 官方接口 · license.spdx_id=Apache-2.0 · 2026/10/3

  • needs api key

    已核验

    否

    来源: admin_cms · cms editor · 2026/8/15

  • 一句话用途

    已核验

    {"en":"A Node.js library and CLI tool to replay, customize, and stringify Chrome DevTools Recorder user flows.","zh":"用于重放、自定义执行及转译 Chrome DevTools Recorder 用户流程录制的 Node.js 库与 CLI 工具。"}

    来源: admin_cms · cms editor · 2026/8/15

  • 平台

    已核验

    linux、macos、windows

    来源: admin_cms · cms editor · 2026/8/15

  • 分类线索

    根据材料推断

    browser-desktop

    来源: 项目说明文档 · hint=browser-desktop · 2026/8/15

  • product forms

    已核验

    cli、library_framework

    来源: admin_cms · cms editor · 2026/8/15

  • role tags

    已核验

    来源: admin_cms · cms editor · 2026/8/15

  • supports local

    已核验

    是

    来源: admin_cms · cms editor · 2026/8/15

  • supports self host

    已核验

    否

    来源: admin_cms · cms editor · 2026/8/15

根据分类、能力和适用角色匹配的其他已核验项目。