写有目击的旅程
有目击的旅程必须进行真正的应用行为并验证用户所依赖的结果. 通过测试申报不是证明:只有有效收据证明运行,而采用的基准可以免除先前接受的债务.
从完整的示例开始
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 这可以解决它.