📦 Playwright Test Helper — Playwright 测试助手

Playwright 测试助手 帮助编写、调试和优化 Playwright 端到端测试。生成页面对象模型、修复不稳定的选择器、提高测试可靠性、调试失败的测试并加速测试执行。当 E2E 测试速度慢、不稳定或难以维护时使用。

用法 "帮助我编写 Playwright 登录流测试" "修复不稳定的 Playwright 测试" "从我的应用程序生成页面对象" "加速我的 Playwright 测试套件" "调试为什么这个 Playwright 测试在 CI 中失败"

工作原理

• 项目分析

cat playwright.config.ts 2>/dev/null || cat playwright.config.js 2>/dev/null find . -name ".spec.ts" -o -name ".test.ts" | grep -i "e2e\|playwright" | head -20

• 测试生成

从页面分析生成： 页面对象模型类带有类型化定位器 覆盖快乐路径的测试场景 错误状态测试 使用 @axe-core/playwright 的无障碍断言 视觉回归快照

• 不稳定测试诊断

常见的不稳定原因和解决方法： 定时：缺少 await、竞态条件 → 使用 waitFor、expect().toBeVisible() 选择器：文本内容更改、动态 ID → 使用 data-testid、role 选择器 状态：测试顺序依赖 → 适当的设置/拆卸、隔离的上下文 网络：慢的 API 响应 → 使用路由模拟、waitForResponse CI 特定：不同的视口、字体、定时 → 配置 CI 特定的设置

• 性能优化

并行测试执行（fullyParallel: true） 浏览器在测试文件之间重用 存储状态用于经过身份验证的测试（避免重新登录） 用于慢/不稳定外部 API 的路由模拟 使用标签/grep 选择性地运行测试

• 最佳实践

使用 web-first 断言（expect(locator).toBeVisible()） 更喜欢用户面向的选择器（role、text、label） 避免 page.waitForTimeout() —— 使用适当的等待 保持测试独立（测试之间没有共享状态） 使用测试固定装置进行常见设置

输出

Playwright 测试分析

测试文件： 23 | 总测试： 89 | 平均持续时间： 4.2s

🔴 不稳定测试 (4)

• checkout.spec.ts:45 — "处理支付"

不稳定因为：click('Submit') 在按钮启用之前 修复：await expect(submitBtn).toBeEnabled(); await submitBtn.click()

• search.spec.ts:12 — "显示结果"

不稳定因为：page.waitForTimeout(2000) 用于 API 修复：await page.waitForResponse('/api/search')

⚡ 速度改进

• 启用 fullyParallel：~45% 时间减少
• 为 15 个依赖于身份验证的测试添加 storageState：节省 30s
• 为所有测试模拟 /api/analytics：删除 800ms/测试

📊 预计：6m 15s → 2m 20s (63% 更快)