古法编程

使用 Playwright Java 构建企业级 E2E 自动化测试

解决自动化测试维护成本高、执行速度慢及稳定性差的问题：通过 AI 引导实现基于 POM 模式的 Playwright Java 测试架构，支持线程安全并行执行和详细的 Allure 报告集成。

为什么需要这个技能

在企业级应用中，传统的 UI 测试常面临“易碎”（Flaky）的问题，且随着测试用例增加，执行时间呈线性增长。

Playwright 为 Java 开发者提供了比 Selenium 更现代的 API，支持自动等待、网络拦截和强大的 Trace 追踪功能。通过引入 Page Object Model (POM) 设计模式，可以将页面元素与测试逻辑解耦，极大降低维护成本。同时，利用 ThreadLocal 实现的并行执行，能将数小时的测试时间缩短至数十分钟。

适用场景

  • 从零开始搭建 Playwright Java 自动化测试框架。
  • 编写可维护的 Page Object 类或 JUnit 5 测试用例。
  • 解决测试中的不稳定（Flaky）问题，将 Thread.sleep() 替换为智能等待。
  • 配置跨浏览器测试、并行执行或集成 Allure 报告。
  • 在 GitHub Actions 或 Jenkins 等 CI/CD 流水线中部署端到端测试。
  • 实现 UI 与 API 混合测试（Hybrid Testing）。

核心工作流

1. 架构脚手架搭建

遵循标准的 Maven 项目结构，将基础类（BaseTest/BasePage）、页面对象（Pages）、测试用例（Tests）和配置（Config）分层管理，确保代码职责单一。

2. 实现线程安全的 BaseTest

为了支持并行执行，必须使用 ThreadLocal 管理 Playwright 实例及其相关组件。

public class BaseTest {
    protected static ThreadLocal<Playwright> playwrightTL = new ThreadLocal<>();
    protected static ThreadLocal<Browser> browserTL = new ThreadLocal<>();
    protected static ThreadLocal<BrowserContext> contextTL = new ThreadLocal<>();
    protected static ThreadLocal<Page> pageTL = new ThreadLocal<>();

    protected Page page() { return pageTL.get(); }

    @BeforeEach
    void setUp() {
        Playwright playwright = Playwright.create();
        playwrightTL.set(playwright);
        // ... 初始化 Browser 和 Context
        pageTL.set(contextTL.get().newPage());
    }
}

3. 构建 POM 页面对象

在 Page 类中将所有 Locator 定义为字段，而非在方法内内联，并利用流式接口（Fluent Chaining）返回下一个页面对象。

public class LoginPage extends BasePage {
    private final Locator emailInput;
    private final Locator loginButton;

    public LoginPage(Page page) {
        super(page);
        emailInput = page.getByLabel("Email address");
        loginButton = page.getByRole(AriaRole.BUTTON, new Page.GetByRoleOptions().setName("Sign in"));
    }

    public DashboardPage loginAs(String email, String password) {
        fill(emailInput, email);
        clickAndWaitForNav(loginButton);
        return new DashboardPage(page);
    }
}

4. 编写增强型测试用例

结合 JUnit 5 和 Allure 注解，实现具备语义化描述和严重程度标记的测试脚本。

下载和安装

下载 playwright-java 中文版 Skill ZIP

解压后将目录放入你的 AI 工具 skills 文件夹，重启工具后即可使用。具体路径参考内附的 USAGE.zh.md。

你可能还需要

暂无推荐