# @gate-forge/pack-playwright 中文文档

规范地址：https://npmcn.com/package/%40gate-forge/pack-playwright/

版本：0\.19\.2
npm 元数据更新时间：2026-11-10T03:57:14.301Z
中文译文更新时间：2026-11-15T23:52:40.962Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40gate-forge/pack-playwright
原文对照：https://npmcn.com/package/%40gate-forge/pack-playwright/?lang=original
项目主页：https://github.com/umiddey/gateforge#readme
源码仓库：https://github.com/umiddey/gateforge

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

- 包体积（解压后）：1.7 MB，257 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：5 个
- 首次发布：2026-09-16T21:52:38.628Z
- 最新版本发布：2026-11-10T03:57:13.943Z
- 近 30 天下载量：2905（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：46（近 12 个月 46 个）

## 中文简介

Gateforge Playwright 证据包:回回证人服务,引擎侧适配器执行,可信赖的证据固定,判决记者.

## 安装

```sh
npm install @gate-forge/pack-playwright
```

也可以使用：`pnpm add @gate-forge/pack-playwright`、`yarn add @gate-forge/pack-playwright`、`bun add @gate-forge/pack-playwright`

## README

# 写有目击的旅程

有目击的旅程必须进行真正的应用行为并验证用户所依赖的结果. 通过测试申报不是证明:只有有效收据证明运行,而采用的基准可以免除先前接受的债务.

## 从完整的示例开始

`examples/overlay-proof.spec.js` (在这个包裹,所以) `node_modules/@gate-forge/pack-playwright/examples/overlay-proof.spec.js` 在您的 repo 中)是一个完整的上覆证明测试:一个小列表/创建/编辑/存档应用程序的表面描述器,即 `gateforge` 和见证者 `evidence.ui.*` 编号 : `visible.confirm` 编号 : `http.observe` 编号 : `persistence.verify` 编号 : `finalize` 顺序。 复制,更换选取者,固定调用不变.

## 保持每次旅程的隔离

-   为每个测试建立不同的记录和租户背景。 不要重复使用一个每租户单吨的测试;共享状态可以隐藏跨租户的漏出,使结果取决于测试顺序.
-   给出测试数据独有的标识符,并通过测试所检查的同一支持的应用程序路径来清理.
-   保持独立于Gateforge环境变量的设置,使发现可以在本地和CI运行中注册相同的测试.

## 观察不挂的突变结果

-   仅在应用程序返回一个时读取突变响应机构. 通话 `.json()` 在有意的空回复上等待到永远; 坚持状态,然后通过应用程序的正常读取路径查询结果状态.
-   在同一记录中检查提交值和持续值。 HTTP 状态成功或点击不能证明更新已经发生 .
-   优于固定睡眠和瞬态加载文本的特定响应或明显应用条件.

## 更喜欢真正的行为 而不是嘲笑

-   当行程声称有面向用户的行为时使用真实的服务器和持久性路径. A 类 `page.route()` stub可以证明客户端处理,但不能显示服务器存储了正确的值或强制租户边界.
-   保持模拟试验,但不要将其作为实际应用表面的证据.
-   当多个行程覆盖同一义务时,说明为什么需要每个行程;避免使用复制的测试来竞争共享数据.

运行配置的套件 `gateforge test-gates --changed`。对于选定的非授权切片,使用 `gateforge test-gates --changed --scope changed --result-only`;此报告不创建或更改收据而选择的结果.

## 在第一次目击运行前安装浏览器

`npx playwright install chromium`,来自持有您 Playwright 配置的目录。 在没有浏览器的系统库的Linux机上——一个容器,一个CI图像,WSL——也安装在同一命令中: `npx playwright install --with-deps chromium` (它需要根或sudo). `gateforge enforcement doctor` 名称大小写 : 缺少安装的构建名称, 以及安装但不能开始命名加载器自己的行和 `npx playwright install-deps chromium` 这可以解决它.

## 常见问题

### @gate-forge/pack-playwright 是什么？

Gateforge Playwright 证据包:回回证人服务,引擎侧适配器执行,可信赖的证据固定,判决记者\.

### 如何安装 @gate-forge/pack-playwright？

在项目目录运行 npm install @gate-forge/pack-playwright，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 gateforge-witness，可以用 npx gateforge-witness 直接运行。

### @gate-forge/pack-playwright 支持 TypeScript 吗？

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

### @gate-forge/pack-playwright 支持 ESM 还是 CommonJS？

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

### @gate-forge/pack-playwright 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @gate-forge/pack-playwright 可以商用吗？

@gate-forge/pack-playwright 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @gate-forge/pack-playwright 的下载量有多少？

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

### @gate-forge/pack-playwright 还在维护吗？

最新版本 0\.19\.2 发布于 2026/11/10（5 天前）；至今共发布 46 个版本，其中过去 12 个月发布了 46 个；首次发布于 2026/09/17。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

