Playwright 端到端测试
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/asyrafhussin-agent-skills-e2e-playwright-testing。
技能介绍
你在对抗什么问题
浏览器端到端测试本来就容易在 CI 里间歇失败:定位器绑在易变 CSS 上、waitForLoadState('networkidle') 在 SPA 里永远等不到、React 受控组件里 fill() 填不进日期字段,还有每次用例都从头登录拖慢流水线。这份技能不是 Playwright API 速查表,而是一套在写用例或做 Code Review 之前先对齐工程上下文的规则集:先确认项目用的是 @playwright/test 而不是 Cypress,再识别前端栈与认证方式,然后按优先级套用 8 条约定。
技能如何组织规则
规则按影响面分成六类,并带统一前缀便于对照:
loc(定位):优先getByRole/getByLabel,处理 strict mode 冲突(exact/first/ 作用域收窄)auth(认证):用 setup project + storage state 复用登录态,避免每个 spec 重复走登录流assert(断言):用会对 locator 自动重试的expect(),而不是拍脑袋waitForTimeoutform(表单):React 日期时间用keyboard.type();自定义sr-only复选框要按可访问性角色点选org(结构):测试目录镜像路由分组,方便和维护中的路由一一对应rel(稳定性):明确禁止任意waitForTimeout;并行策略与 flakiness 挂钩时要按文档里的决策模板取舍
技能还强调栈差异:React + Inertia.js 导航应 waitForURL,不要依赖 full reload 或 network idle;SPA 断言要等内容出现在 DOM,而不是等网络静默。
适用边界
仅适用于已采用 Playwright Test 的 Web 项目。仓库里只有 Cypress 时,本技能规则不适用。完整展开版规则在资料中的 AGENTS.md;本页介绍对应 SKILL.md 的摘要与分类,不替代官方 Playwright 文档。
使用场景
- 新项目引入 Playwright,需要按 role/label 定定位策略并搭好带 storage state 的登录 setup
- Review 同事 PR 时发现大量 `waitForTimeout`,要改成可自动重试的 locator 断言
- React SPA 表单用例总在日期字段失败,需要按规则改用 `keyboard.type()` 并处理自定义复选框
- 要把 E2E 接到 CI,同时决定并行度并避免 Inertia 导航误用 networkidle
适合人员
- 维护中大型前端仓库、需要统一 E2E 定位与目录规范的测试开发工程师
- 负责 CI 流水线、要解决 Playwright 用例间歇红绿的 DevOps / 平台工程师
- 带团队做 Code Review、要拿清单否决 arbitrary wait 与脆弱 CSS 选择器的 Tech Lead
- 用 React/Inertia 交付产品、登录与表单流测试长期不稳定的全栈开发者