用途:为 Web 应用提供系统化测试原则与自动化浏览器脚本,目标是“发现并测试一切,不留下未测试的路由”。
主要能力:内置运行时脚本 scripts/playwright_runner.py,可做基础浏览器测试、截图与无障碍检查。用法示例: python scripts/playwright_runner.py https://example.com python scripts/playwright_runner.py <url> --screenshot python scripts/playwright_runner.py <url> --a11y 依赖:pip install playwright && playwright install chromium
方法:深度审计从发现开始——扫描 app/、pages/、路由文件找路由,用 grep 查 HTTP 方法找 API 端点,查找组件目录,阅读文档找功能;随后映射全部路由/API、扫描验证响应、测试关键路径。测试金字塔为大量组件测试、部分集成测试(API 与数据流)、少量 E2E 测试。E2E 优先覆盖顺序:正常用户流程、认证流程、关键业务操作、错误处理。最佳实践包括使用 data-testid 稳定选择器、等待元素、保持状态干净与测试独立、避免实现细节。
Playwright 原则:页面对象模型封装页面逻辑、Fixtures 复用测试准备、内置自动等待断言、Trace Viewer 调试失败;建议 CI 重试 2 次,trace 设为 on-first-retry,失败时截图,失败保留视频。视觉测试适用于设计系统与营销页,策略是先存基线截图、变更时对比、审查差异、有意变更后再更新。API 测试关注状态码、响应结构、错误信息与边界情况。组织上按 tests/e2e、integration、component、fixtures 分目录,命名可用 login.spec.ts 或 user-can-checkout.spec.ts。CI 流水线为安装依赖、安装浏览器、运行测试、上传产物(trace、截图),大套件可用分片与多 worker 并行。反模式:不要测试实现细节、硬编码等待、跳过清理、忽视不稳定测试。
限制:E2E 测试成本高,仅用于关键路径;资料未提供分类、定价、支持平台或版本等其它信息。