e2e-testing-patterns

端到端测试模式

构建可靠、快速且易于维护的端到端测试套件，让你有信心快速交付代码，并在用户发现回归之前将其捕获。

何时使用此技能

• 实现端到端测试自动化
• 调试不稳定或不可靠的测试
• 测试关键用户工作流
• 搭建 CI/CD 测试流水线
• 跨多个浏览器进行测试
• 验证无障碍要求
• 测试响应式设计
• 建立端到端测试标准

何时不要使用此技能

• 你只需要单元测试或集成测试
• 环境无法支持稳定的 UI 自动化
• 你无法提供安全的测试账号或数据

操作说明

1. 确定关键用户旅程和成功标准。
2. 构建稳定的选择器和测试数据策略。
3. 实现具有可观察断言和追踪的隔离测试；诊断重试原因，而不是把一次重试当作普通通过。
4. 在 CI 中运行，并启用并行化和产物捕获。

安全

• 避免针对生产环境运行破坏性测试。
• 使用专用测试数据并清理敏感输出。

资源

• resources/implementation-playbook.md 提供详细的端到端模式和模板。

示例

输入：无效登录有时会显示为成功，因为测试在渲染完成之前就读取了错误信息。使用专用的 fixture 账号，并断言 await expect(page.getByRole('alert')).toContainText('Invalid credentials')。在不重试的情况下运行测试，并确认仪表盘仍然无法访问。预期：失败状态能够被可靠地观察到；延迟出现的错误无法静默通过。

输入和前提条件

一个已授权的测试 URL、隔离的账号/数据、已安装的浏览器运行器，以及已知的成功/失败状态。该 playbook 使用项目特定的路由和适配器；只安装你现有测试套件所需的依赖。

限制

• 模拟的后端或支付提供商只能证明被模拟的边界；请保留单独的真实集成检查。
• 自动化无障碍扫描会遗漏交互和辅助技术问题。
• 重试、更长的超时和更新快照可能会掩盖回归；请保留首次失败的证据。
• 浏览器工具无法验证已锁定或不可用的交互环境。请报告这一缺口，并继续执行独立的测试。