Java版Playwright实战：从零开始搭建自动化测试框架（含完整代码示例）

Java版Playwright实战：从零开始搭建自动化测试框架（含完整代码示例）

在当今快节奏的软件开发环境中，自动化测试已成为保障产品质量不可或缺的一环。对于Java开发者而言，Playwright以其跨浏览器支持、现代化API设计和出色的执行速度，正迅速成为自动化测试领域的新宠。本文将带你从零开始，构建一个完整的Java版Playwright测试框架，涵盖从环境搭建到高级特性的全流程实战。

1. 环境准备与基础配置

1.1 项目初始化与依赖管理

开始前，确保你的开发环境满足以下基本要求：

• JDK 8或更高版本
• Maven 3.6+或Gradle 6.0+
• 推荐使用IntelliJ IDEA或Eclipse等现代IDE

在Maven项目中添加Playwright依赖：

<dependency> <groupId>com.microsoft.playwright</groupId> <artifactId>playwright</artifactId> <version>1.40.0</version> </dependency>

对于Gradle项目：

implementation 'com.microsoft.playwright:playwright:1.40.0'

提示：Playwright会自动下载所需的浏览器二进制文件，首次运行可能需要较长时间下载。

1.2 浏览器管理与页面控制

Playwright支持Chromium、Firefox和WebKit三种浏览器引擎。以下是一个基础示例，展示如何启动浏览器并创建页面：

import com.microsoft.playwright.*; public class BasicSetup { public static void main(String[] args) { try (Playwright playwright = Playwright.create()) { Browser browser = playwright.chromium().launch( new BrowserType.LaunchOptions().setHeadless(false)); BrowserContext context = browser.newContext(); Page page = context.newPage(); page.navigate("https://www.example.com"); System.out.println("当前页面标题: " + page.title()); page.close(); browser.close(); } } }

关键参数说明：

2. 核心API实战应用

2.1 元素定位与交互操作

Playwright提供了多种元素定位策略，以下是最常用的几种方式：

// 通过CSS选择器定位 page.locator("#submit-button").click(); // 通过文本内容定位 page.locator("text=登录").click(); // 通过XPath定位 page.locator("//button[@id='save']").click(); // 组合定位 page.locator("div.error >> text=重试").click();

表单操作示例：

// 文本输入 page.locator("#username").fill("testuser"); // 复选框操作 page.locator("#remember-me").check(); // 下拉选择 page.locator("#country").selectOption("China"); // 文件上传 page.locator("input[type='file']") .setInputFiles(Paths.get("testdata/sample.pdf"));

2.2 等待策略与异步处理

可靠的等待机制是自动化测试的关键。Playwright提供了多种等待方式：

// 显式等待元素可见 page.locator("#dynamic-element").waitFor( new Locator.WaitForOptions().setState(WaitForSelectorState.VISIBLE)); // 等待网络请求完成 page.waitForResponse(response -> response.url().contains("/api/data") && response.status() == 200, () -> page.locator("#load-data").click()); // 自定义等待条件 page.waitForCondition(() -> page.locator("#progress").textContent().equals("100%"));

3. 高级特性与框架设计

3.1 页面对象模型(POM)实现

采用POM模式可以提高代码的可维护性。下面是一个登录页面的示例实现：

public class LoginPage { private final Page page; public LoginPage(Page page) { this.page = page; } public void navigate() { page.navigate("https://example.com/login"); } public void login(String username, String password) { page.locator("#username").fill(username); page.locator("#password").fill(password); page.locator("#submit").click(); } public String getErrorMessage() { return page.locator(".error-message").textContent(); } }

3.2 测试用例组织与执行

结合JUnit 5构建测试套件：

import org.junit.jupiter.api.*; public class LoginTest { static Playwright playwright; static Browser browser; BrowserContext context; Page page; @BeforeAll static void launchBrowser() { playwright = Playwright.create(); browser = playwright.chromium().launch(); } @BeforeEach void createContextAndPage() { context = browser.newContext(); page = context.newPage(); } @Test void testSuccessfulLogin() { LoginPage loginPage = new LoginPage(page); loginPage.navigate(); loginPage.login("validUser", "correctPassword"); Assertions.assertTrue(page.url().contains("/dashboard")); } @AfterEach void closeContext() { context.close(); } @AfterAll static void closeBrowser() { browser.close(); playwright.close(); } }

4. 实用技巧与性能优化

4.1 截图与视频录制

Playwright内置了强大的多媒体记录功能：

// 配置录制选项 BrowserContext context = browser.newContext(new Browser.NewContextOptions() .setRecordVideoDir(Paths.get("videos/")) .setRecordVideoSize(1280, 720)); // 页面截图 page.screenshot(new Page.ScreenshotOptions() .setPath(Paths.get("screenshots/homepage.png")) .setFullPage(true)); // 元素级别截图 page.locator(".feature-card").screenshot( new Locator.ScreenshotOptions() .setPath(Paths.get("screenshots/feature.png"))); // 生成PDF page.pdf(new Page.PdfOptions() .setPath(Paths.get("reports/page.pdf")) .setFormat("A4"));

4.2 网络拦截与模拟

通过路由功能可以修改网络请求：

// 拦截API请求并返回模拟数据 page.route("**/api/user", route -> { route.fulfill(new Route.FulfillOptions() .setStatus(200) .setContentType("application/json") .setBody("{\"name\":\"Mock User\",\"id\":123}")); }); // 阻止图片加载提升测试速度 page.route("**/*.{png,jpg,jpeg}", route -> route.abort());

4.3 多浏览器与设备模拟

Playwright支持跨浏览器和设备测试：

// 设备模拟 BrowserContext iphoneContext = browser.newContext( new Browser.NewContextOptions() .setDeviceScaleFactor(2) .setHasTouch(true) .setIsMobile(true) .setViewportSize(375, 812)); // 多浏览器测试矩阵 List<BrowserType> browsers = List.of( playwright.chromium(), playwright.firefox(), playwright.webkit() ); for (BrowserType browserType : browsers) { try (Browser b = browserType.launch()) { Page p = b.newPage(); p.navigate("https://example.com"); // 执行测试断言... } }

在实际项目中，我们发现合理使用浏览器上下文(context)可以显著提升测试效率。每个测试用例使用独立的context，既保证了隔离性，又避免了每次启动新浏览器的开销。对于数据敏感的场景，还可以结合storageState实现认证状态的复用。