用途:在 Java 中生成生产级 Playwright E2E 测试代码,覆盖从零搭建新项目、编写页面对象与 JUnit 5 测试类,到修复不稳定测试、CI/CD 集成、跨浏览器与并行执行、API+UI 混合测试等场景。
主要能力:强制 Page Object Model(POM),定位器统一声明为字段并优先使用 getByRole、getByLabel、getByTestId;用 ThreadLocal 保证并行安全;支持跨浏览器参数化、Allure 报告、Playwright trace 与视频录制、网络请求模拟、软断言、认证状态复用(storageState)和 APIRequestContext 混合断言。提供 BaseTest、BasePage 模板及 config、page-objects、assertions、fixtures 等参考文件。
使用方式:先按需求选择模式,新项目采用固定目录结构(src/test/java 下的 base、pages、tests、utils、config 及 resources),再配置线程安全的 BaseTest 与基础 Page 类,然后编写页面对象与带 Allure 注解的测试。并行执行通过 junit-platform.properties 设置,CI 中安装浏览器可用 mvn exec:java -e -Dexec.mainClass=com.microsoft.playwright.CLI -Dexec.args="install --with-deps",运行用 mvn test -Dbrowser=... -Dheadless=true。
适用场景:企业级 Web E2E 自动化、跨浏览器回归、API 与 UI 联合验证、CI/CD 流水线测试。
限制:面向 Java 17+ 与 Playwright 1.44+;禁止使用 Thread.sleep() 和硬编码基础 URL;Page Object 内不得创建 Playwright 实例;并行时不可跨线程共享 Page;Allure 需在 maven-surefire-plugin 的 argLine 中加入 AspectJ agent。具体依赖版本、收费与价格信息暂未提供。