SuperAPI AI 工具集

create-pom

测试与质量

查看项目

更新于 10-15 16:42

技能介绍

用途:为 Playwright 端到端测试套件中的指定页面生成 Page Object Model(POM)类,遵循 E2E 测试约定。

工作流程:根据用户请求确定页面名称(如 Settings 对应 settings.page.ts);若 e2e/poms/ 中已存在该页面的 POM,则向现有 POM 添加方法,不重复创建;在 e2e/poms/base.page.ts 中识别基类并继承;阅读应用目标页面以了解元素与交互;按模板生成 POM 文件;验证文件编译无 TypeScript 错误。

规则:一页一个 POM,每个不同页面/视图对应唯一 POM 文件;所有 POM 继承基类;实现继承自基类的 setUp() 与 tearDown();可复用助手方法应放在 BasePage 而非派生 POM;POM 内不得引用其他 POM,多页面由 spec 文件编排;每个公共方法需详细 JSDoc,含摘要、步骤编号、@param 标签;选择器优先级为 getByRole() > getByLabel() > getByText() > getByPlaceholder() > locator()。

结构:按注释横幅分区,包括 LIFECYCLE、LOCATORS、NAVIGATION、VERIFICATION、CREATE、EDIT、DELETE 等区块,模板中包含 import、export class、构造函数、heading 与 createButton 定位器、navigateToPage、verifyItemExists、createItem 等方法示例。

命名:文件为 e2e/poms/{feature}.page.ts(小写 kebab-case),类为 {Feature}Page(PascalCase),特性名需与对应 spec 和测试数据文件一致;完整样板见 references/pom-template.md。

适用场景:Playwright E2E 测试中添加新页面对象、扩展已有 POM 或统一 POM 规范。限制:依赖项目已具备 BasePage、e2e/poms/ 目录与 Playwright 环境;具体安装命令、版本要求与依赖包暂未提供。