安装
简介
Playwright 专为满足端到端测试的需求而创建。Playwright 支持所有现代渲染引擎,包括 Chromium、WebKit 和 Firefox。可在 Windows、Linux 和 macOS 上进行本地或持续集成(CI)测试,支持无头模式或有头模式,并具备原生移动设备模拟功能。
Playwright 以一组 Maven 模块的形式发布。使用它的最简单方法是按照以下说明在项目的 pom.xml
中添加一个依赖项。如果您不熟悉 Maven,请参考其 文档。
用法
开始使用时,先安装 Playwright 并运行示例文件,以查看其实际运行效果。
- App.java
- pom.xml
src/main/java/org/example/App.java
package org.example;
import com.microsoft.playwright.*;
public class App {
public static void main(String[] args) {
try (Playwright playwright = Playwright.create()) {
Browser browser = playwright.chromium().launch();
Page page = browser.newPage();
page.navigate("https://playwright.dev");
System.out.println(page.title());
}
}
}
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>org.example</groupId>
<artifactId>examples</artifactId>
<version>0.1-SNAPSHOT</version>
<name>Playwright Client Examples</name>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<dependencies>
<dependency>
<groupId>com.microsoft.playwright</groupId>
<artifactId>playwright</artifactId>
<version>1.52.0</version>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.10.1</version>
<!-- 对接口静态方法的引用仅在源级别 1.8 或更高版本中允许 -->
<configuration>
<source>1.8</source>
<target>1.8</target>
</configuration>
</plugin>
</plugins>
</build>
</project>
有了上述 Example.java
和 pom.xml
,按以下步骤编译并执行新程序:
mvn compile exec:java -D exec.mainClass="org.example.App"
运行该命令会下载 Playwright 包,并为 Chromium、Firefox 和 WebKit 安装浏览器二进制文件。若要修改此行为,请参阅 安装参数。
第一个脚本
在我们的第一个脚本中,我们将导航到 playwright.dev
并在 WebKit 中截取屏幕截图。
package org.example;
import com.microsoft.playwright.*;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
try (Playwright playwright = Playwright.create()) {
Browser browser = playwright.webkit().launch();
Page page = browser.newPage();
page.navigate("https://playwright.dev/");
page.screenshot(new Page.ScreenshotOptions().setPath(Paths.get("example.png")));
}
}
}
默认情况下,Playwright 以无头模式运行浏览器。若要查看浏览器用户界面,请将 setHeadless 选项设置为 false
。你还可以使用 setSlowMo 来减慢执行速度。在调试工具 章节 中了解更多信息。
playwright.firefox().launch(new BrowserType.LaunchOptions().setHeadless(false).setSlowMo(50));
运行示例脚本
mvn compile exec:java -D exec.mainClass="org.example.App"
默认情况下,使用 Playwright 启动的浏览器以无头模式运行,这意味着运行脚本时不会打开浏览器用户界面。若要更改此设置,可以在启动浏览器时传递 new BrowserType.LaunchOptions().setHeadless(false)
。
系统要求
- Java 8 或更高版本。
- Windows 10 及以上版本、Windows Server 2016 及以上版本或适用于 Linux 的 Windows 子系统 (WSL)。
- macOS 14 Ventura 或更高版本。
- Debian 12、Ubuntu 22.04、Ubuntu 24.04,x86-64 和 arm64 架构。