# @cyborgtests/test 中文文档

规范地址：https://npmcn.com/package/%40cyborgtests/test/

版本：0\.3\.0
npm 元数据更新时间：2026-04-02T08:43:46.708Z
中文译文更新时间：2026-11-11T06:54:39.861Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40cyborgtests/test
原文对照：https://npmcn.com/package/%40cyborgtests/test/?lang=original
项目主页：https://github.com/CyborgTests/cyborg-test#readme
源码仓库：https://github.com/CyborgTests/cyborg-test

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：2 MB，61 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：@playwright/test ^1\.54\.2
- 首次发布：2025-05-20T07:49:00.524Z
- 最新版本发布：2026-04-02T08:43:46.553Z
- 近 30 天下载量：15471（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：9（近 12 个月 2 个）

## 中文简介

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

## 安装

```sh
npm install @cyborgtests/test
```

也可以使用：`pnpm add @cyborgtests/test`、`yarn add @cyborgtests/test`、`bun add @cyborgtests/test`

## README

# 循环测试

Cyborg 测试是 [剧作家](https://playwright.dev/) 扩展让您在同一测试中将自动检查和人输入结合起来.

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

![Demo 2](https://cdn.prod.website-files.com/67f5380f43dbd686532cd541/68b95361afb2e204e3e29301_manualStep_small.gif)

手动步骤演示

  
![Demo 1](https://cdn.prod.website-files.com/67f5380f43dbd686532cd541/68874aebb6babee061d07ad2_testBuilder.gif)

测试构建器Demo

## 德莫语

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

[![Watch on YouTube](https://npmcn.com/package/%40cyborgtests/test/readme-assets/keenethics-video-preview.png)](https://www.youtube.com/watch?v=QLSjvs11Oyw)

请参看Cyborg Test如何将手动步骤转化为精简的Playwright测试: [YouTube - 介绍 Cyborg Tests - 停止部分可自动测试的摔跤!](https://www.youtube.com/watch?v=jO-N1Fcofog&ab_channel=HOTtesting)

## \* 安装

```bash
npm install @cyborgtests/test
```

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

## 使用量

```ts
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` 将手动步骤标记为软故障。 如果一个软的手动步骤失败,测试会继续运行,失败会被附加说明为报告中软的失败(警告).

**用法 :**

```ts
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 信息和国家

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

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

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

config.setConfig({
  analyticsEnabled: false
});
```

## 捐款

我们欢迎捐款! 如果你想报告一个错误, 请求一个特性, 或者提交拉动请求, 检查我们 [提供指南](https://npmcn.com/package/%40cyborgtests/test/CONTRIBUTING.md)。 。 。 .

* * *

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

## 常见问题

### @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 和提交记录判断。