- 社区热度
- 1.4k Stars
- GitHub 收藏
- 最近活跃
- 2026/9/20
- 近 30 天还在更新
- 授权协议
- APACHE-2.0
- 宽松协议
为什么值得关注
不是看 Star 排名,而是看它解决了什么问题、实际有没有用,以及方法为什么值得关注。
解决的问题
解决了将浏览器录制的用户流程转换为可执行代码和自动化测试时的格式转换与重放问题。
实际价值
提供了直接运行 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%,不足以可靠判断首次响应率与响应速度。
核心亮点
- 直接通过 CLI 或 JavaScript API 执行 DevTools 录制文件及批量文件夹
- 支持继承 PuppeteerRunnerExtension 自定义步骤执行前后的钩子行为与截图逻辑
- 支持通过 PuppeteerStringifyExtension 将录制流程转译为 Puppeteer 或第三方测试脚本
快速开始
安装方式、上手难度、开始步骤。
装在哪
本地运行
难不难
容易,照着走就行
- 01在项目中安装核心库及 Puppeteer 依赖:
npm install @puppeteer/replay puppeteer --save - 02从 Chrome DevTools Recorder 面板录制并导出 JSON 格式的用户流程文件(如
recording.json)。 - 03使用 CLI 快速重放录制:
npx @puppeteer/replay recording.json - 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
相关项目
根据分类、能力和适用角色匹配的其他已核验项目。
claude-code
运行在终端中的 Agent 编程工具,可理解代码库、执行日常开发任务、解释代码并处理 Git 工作流。
spec-kit
一套遵循「规范驱动开发」流程的开源 CLI 工具包,配合 AI 编程 Agent 按照规范生成与执行代码。
llama.cpp
基于 C/C++ 实现的轻量级大语言模型推理引擎,支持多种硬件加速与模型量化。
codex
运行在本机的 OpenAI 编程 Agent,可通过终端使用,也提供 IDE 和桌面应用入口。
graphify
将代码库、文档和配置文件转化为可查询知识图谱的 AI 辅助工具
supabase
基于 PostgreSQL 的开源后端即服务平台,提供自动生成的 API、用户认证与实时数据订阅。

