用途:为编写 Playwright 端到端(E2E)测试提供规范与模式,触发场景是编写 Playwright E2E 测试时,涉及 Page Object Model、选择器与 MCP 探索工作流。
主要能力:
- 测试前评估:先检查是否已有测试覆盖、单元测试是否更合适、E2E 是否比单元测试更有价值。
- MCP 工作流(若可用则强制):先导航到目标页、快照查看结构、交互验证真实用户流程、截图记录预期状态、验证页面跳转(加载/成功/错误),再从快照记录真实选择器,最后才写测试代码。
- 等待策略:禁止固定等待,改用 toBeVisible、waitForResponse、waitForURL 等条件等待;SPA 优先显式等待而非 networkidle。
- 文件结构:tests/ 下含 base-page.ts、helpers.ts 及按页面命名的 page、spec、md 文件;同一页面所有测试放一个 spec 文件。
- 选择器优先级:getByRole、getByLabel 优先,getByText 谨慎使用,getByTestId 兜底,避免 CSS 类与 id 等脆弱选择器。
- Page Object 复用:先查已有 page object,能复用则复用,仅在页面不存在时新建。
- 重构:通用导航、通知、弹窗、截图等移入 BasePage;数据生成、setup/teardown、自定义断言、API 辅助移入 helpers.ts。
- 其他:测试标签(@critical、@e2e、功能、测试 ID)、测试文档格式、认证状态复用(storageState)、API Mock、fixtures、并行与 serial 模式、软断言与轮询断言、视觉回归、常见陷阱、iframe 与 Shadow DOM、移动端与视口测试、调试与 trace、CI/CD 配置。
使用方式:通过 npx playwright test 运行,支持按文件、文件夹、名称 grep、标签 grep、行号、多模式匹配与排除运行;调试可用 --debug、--headed、--trace on、--project、codegen。
适用场景:需要为 Web 应用编写稳定、可维护的 Playwright E2E 测试的团队与开发者。
限制:资料未提供该技能的安装方式、收费、价格、平台支持范围与效果数据;部分内容在原文末尾被截断。