该资料是一份 Playwright E2E 测试编写规范,用于指导编写端到端测试,包含 Prowler 特定 UI 场景的约定。
用途:在编写 Playwright E2E 测试时遵循统一模式。
主要能力与约定:
- 若可用 Playwright MCP 工具,必须先导航目标页面、截图查看结构、交互表单验证流程、记录真实选择器,再创建测试;不可用时基于文档和代码分析编写。
- 文件结构:tests 下含 base-page.ts、helpers.ts,以及按页面命名的目录,内含 {page-name}-page.ts、{page-name}.spec.ts 和 {page-name}.md,同一功能的测试须集中在单个 spec 文件。
- 选择器优先级:优先 getByRole、getByLabel,谨慎用 getByText,最后用 getByTestId,避免 .class 或 #id 等脆弱选择器。
- Page Object 模式:所有页面继承 BasePage,公共方法上移;编写测试前先检查并复用已有 page object。
- 测试使用标签分类(优先级、类型、功能、Test ID),文档仅描述具体测试用例。
用法命令:npx playwright test 运行全部;--grep 过滤;--ui 交互;--debug 调试;指定目录运行。
限制:资料未说明安装方式、版本要求、平台与收费信息;Prowler 专用认证、环境变量与测试 ID 需参考 references/prowler-e2e.md。