跳至主要内容

安装

简介​

Playwright是专门为满足端到端测试需求而创建的。Playwright支持所有现代渲染引擎，包括Chromium、WebKit和Firefox。可以在Windows、Linux和macOS上进行测试，本地或CI环境，无头模式或有头模式，并支持原生移动设备模拟。

Playwright 以一组 Maven 模块的形式分发。使用它的最简单方法是按照以下描述在项目的 pom.xml 中添加一个依赖项。如果您不熟悉 Maven，请参考其 文档。

使用方法​

开始使用Playwright，安装并运行示例文件以查看实际效果。

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("http://playwright.dev");
            System.out.println(page.title());
        }
    }
}

使用上面的Example.java和pom.xml文件，按以下方式编译并执行您的新程序：

mvn compile exec:java -D exec.mainClass="org.example.App"

运行它会下载Playwright包并安装Chromium、Firefox和WebKit的浏览器二进制文件。要修改此行为，请参阅installation parameters。

第一个脚本​

在我们的第一个脚本中，我们将导航到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 13 Ventura 或更高版本。
  • Debian 12、Ubuntu 22.04、Ubuntu 24.04，支持x86-64和arm64架构。

下一步​