SuperAPI AI 工具集

playwright

测试与质量

查看项目

更新于 10-16 04:34

技能介绍

该资料是一份 Playwright E2E 测试编写规范,用于指导编写端到端测试,包含 Prowler 特定 UI 场景的约定。

用途:在编写 Playwright E2E 测试时遵循统一模式。

主要能力与约定:

  1. 若可用 Playwright MCP 工具,必须先导航目标页面、截图查看结构、交互表单验证流程、记录真实选择器,再创建测试;不可用时基于文档和代码分析编写。
  2. 文件结构:tests 下含 base-page.ts、helpers.ts,以及按页面命名的目录,内含 {page-name}-page.ts、{page-name}.spec.ts 和 {page-name}.md,同一功能的测试须集中在单个 spec 文件。
  3. 选择器优先级:优先 getByRole、getByLabel,谨慎用 getByText,最后用 getByTestId,避免 .class 或 #id 等脆弱选择器。
  4. Page Object 模式:所有页面继承 BasePage,公共方法上移;编写测试前先检查并复用已有 page object。
  5. 测试使用标签分类(优先级、类型、功能、Test ID),文档仅描述具体测试用例。

用法命令:npx playwright test 运行全部;--grep 过滤;--ui 交互;--debug 调试;指定目录运行。

限制:资料未说明安装方式、版本要求、平台与收费信息;Prowler 专用认证、环境变量与测试 ID 需参考 references/prowler-e2e.md。