SuperAPI AI 工具集

playwright

测试与质量

查看项目

更新于 10-16 00:04

技能介绍

用途:驱动真实浏览器完成端到端测试编写与调试、网络拦截与模拟、并行执行、CI 集成、无头抓取以及无障碍快照检查。这是针对 Playwright 单一工具的操作技能;测试策略与框架选型属于 qa-methodology,前端组件与架构设计属于 frontend-engineering。

主要能力:以用户可见行为定位元素(getByRole、getByLabel、getByText),优先于 CSS/XPath;用 page.route() 在边界处模拟外部 HTTP;用 workers 与 --shard 并行与分片;用 web-first 断言(toBeVisible、toHaveText、toHaveURL)替代 waitForTimeout;用 @axe-core/playwright 做 WCAG 扫描,用 toMatchAriaSnapshot 做无障碍断言;用 --headed、--slow-mo、--debug、PWDEBUG=1、page.pause() 与 trace 调试。

使用方式:运行前先读 playwright.config.*、projects、baseURL、webServer、workers、retries、reporters,不要照搬 README 的命令。附带 scripts/pwrun 冒烟工具,doctor、inventory、report 无需 node 或 Playwright 即可运行: scripts/pwrun doctor --json scripts/pwrun inventory --json scripts/pwrun report --report test-results.json --json scripts/pwrun smoke --url http://localhost:3000 --json 退出码:0 正常,1 分析错误,2 用法错误,127 缺少依赖,124 委托超时。CI 中安装浏览器:npx playwright@1.62.1 install --with-deps,并缓存 ~/.cache/ms-playwright。

适用场景:E2E 测试套件编写与结构、定位器稳健性修复、网络模拟、并行与分片、CI 失败分诊、无头抓取、无障碍扫描与调试。

限制:不得模拟被测代码本身;不得违反 robots.txt、条款或速率限制,不得采集凭据或个人数据;不得提交 playwright/.auth/*、.env 或浏览器凭据;不得盲目 --update-snapshots;不得把原始 HTML、完整 trace 或受保护内容截图贴入对话;CI 中有头浏览器需要显示服务器(如 xvfb)。Cloudflare/DDoS-GUARD 绕过请用 flaresolverr;大规模负载测试、测试策略与前端架构设计不在本技能范围。