用途:为 Playwright E2E 测试套件中的指定页面生成 Page Object Model(POM)类,按项目既有约定组织代码。
主要能力:根据用户请求确定页面名(如 Settings → settings.page.ts);检查 e2e/poms/ 下是否已有该页 POM,若有则向其中添加方法而非新建;识别并继承 e2e/poms/base.page.ts 中的基类;阅读应用目标页面以理解元素与交互;按模板生成 POM 文件;验证文件无 TypeScript 编译错误。
结构约定:每个 POM 用注释横幅划分 LIFECYCLE、LOCATORS、NAVIGATION、VERIFICATION、CREATE、EDIT、DELETE 等区块;实现 setUp() 与 tearDown();选择器优先级为 getByRole() > getByLabel() > getByText() > getByPlaceholder() > locator();每个公开方法需带 JSDoc,含摘要、编号步骤、@param,返回值时加 @returns。
命名:文件为 e2e/poms/{feature}.page.ts(小写 kebab-case),类为 {Feature}Page(PascalCase),功能名需与对应 spec 和 test-data 文件一致。
规则:一页一个 POM;所有 POM 继承基类;POM 内不得引用其他 POM,多页面由 spec 文件编排。
限制:资料未提供安装命令、收费、平台支持及具体运行方式;完整模板见 references/pom-template.md。