SuperAPI AI 工具集

agent-browser-e2e

测试与质量

查看项目

更新于 10-16 09:49

技能介绍

agent-browser-e2e 是一个内部模板,用于端到端验证的执行协议,入口为 agent-browser 技能。资料未说明其独立安装或发布方式,使用前需明确它由 agent-browser 编排器调用。

用途:为 agent-browser 提供标准化的 E2E 测试流程,覆盖打开页面、等待稳定、检查错误、登录、执行测试步骤、断言状态和采集证据。

主要流程:先运行 agent-browser open <url> 与 wait --load networkidle,随后用 errors 检查既有 JS 错误并用 snapshot -i 获取引用。登录优先使用 Auth Vault,首次运行 agent-browser auth save myapp --url <login-url> --username admin --password secret 保存凭据,之后用 auth login myapp。测试步骤优先使用语义定位器,如 find label "Email" fill "test@example.com"、find role button click --name "Sign In"。每次导航后需重新 wait --load networkidle 并 snapshot -i,再通过 is visible @e3、is checked @e5、get text @e1 断言,最后用 screenshot --full result.png 采集证据。

恢复与变体:引用失效时重跑 snapshot;页面未加载可重试至多 3 次;慢页面可设 AGENT_BROWSER_DEFAULT_TIMEOUT=60000;输出截断可用 --max-output <chars>。支持移动端 set device "iPhone 15 Pro"、离线 set offline 与 set offline off、地理位置 set geo 31.2304 121.4737。

限制与注意:断言前必须等待 networkidle;导航后不能复用引用;离线测试后必须恢复 set offline off;跳过 errors 检查会使结果失效。禁止用 find ref,应直接用 fill @e3 或 click @e3。弹窗打开时 find label 可能匹配背景元素,建议用 find placeholder 或先 snapshot -s ".dialog-class"。新标签页需用 tab list 检测后 tab 1 切换。JS 执行命令是 eval "JS code",不是 javascript。下载需在点击后用 wait --download <path>,不要依赖固定等待。出现 JS 错误、实际内容与预期不符或重试后仍失败时,应暂停并询问用户。--ignore-https-errors 只可用于预发环境,禁止用于生产。