用途:为使用 Playwright 构建稳定、快速、易维护的端到端(E2E)测试套件提供模式与规范参考,适用于 Web 应用的回归、关键流程与多浏览器验证。
主要能力:
- 测试组织:按 e2e/auth、e2e/features、e2e/api 等目录拆分用例,fixtures 放认证与数据,配置集中在 playwright.config.ts。
- Page Object Model:用类封装页面与 Locator,暴露 goto、search、getItemCount 等方法,减少用例重复。
- 配置:testDir、fullyParallel、forbidOnly、CI 下 retries/workers、reporter(html/junit/json)、baseURL、trace、screenshot、video、actionTimeout、navigationTimeout,以及 chromium/firefox/webkit/mobile-chrome 多项目配置和 webServer 启动命令。
- 不稳定测试治理:用 test.fixme / test.skip 隔离并关联 Issue,用 --repeat-each=10、--retries=3 定位 flaky;规避竞态、网络与动画时序问题,改用自动等待、waitForResponse、waitForLoadState。
- 产物管理:截图(含 fullPage、元素级)、trace 开始/停止、失败保留视频。
- CI/CD 集成:GitHub Actions 示例包含 checkout、setup-node、npm ci、npx playwright install --with-deps、npx playwright test、上传 playwright-report 产物。
- 报告模板:汇总总数/通过/失败/不稳定/跳过,列出失败用例文件行号、错误、截图与修复建议。
- 特殊场景:Web3 钱包通过 context.addInitScript 注入 Mock 的 window.ethereum;金融关键流程在生产环境跳过,确认后等待 /api/trade 响应并断言成功状态。
使用方式:安装 Playwright 后按资料中的配置与目录结构编写用例,通过 npx playwright test 及对应参数运行。
限制:资料未提供版本号、依赖清单、授权协议、价格与具体支持平台等细节,暂未提供。