SuperAPI AI 工具集

playwright

测试与质量

查看项目

更新于 10-16 03:46

技能介绍

用途:为 Next.js 应用提供 Playwright 测试最佳实践指南,适用于编写新测试、排查不稳定或失败用例、优化执行速度、配置认证状态复用、搭建 CI/CD 测试流水线、测试 Server Components 与 App Router 特性,以及审查测试代码可靠性。

主要能力:以 43 条规则按影响优先级分为 8 类。测试架构(arch-,关键):每个测试使用全新浏览器上下文、启用并行执行、复杂页面用 Page Object Model、用 fixtures 共享初始化、针对生产构建测试、测试后清理状态。选择器(loc-,关键):优先 role 选择器而非 CSS、动态元素用 data-testid、表单用 getByLabel、静态内容用 getByText、避免 XPath、链式定位、谨慎用 getByPlaceholder。等待与断言(wait-,高):使用 web-first 断言、避免硬等待、复杂页面用网络空闲、让动作自动等待、非关键检查用软断言、合理配置超时。认证与状态(auth-,高):用存储状态复用认证、不同角色用独立存储状态、处理 session storage、用 API 登录加速、并行测试用 worker 级认证。Mock 与网络(mock-,中高):Mock API 响应保证确定性、拦截并修改真实响应、复杂场景用 HAR 文件、中止不必要请求、模拟网络状况。Next.js 集成(next-,中):交互前等待 hydration、正确测试 Server Components、测试 App Router 导航、端到端测试 Server Actions、配置 baseURL。性能(perf-,中):大型套件用分片、CI 用无头模式、策略性选择浏览器、复用开发服务器、配置重试。调试与 CI(debug-,低中):失败用 trace viewer、失败时截图录像、用 Playwright Inspector 交互调试、配置 CI 报告器。

使用方式:按需阅读对应参考文件获取详细说明与代码示例,规则前缀对应类别;参考文件包括 AGENTS.md(全部规则合集)、references/_sections.md(分类定义)、assets/templates/_template.md(新规则模板)、metadata.json(版本信息)。

限制:资料未提供安装命令、具体代码示例、收费与价格、支持的平台版本等细节;具体实现细节需查阅上述参考文件。