用途:为 Playwright 测试开发提供按活动分类的参考索引,从编写新测试到调试、维护既有测试套件均可按场景查阅对应文档。
主要能力:文档按活动组织,含编写新测试(E2E 用 test-suite-structure.md、locators.md、assertions-waiting.md;组件测试;API 与 GraphQL 测试;视觉回归;POM 结构;测试数据与 fixtures;认证;时钟模拟;文件上传下载;表单校验;拖放;无障碍;安全测试等)、移动与响应式测试、实时与浏览器 API(WebSocket、定位、权限、多标签)、调试与排错(不稳定的测试、超时、选择器)、错误与边界测试、多用户协作、架构决策、框架专属(React、Angular、Vue、Next.js)、重构维护、基础设施与配置(CI/CD、GitHub Actions、GitLab CI、Docker、分片并行、性能、覆盖率、报告)、高级模式(API 模拟、网络拦截、HAR 录制、自定义 fixtures)。另提供快速决策树,按“正在做什么”引导到对应文件。
使用方式:先按决策树或活动表定位参考文件,再据此编写或修改测试。资料给出的测试验证闭环为:运行 npx playwright test --reporter=list;失败时查看错误输出与 trace(npx playwright show-trace);修正定位器、等待或断言后重跑;关键测试可多次运行 npx playwright test --repeat-each=5。
适用场景:E2E、组件、API、GraphQL、视觉回归、无障碍、i18n、Electron、浏览器扩展、移动端、多用户、表单校验、拖放、错误边界、服务 worker 等测试,以及测试架构选型、既有测试重构和 CI/CD 配置。
限制:资料未提供具体安装命令、版本要求、框架运行示例代码、收费或授权信息;部分参考文件仅给出文件名与主题,未展开具体内容。