Skip to main content

安裝

簡介​

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 的瀏覽器二進位檔。要修改此行為，請參見安裝參數。

第一個腳本​

在我們的第一個程式碼中，我們將導航到 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 以無頭模式執行瀏覽器。要查看瀏覽器 UI，啟動瀏覽器時傳遞 setHeadless(false) 旗標。你也可以使用 slowMo 來減慢執行速度。了解更多在偵錯工具部分。

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 Subsystem for Linux (WSL)。
  • macOS 13 Ventura 或 macOS 14 Sonoma。
  • Debian 11、Debian 12、Ubuntu 20.04 或 Ubuntu 22.04、Ubuntu 24.04，在 x86-64 和 arm64 架構上。

接下來是什麼​