SuperAPI AI 工具集

peach-e2e-run

测试与质量

查看项目

更新于 10-15 21:38

技能介绍

用途:该技能用于在 Claude Code 中执行 E2E 场景,通过命令行工具 ./e2e.sh(基于 playwright-cli)运行,并使用 agent-browser eval 快速确认调试信息。

主要能力与工具分工:场景执行使用 ./e2e.sh run(基于 playwright-cli);选择器调试与 DOM 查看使用 agent-browser eval(较快);iframe 调试使用 ./e2e/pwc.sh eval 作为 fallback。

工作流程:1)环境确认,运行 cd e2e && ./e2e.sh setup,会自动检查/安装 Chrome Beta、agent-browser、playwright-cli 与 CDP 连接;若 CDP 未连接,需运行 ./e2e.sh chrome。2)查看标签页,运行 cd e2e && ./e2e.sh status,向用户展示标签列表并确认标签编号,编号从 0 开始,chrome:// 标签会被排除,实际页面标签才显示,编号与 --tab N 的 N 对应,使用用户已登录的标签,不区分 local/test/prod 环境。3)查看场景列表,运行 cd e2e && ./e2e.sh list。4)执行,例如 cd e2e && ./e2e.sh run --tab 0 1、run --tab 0 1-3、run --tab 0 all;未指定标签时自动检测第一个非 chrome 页面标签,--tab N 会经 CDP 查询转换为 URL 并作为 E2E_TAB_URL 传给 lib/connect.js。5)结果报告与调试,出现错误时用 agent-browser eval 调试,如 CDP error: Session with given id not found 时依次执行 agent-browser connect 9222、tab list、tab N、eval "document.title" 后重试。

限制与注意事项:空浏览器中若只有 chrome:// 标签,connect.js 会报错,需先打开页面标签或让场景自行打开标签;iframe 内部调试需用 playwright-cli fallback;native dialog 场景禁止全局 page.on('dialog', dialog.accept()),禁用 process.exit(0) 固定退出,需用 try/catch/finally 与 exitCode,并在点击前显式等待页面状态;外部服务跳转需使用 load + 2 秒延迟 + 直接跳转 fallback;调试/复现建议用 E2E_TAB_ID 避免索引漂移。更多细节可参考 peach-e2e-browse/references/ 下的相关文档。