跳到主要內容

安裝

簡介​

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.dev.org.tw");
            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.org.tw/");
      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+ 或 Linux 的 Windows 子系統 (WSL)。
  • macOS 13 Ventura 或更高版本。
  • Debian 12、Ubuntu 22.04、Ubuntu 24.04，在 x86-64 和 arm64 架構上。

下一步​