SuperAPI AI 工具集

playwright-skill

测试与质量

查看项目

更新于 10-16 09:28

技能介绍

用途:这是一个通用浏览器自动化技能,针对用户的具体测试或自动化需求临时编写 Playwright 代码并执行,而非仅提供预置脚本。可做页面测试、响应式视口检查、登录流程验证、表单填写提交、截图、断链检查等。

主要能力与流程:执行前需先确定 SKILL_DIR(技能安装目录,可能是插件、全局或项目级路径),命令中以其替换。处理 localhost 测试时先自动探测开发服务器:cd $SKILL_DIR && node -e "require('./lib/helpers').detectDevServers().then(servers => console.log(JSON.stringify(servers)))",找到一个直接用,多个则询问,未找到则索取 URL 或协助启动。脚本写入 /tmp/playwright-test-.js,通过 cd $SKILL_DIR && node run.js /tmp/playwright-test-.js 执行,默认使用可见浏览器(headless: false),URL 参数化配置。简单任务可用 run.js 内联执行代码。

首次安装:cd $SKILL_DIR && npm run setup,安装 Playwright 与 Chromium,仅需一次。

辅助与配置:lib/helpers.js 提供 detectDevServers、safeClick、safeType、takeScreenshot、handleCookieBanner、extractTableData 等;可通过 PW_HEADER_NAME/PW_HEADER_VALUE 或 PW_EXTRA_HEADERS 环境变量为请求添加自定义 HTTP 头,需使用 helpers.createContext() 或 getContextOptionsWithHeaders() 生效。高级用法(选择器最佳实践、网络拦截、认证会话、视觉回归、移动模拟、性能、调试、CI/CD)见 API_REFERENCE.md。

限制:仅在任务明确匹配上述范围时使用;输出不能替代环境相关验证、测试或专家评审;缺少必要输入、权限、安全边界或成功标准时应停止并请求澄清。定价与平台兼容等细节暂未提供。