Playwright for Java 框架解析与自动化测试实战

适用场景总结：

• 选择 Playwright for Java：现代化 Web 应用（React、Vue 等）的爬虫 / 自动化测试、需要网络拦截或移动端模拟的场景、追求高效并行执行的需求。
• 选择 WebDriver（Selenium）：需兼容老旧浏览器（如 IE）、已有成熟 Selenium 项目无需迁移、需支持原生 Safari 浏览器的场景。

三、Playwright 核心模块详解

Playwright for Java 的 API 设计遵循'分层架构'，核心模块职责清晰，以下是关键模块的作用与核心类：

核心工作流程：

1. 初始化 Playwright 实例 → 2. 启动 Browser（浏览器） → 3. 创建 BrowserContext（上下文） → 4. 通过 Context 创建 Page（页面） → 5. 利用 Page 和 Locator 操作页面元素 / 网络请求。

四、实战示例：关键功能代码实现

以下是 Playwright for Java 的核心功能实战示例，包含依赖配置、网络拦截、截图、移动端模拟、JS 脚本执行等常用场景。

1. 环境准备（Maven 依赖）

首先在 pom.xml 中引入 Playwright for Java 依赖（最新版本可从 Maven 中央仓库查询）：

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

首次运行时，Playwright 会自动下载对应浏览器的二进制文件（无需手动配置驱动）。

2. 拦截网络请求（捕获 API 响应）

通过 BrowserContext 的 onResponse 回调，可拦截所有网络响应，获取 URL、状态码、响应内容等信息，适用于爬虫捕获接口数据或自动化测试断言网络行为：

import com.microsoft.playwright.*;
import java.nio.charset.StandardCharsets;

public class NetworkInterceptExample {
    public static void main(String[] args) {
        try (Playwright playwright = Playwright.create()) {
            // 启动 Chromium 浏览器（无头模式）
            Browser browser = playwright.chromium().launch();
            BrowserContext context = browser.newContext();
            
            // 注册响应拦截回调
            setResponseInterceptor(context);
            
            // 打开页面，触发网络请求
            Page page = context.newPage();
            page.navigate("https://www.baidu.com");
            browser.close();
        }
    }

    private static void setResponseInterceptor(BrowserContext context) {
        context.onResponse(response -> {
            // 打印请求 URL、状态码、资源类型
            System.out.println("请求 URL：" + response.url());
            System.out.println("状态码：" + response.status() + " " + response.statusText());
            System.out.println("资源类型：" + response.request().resourceType() + "\n");
            
            // 只打印 JSON 或文本类型的响应内容
            String contentType = response.headers().get("content-type");
            if (contentType != null && (contentType.contains("application/json") || contentType.contains("text/"))) {
                try {
                    // 读取响应体（字节转字符串）
                    String responseBody = new String(response.body(), StandardCharsets.UTF_8);
                    System.out.println("响应内容：" + responseBody + "\n" + "=".repeat(50) + "\n");
                } catch (Exception e) {
                    System.out.println("无法读取响应体：" + e.getMessage() + "\n");
                }
            } else {
                System.out.println("响应内容：(二进制或大文件，跳过打印)\n" + "=".repeat(50) + "\n");
            }
        });
    }
}

3. 截图并保存（全页面 / 指定区域）

Playwright 支持全页面截图（含滚动区域）、指定元素截图、自定义图片格式和超时时间，适用于自动化测试报告生成：

import com.microsoft.playwright.*;
import java.nio.file.Paths;

public class ScreenshotExample {
    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.zhihu.com");
            
            // 1. 全页面截图（包含滚动部分）
            String fullPagePath = "D:/playwright/full_page_screenshot.png";
            page.screenshot(new Page.ScreenshotOptions()
                .setPath(Paths.get(fullPagePath)) // 保存路径
                .setFullPage(true) // 全页面模式
                .setType(ScreenshotType.PNG) // 图片格式（PNG/JPEG）
                .setTimeout(30000)); // 超时时间（30 秒）
            System.out.println("全页面截图已保存至：" + fullPagePath);
            
            // 2. 指定元素截图（例如知乎搜索框）
            Locator searchInput = page.locator("input[aria-label='搜索']");
            String elementPath = "D:/playwright/element_screenshot.png";
            searchInput.screenshot(new Locator.ScreenshotOptions().setPath(Paths.get(elementPath)));
            System.out.println("元素截图已保存至：" + elementPath);
            
            browser.close();
        }
    }
}

4. 移动端模拟（模拟 iPhone/Android 设备）

通过设置 UserAgent、视口大小、触摸事件等参数，可模拟移动端浏览器行为，适用于移动端网页测试或爬虫：

import com.microsoft.playwright.*;

public class MobileSimulationExample {
    public static void main(String[] args) {
        try (Playwright playwright = Playwright.create()) {
            // 推荐使用 WebKit 模拟 iOS 设备（Safari 浏览器）
            Browser browser = playwright.webkit().launch(new BrowserType.LaunchOptions().setHeadless(false));
            
            // 配置 iPhone 13 的设备参数
            BrowserContext mobileContext = browser.newContext(new Browser.NewContextOptions()
                .setUserAgent("Mozilla/5.0 (iPhone; CPU iPhone OS 14_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/14.0 Mobile/15E148 Safari/604.1")
                .setViewportSize(390, 844) // iPhone 13 分辨率
                .setIsMobile(true) // 标记为移动设备
                .setHasTouch(true) // 启用触摸事件
                .setDeviceScaleFactor(3) // Retina 屏幕 DPR
                .setLocale("zh-CN") // 语言
                .setTimezoneId("Asia/Shanghai")); // 时区;
            
            // 打开移动端页面
            Page mobilePage = mobileContext.newPage();
            mobilePage.navigate("https://m.taobao.com");
            
            // 模拟触摸点击（淘宝搜索框）
            mobilePage.locator("input[placeholder='搜索']").click();
            mobilePage.locator("input[placeholder='搜索']").fill("手机");
            mobilePage.locator("button[type='submit']").click();
            
            // 等待页面加载完成后截图
            mobilePage.waitForLoadState(LoadState.NETWORKIDLE);
            mobilePage.screenshot(new Page.ScreenshotOptions()
                .setPath(Paths.get("D:/playwright/mobile_taobao.png"))
                .setFullPage(true));
            
            browser.close();
        }
    }
}

5. 运行 JS 脚本（操作页面 DOM）

通过 page.evaluate() 方法可执行浏览器端 JavaScript 脚本，实现复杂的 DOM 操作或数据提取，支持 Java 与 JS 的数据序列化传输：

import com.microsoft.playwright.*;

public class JsExecutionExample {
    public static void main(String[] args) {
        try (Playwright playwright = Playwright.create()) {
            Browser browser = playwright.chromium().launch(new BrowserType.LaunchOptions().setHeadless(false));
            Page page = browser.newPage();
            page.navigate("https://www.baidu.com");
            
            // 1. 执行 JS：向百度搜索框输入文本
            Boolean isInputSuccess = (Boolean) page.evaluate("() => {"
                + "const input = document.querySelector('#kw');"
                + "// 百度搜索框 ID"
                + "if (input) {"
                + "input.value = 'Playwright 自动化测试';"
                + "return true;"
                + "}"
                + "return false;"
                + "}");
            
            if (isInputSuccess) {
                System.out.println("JS 输入文本成功");
                
                // 2. 执行 JS：点击搜索按钮
                page.evaluate("() => {"
                    + "const button = document.querySelector('#su');"
                    + "// 百度搜索按钮 ID"
                    + "if (button) button.click();"
                    + "}");
                
                // 等待搜索结果加载，提取结果数量
                page.waitForLoadState(LoadState.NETWORKIDLE);
                String resultCount = (String) page.evaluate("() => {"
                    + "return document.querySelector('.nums_text').innerText;"
                    + "}");
                System.out.println("搜索结果：" + resultCount);
            } else {
                System.out.println("JS 输入文本失败");
            }
            
            browser.close();
        }
    }
}

注意事项：

• 只有可序列化的 JS 值（字符串、数字、布尔、数组、普通对象）能返回给 Java，DOM 元素、函数等复杂对象无法直接返回。
• 执行 JS 时需确保元素已加载，可配合 page.waitForSelector() 或 page.waitForLoadState() 避免报错。

五、总结与进阶建议

1. 框架优势总结

Playwright for Java 作为一款现代化的浏览器自动化框架，完美解决了传统工具在异步加载、网络控制、多端支持等方面的痛点，其 API 设计简洁高效，大幅降低了 Java 开发者的学习和使用成本。无论是爬虫数据采集（尤其是动态渲染页面），还是 Web 自动化测试，它都是极具竞争力的选择。

2. 进阶学习建议

• 官方文档：Playwright for Java 官方指南，包含完整的 API 文档和场景示例。
• 实战拓展：尝试结合 Spring Boot 实现分布式爬虫、集成 TestNG/JUnit 实现自动化测试套件、使用 Docker 容器化部署 Playwright 环境。
• 性能优化：通过 BrowserContext 复用、并行执行任务、关闭不必要的日志等方式提升效率。

总结

Playwright for Java 的出现，为 Java 生态带来了更高效、更强大的浏览器自动化方案。随着框架的持续迭代，其功能和兼容性将不断完善，值得 Java 开发者深入学习和应用。