跳至主要内容

安装

简介​

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

使用上面的 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.net.cn/");
      page.screenshot(new Page.ScreenshotOptions().setPath(Paths.get("example.png")));
    }
  }
}

默认情况下，Playwright 以无头模式运行浏览器。要查看浏览器 UI，请将 setHeadless 选项设置为 false。您还可以使用 setSlowMo 来减慢执行速度。在调试工具的 部分 中了解更多信息。

playwright.firefox().launch(new BrowserType.LaunchOptions().setHeadless(false).setSlowMo(50));

运行示例脚本​

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

默认情况下，使用 Playwright 启动的浏览器以无头模式运行，这意味着在运行脚本时不会打开任何浏览器 UI。要更改此设置，您可以在启动浏览器时传递 new BrowserType.LaunchOptions().setHeadless(false)。

系统要求​

  • Java 8 或更高版本。
  • Windows 10+、Windows Server 2016+ 或 Windows 子系统 Linux (WSL)。
  • macOS 13 Ventura 或 macOS 14 Sonoma。
  • Debian 11、Debian 12、Ubuntu 20.04 或 Ubuntu 22.04、Ubuntu 24.04，在 x86-64 和 arm64 架构上。

后续步骤​