Playwright for Java 是微软推出的高性能浏览器自动化框架，相比 Selenium 具有自动等待、网络控制和多端支持等优势。文章介绍了框架背景、核心模块（Browser、Page、Locator 等）及与 Selenium 的差异。通过 Maven 依赖配置、网络请求拦截、截图保存、移动端模拟及 JS 脚本执行等实战代码示例，展示了其在 Java 爬虫和自动化测试中的应用。该框架适合现代 Web 应用的测试与数据采集，支持并行执行和上下文隔离，能有效解决异步加载和动态渲染问题。
在 Java 爬虫与浏览器自动化测试领域，Selenium（WebDriver）长期占据主导地位。但随着前端技术的飞速发展，异步加载、动态渲染等场景日益复杂，传统工具在效率、功能完整性上逐渐显现短板。2021 年 4 月，微软正式推出 Playwright for Java，作为一款跨语言、高性能的浏览器自动化框架，它凭借自动等待、强大的网络控制、多端支持等核心优势，迅速成为 Java 开发者的新宠。本文将从框架介绍、核心差异、模块详解、实战示例等方面，带大家全面掌握 Playwright for Java 的使用。
Playwright 是微软于 2020 年首次发布的开源浏览器自动化框架，其核心引擎基于 Node.js 实现，但在 API 层面提供了多语言支持。其中，Java 版本（playwright-java）于 2021 年 4 月正式发布，补齐了 Java 生态在现代化浏览器自动化领域的短板。
| 语言 | 官方支持 | 发布年份 |
|---|---|---|
| JavaScript / TypeScript | ✅ 原生支持 | 2020.01 |
| Python | ✅ 官方提供 playwright-python | 2020.09 |
| .NET (C#) | ✅ 官方提供 playwright-dotnet | 2021.02 |
| Java | ✅ 官方提供 playwright-java | 2021.04 |
作为 Java 开发者熟知的浏览器自动化工具，WebDriver（Selenium）与 Playwright for Java 在底层设计、功能支持上存在显著差异，具体对比如下：
| 对比维度 | Playwright for Java | WebDriver (Selenium) |
|---|---|---|
| 底层通信机制 | 自研二进制协议（基于 WebSocket/IPC），直接与浏览器通信，延迟低、稳定性高 | 遵循 W3C WebDriver 协议（HTTP/JSON REST API），需依赖浏览器驱动（ChromeDriver、GeckoDriver 等）作为中间层 |
| 浏览器支持 | 支持 Chromium、Firefox、WebKit、移动端；紧跟浏览器新特性，不支持旧版 IE 和原生 Safari | 支持所有主流浏览器（Chrome、Firefox、Safari、Edge、IE 等），对老旧浏览器兼容性更好 |
| 元素等待机制 | 自动等待元素可交互，无需手动处理 | 需通过显式等待（WebDriverWait）或隐式等待（implicitlyWait）处理元素加载 |
| 核心功能支持 | 原生支持网络拦截、响应 Mock、录屏、移动端模拟、多标签页隔离 | 截图需额外处理滚动区域，录屏需集成第三方工具，网络拦截等高级功能需依赖第三方库 |
| 易用性 | API 设计简洁统一，配置简单，学习成本低 | 配置繁琐（需管理驱动版本），API 分散，部分场景需编写大量冗余代码 |
适用场景总结：
Playwright for Java 的 API 设计遵循'分层架构'，核心模块职责清晰，以下是关键模块的作用与核心类：
| 序号 | 模块 | 主要类/接口 | 核心作用 |
|---|---|---|---|
| 1 | Playwright | Playwright | 框架入口，负责启动和关闭 Playwright 实例，是所有操作的基础 |
| 2 | Browser | Browser | 控制浏览器实例（如 Chromium、Firefox、WebKit），可配置无头模式、启动参数等 |
| 3 | BrowserContext | BrowserContext | 浏览器上下文，相当于'隔离的浏览器会话'，每个 Context 拥有独立的 Cookie、LocalStorage，支持多标签页管理 |
| 4 | Page | Page | 单个页面的操作对象，负责导航（navigate）、点击（click）、输入（fill）、截图（screenshot）等核心操作 |
| 5 | Locator | Locator | 页面元素定位器，支持 CSS 选择器、XPath、文本匹配等多种定位方式，自动处理元素动态加载 |
| 6 | Frame | Frame | 处理 iframe 嵌套场景，可通过 frameLocator() 获取嵌套 iframe 中的元素 |
| 7 | JSHandle | JSHandle | 用于操作 JavaScript 对象，实现 Java 与浏览器端 JS 的数据交互 |
| 8 | 网络相关 | Route、APIRequestContext | Route 负责拦截网络请求，APIRequestContext 用于发送 HTTP 请求（无需打开浏览器） |
核心工作流程：
以下是 Playwright for Java 的核心功能实战示例，包含依赖配置、网络拦截、截图、移动端模拟、JS 脚本执行等常用场景。
首先在 pom.xml 中引入 Playwright for Java 依赖（最新版本可从 Maven 中央仓库查询）：
<dependency>
<groupId>com.microsoft.playwright</groupId>
<artifactId>playwright</artifactId>
<version>1.40.0</version>
</dependency>
首次运行时，Playwright 会自动下载对应浏览器的二进制文件（无需手动配置驱动）。
通过 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");
(contentType != && (contentType.contains() || contentType.contains())) {
{
(response.body(), StandardCharsets.UTF_8);
System.out.println( + responseBody + + .repeat() + );
} (Exception e) {
System.out.println( + e.getMessage() + );
}
} {
System.out.println( + .repeat() + );
}
});
}
}
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();
;
searchInput.screenshot( .ScreenshotOptions().setPath(Paths.get(elementPath)));
System.out.println( + elementPath);
browser.close();
}
}
}
通过设置 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();
mobilePage.locator().click();
mobilePage.locator().fill();
mobilePage.locator().click();
mobilePage.waitForLoadState(LoadState.NETWORKIDLE);
mobilePage.screenshot( .ScreenshotOptions()
.setPath(Paths.get())
.setFullPage());
browser.close();
}
}
}
通过 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) page.evaluate(
+
+ );
System.out.println( + resultCount);
} {
System.out.println();
}
browser.close();
}
}
}
注意事项：
Playwright for Java 作为一款现代化的浏览器自动化框架，完美解决了传统工具在异步加载、网络控制、多端支持等方面的痛点，其 API 设计简洁高效，大幅降低了 Java 开发者的学习和使用成本。无论是爬虫数据采集（尤其是动态渲染页面），还是 Web 自动化测试，它都是极具竞争力的选择。
Playwright for Java 的出现，为 Java 生态带来了更高效、更强大的浏览器自动化方案。随着框架的持续迭代，其功能和兼容性将不断完善，值得 Java 开发者深入学习和应用。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online