@cyborgtests/test

中文文档
0.3.0发布于 2026/04/02MITTypeScriptESM + CJS近 30 天下载 1.5万

Playwright 的全功率扩展, 允许您在自动测试流程中包含手动校验步骤

中文使用文档
文档目录6 节
  1. 德莫语
  2. * 安装
  3. 使用量
  4. QQ 手动步骤软失败
  5. 分析配置
  6. 捐款

循环测试

Cyborg 测试是 剧作家 扩展让您在同一测试中将自动检查和人输入结合起来.

当手动步骤被击中时,会出现一个单独的窗口,显示需要执行的步骤描述,因此测试者可以将其标记为通过或失败.

Demo 2
手动步骤演示

Demo 1
测试构建器Demo

德莫语

请参看关于 Cyborg 测试如何将手动步骤转化为精简的 Playwright 测试的完整教程 :

Watch on YouTube

请参看Cyborg Test如何将手动步骤转化为精简的Playwright测试: YouTube - 介绍 Cyborg Tests - 停止部分可自动测试的摔跤!

* 安装

npm install @cyborgtests/test

此库预计 @playwright/test 可以在您的项目中作为对等依赖.

使用量

import test from '@cyborgtests/test';

// Regular Playwright test syntax with additional `manualStep` helper
// that pauses execution until the tester confirms the step.
test('example with manual step', async ({ page, manualStep }) => {
  await page.goto('https://example.com');

  await manualStep('Verify the login screen is displayed correctly');

  // continue with the rest of your automated script
});

何时 manualStep 它被称为测试暂停,而 Cyborg 测试 UI 窗口则出现。 使用 ✅ Step passed 或者说 ❌ Step failed 按钮以恢复测试。 失步会掉出一个错误 让你的线人能发现它.

QQ 手动步骤软失败

你用得着 manualStep.soft 将手动步骤标记为软故障。 如果一个软的手动步骤失败,测试会继续运行,失败会被附加说明为报告中软的失败(警告).

用法 :

await manualStep('This is a hard manual step'); // Test fails if this step fails
await manualStep.soft('This is a soft manual step'); // Test continues if this step fails, and a warning is shown
  • 软失败在UI中显示为警告,并在测试报告中附加说明.
  • 用于非关键手动校验时使用软失败, 用于您想要突出问题但不失败整个测试 .

分析配置

谷歌分析默认启用 帮助我们理解用法. 收集了下列数据:

  • 独一无二的用户ID( 第一次运行时生成)
  • 测试执行事件( 测试开始)
  • 测试结果(通过/失败)
  • 外部链接点击
  • 浏览器、 OS 信息和国家

这些数据有助于我们了解该工具是如何被使用和改进的。 我们不收集任何个人或敏感信息.

要关闭分析,请使用以下配置:

import { config } from '@cyborgtests/test';

config.setConfig({
  analyticsEnabled: false
});

捐款

我们欢迎捐款! 如果你想报告一个错误, 请求一个特性, 或者提交拉动请求, 检查我们 提供指南。 。 。 .


发现这个有用吗? 启动支持这个项目的回波!

版本与发布记录

@cyborgtests/test 共发布 9 个版本,首次发布于 2025/05/20;过去 12 个月发布了 2 个版本。

版本发布日期距今
0.3.0latest2026/04/027 个月前
0.2.32026/03/157 个月前
0.2.02025/10/221.1 年前
0.1.02025/07/301.3 年前
0.0.72025/06/121.4 年前
0.0.62025/06/101.4 年前

关于 @cyborgtests/test 的常见问题

@cyborgtests/test 是什么?

Playwright 的全功率扩展, 允许您在自动测试流程中包含手动校验步骤

如何安装 @cyborgtests/test?

在项目目录运行 npm install @cyborgtests/test,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@playwright/test(^1.54.2)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@cyborgtests/test 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@cyborgtests/test 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@cyborgtests/test 可以商用吗?

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

@cyborgtests/test 的下载量有多少?

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

@cyborgtests/test 还在维护吗?

最新版本 0.3.0 发布于 2026/04/02(7 个月前);至今共发布 9 个版本,其中过去 12 个月发布了 2 个;首次发布于 2025/05/20。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。