メインコンテンツへスキップ

インストール

はじめに​

Playwright は、エンドツーエンドテストのニーズに対応するために特別に作成されました。Playwright は、Chromium、WebKit、Firefox など、すべてのモダンなレンダリングエンジンをサポートしています。Windows、Linux、macOS 上で、ローカルまたは CI で、ヘッドレスまたはヘッドありで、ネイティブのモバイルエミュレーションを使用してテストを実行できます。

Playwright は一連の Maven モジュールとして配布されています。最も簡単な使用方法は、以下に説明するように、プロジェクトの pom.xml に依存関係を1つ追加することです。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.dokyumento.jp");
            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.dokyumento.jp/");
      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 Subsystem for Linux (WSL)。
  • macOS 14 Ventura 以降。
  • Debian 12、Ubuntu 22.04、Ubuntu 24.04 (x86-64 および arm64 アーキテクチャ)。

次のステップ​