@gate-forge/pack-playwright

中文文档
0.19.2发布于 2026/11/10Apache-2.0TypeScriptESM + CJS构建来源已验证近 30 天下载 2905

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

中文使用文档
文档目录5 节
  1. 从完整的示例开始
  2. 保持每次旅程的隔离
  3. 观察不挂的突变结果
  4. 更喜欢真正的行为 而不是嘲笑
  5. 在第一次目击运行前安装浏览器

写有目击的旅程

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

从完整的示例开始

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 共发布 46 个版本,首次发布于 2026/09/17;过去 12 个月发布了 46 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.19.2latest2026/11/105 天前
0.19.12026/11/106 天前
0.19.02026/10/2917 天前
0.18.32026/10/2522 天前
0.18.22026/10/2125 天前
0.18.12026/10/2125 天前

关于 @gate-forge/pack-playwright 的常见问题

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