@dnvgl/playwright-live-recorder

中文文档
2.0.72发布于 2025/08/14MITCommonJS近 30 天下载 3965

在运行测试时从浏览器控制台测试上下文时添加活编码. 提供可方案配置的记录器。 引入关于页面对象模型的强有力公约的想法

中文使用文档
文档目录6 节
  1. 观看视频演示
  2. 先决条件
  3. 安装
  4. 测试的打字码
  5. 浏览器
  6. 记录

Playwright live recorder infographic

开始

观看视频演示

Getting Started


先决条件

@playwright/test (类型)

首先使用 @ playwright/ test 设置重播, 如果从新重播开始 https://playwright.dev/docs/intro (英语)

安装

npm install -D @dnvgl/playwright-live-recorder
#or
yarn add -D @dnvgl/playwright-live-recorder
#or
pnpm add -D @dnvgl/playwright-live-recorder

运行设置脚本

npx @dnvgl/playwright-live-recorder

确保将 baseURL 设置到您的网络应用的根 URL playwright.config.ts 譬如说.

//playwright.config.ts
export default defineConfig({
  //...
  use: {
    baseURL: 'https://demo.playwright.dev/todomvc/#/',
    //...

如何使用

测试的打字码

在剧作家测试中, 添加导入

import { PlaywrightLiveRecorder } from '@dnvgl/playwright-live-recorder';

然后在您想要录制的剧作家测试结束时添加此等待行

// note - recorded lines will be inserted here
await PlaywrightLiveRecorder.start(page, s => <undefined>eval(s));

以标题模式运行测试

如果您正在使用 vscode 插件 ms-playwright.playwright 它将自动以标题模式运行,其中PWDEBUG设置为控制台(见修改 .vscode/settings.json(中文(简体) )
如果您正在运行命令行, 请设置环境变量 PWDEBUG=console 在运行剧作家命令之前,例如. playwright test --ui

测试会运行, 当 PlaywrightLiveRecorder.start 已执行的 lib 功能将暴露在浏览器中,所有脚本将载入浏览器中。 测试执行等待浏览器关闭.
新录入的测试行被插入到测试文件中.
将创建新添加的页面对象模型文件,将新添加的项目插入页面对象模型文件.
以上新增加或修改的试验线 PlaywrightLiveRecorder.start 在保存文件时执行.

浏览器

Playwright live recorder sticky bar
Playwright活录器在浏览器页面上方增加了一个控制栏.

  • 记录模式QQ/QQ可以通过点击图标来切换/ 打开, 或者按下 CTRL+ALT+SHIFT+R
  • 标签是页面对象模型路径+文件名
  • f(x) 按钮显示您页面对象模型文件中可用的公共帮助功能, 单击绿色 qq, 在文件中添加示例

当记录被切换在悬浮工具提示上时, 位置位于显示将生成的代码的光标旁边

如果录制器屏蔽了您的测试会话, 工作通过将记录调出, 点击, 然后重新调出

记录

正在切换记录, 请单击一个元素将其添加到测试中

  • 如果元素不是Page对象模型的一部分,则会提示您给它一个名称
    • 按下输入后,新属性将添加到页面对象模型文件,元素会突出显示(默认:鲑鱼颜色),以表示它是页面对象模型的一部分
    • 按 [esc] 跳过添加到页面对象模型
  • 如果元素是 Page 对象模型的一部分, 它将会被突出显示为沙门颜色
    • 点击它会在测试的页面对象模型方法中添加一个调用

在点击元素后, 测试代码将被添加并保存到您的测试文件中 。 文件更改会自动被重新执行.
您总是可以修改文本代码并保存以重新执行已修改的行.

这对修改一个 .click() 呼叫一个 .fill(),或包起来 expect 围绕您刚刚点击的元素。 保存文件并重新执行. 另一个强大的工作流程是编辑页面对象模型函数,保存文件,然后在测试文件中再添加同一行来强制重执行 在函数执行正确之前,您可以一直这样延时.

当测试中执行代码行时,它们会在屏幕上显示覆盖 code execute overlay

版本与发布记录

@dnvgl/playwright-live-recorder 共发布 63 个版本,首次发布于 2022/09/17;过去 12 个月发布了 0 个版本。

版本发布日期距今
2.0.72latest2025/08/141.2 年前
2.0.712025/08/141.2 年前
2.0.682025/07/191.3 年前
2.0.672025/07/191.3 年前
2.0.662025/07/191.3 年前
2.0.652025/07/121.3 年前

关于 @dnvgl/playwright-live-recorder 的常见问题

@dnvgl/playwright-live-recorder 是什么?

在运行测试时从浏览器控制台测试上下文时添加活编码. 提供可方案配置的记录器。 引入关于页面对象模型的强有力公约的想法

如何安装 @dnvgl/playwright-live-recorder?

在项目目录运行 npm install @dnvgl/playwright-live-recorder,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 playwright-live-recorder,可以用 npx playwright-live-recorder 直接运行。

@dnvgl/playwright-live-recorder 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/dnvgl__playwright-live-recorder 是否存在。

@dnvgl/playwright-live-recorder 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@dnvgl/playwright-live-recorder 可以商用吗?

@dnvgl/playwright-live-recorder 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@dnvgl/playwright-live-recorder 的下载量有多少?

根据 npm 官方下载统计,@dnvgl/playwright-live-recorder 在 2026/10/13 – 2026/11/11 这 30 天内被下载 3,965 次,日均约 132 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@dnvgl/playwright-live-recorder 还在维护吗?

最新版本 2.0.72 发布于 2025/08/14(1.2 年前);至今共发布 63 个版本,其中过去 12 个月发布了 0 个;首次发布于 2022/09/17。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。