SuperAPI AI 工具集

e2e-test-builder

测试与质量

查看项目

更新于 10-15 18:37

技能介绍

E2E Test Builder 是一个用于构建端到端(E2E)浏览器测试的技能,目标是针对关键用户流程编写可靠的自动化测试。资料显示它支持 Playwright 或 Cypress,并围绕选择器策略、测试数据管理、页面对象模式等给出实践示例。

用途:为 Web 应用的关键用户流程(如登录、结账、注册)构建端到端浏览器测试,确保这些流程在真实浏览器环境中按预期工作。

主要能力:

  • Playwright 测试配置:提供 playwright.config.ts 示例,包含 testDir、并行执行、CI 下的重试与 worker 限制、HTML 报告、baseURL、trace、截图策略,以及 chromium、firefox、webkit、Mobile Chrome 等多项目配置和 webServer 启动命令。
  • 关键流程测试:以结账流程为例,展示登录、浏览商品、加入购物车、进入购物车、填写收货与支付信息、下单并验证成功;同时包含空字段校验错误和支付失败场景。
  • 页面对象模式:提供 LoginPage 和 ProductPage 类示例,封装 goto、login、expectLoginSuccess、expectLoginError、addToCart、expectProductVisible 等方法,并在测试中复用。
  • 选择器策略:给出优先级建议,依次为基于角色(getByRole)、基于标签(getByLabel)、测试 ID(getByTestId)、文本内容(getByText),并建议避免脆弱的 CSS 选择器。
  • 测试数据管理:提供 test-data.ts 示例,包含用户、产品、卡号(有效、拒付、余额不足)等数据,以及使用 Prisma 进行 seedTestData 的示例。
  • 视觉回归测试:展示使用 toHaveScreenshot 对首页和产品卡片进行截图对比,支持 fullPage 和 maxDiffPixels。
  • 移动端测试:通过 viewport 设置模拟 iPhone SE,并演示移动端结账流程。
  • 网络模拟:使用 page.route 模拟支付 API 超时,验证加载状态。
  • 最佳实践与输出清单:强调测试用户流程而非单个组件、使用基于角色的选择器、页面对象、避免固定等待、测试关键路径、隔离测试数据、仅对关键页面做视觉回归;输出清单包括 Playwright/Cypress 配置、关键流程识别、页面对象创建、选择器策略定义、测试数据管理、setup/teardown 钩子、认证流程测试、错误状态测试、移动视口测试、CI 集成配置。

使用方式:资料以代码示例为主,展示如何配置 Playwright、编写测试、创建页面对象、管理测试数据、进行视觉回归、移动端测试和网络模拟。用户可参考这些示例在项目中落地。

适用场景:需要为 Web 应用建立端到端测试的开发者、测试人员或团队,尤其是关注登录、结账、注册等关键流程的可靠性,并希望采用页面对象和基于角色选择器等可维护实践的场景。

限制:资料未提供该技能的具体安装命令、收费信息、平台支持范围、效果保证或与其他工具的集成细节;部分内容(如 Cypress 的具体示例)未在资料中展开。