Java と Playwright の手順

This page is not available in the language you requested. You have been redirected to the English version of the page.

Link to this page copied to clipboard

Java と Playwright でテストを設定する

Not for use with personal data

Java Watcher パッケージの新しい依存関係を pom.xml（Maven 用）依存関係セクションに追加します（Java Watcher パッケージは Maven Central で利用可能です）。

<dependencies>

<!-- Add this dependency: -->
  <dependency>
     <groupId>com.deque.axe_core</groupId>
     <artifactId>watcher</artifactId>
     <version>4.4.0</version> <!-- Update this as needed -->
  </dependency>

</dependencies>

Java Watcher のインポートをテストコードに追加します。

import com.deque.axe_core.commons.AxeWatcherOptions;
import com.deque.axe_core.playwright.AxeWatcherPlaywright;
import com.deque.axe_core.playwright.AxeWatcherPage;

個人の API キーとプロジェクト ID（どちらもセキュリティと柔軟性のために環境に保存されています）を含む Java Watcher のセットアップコードを追加します。
```
AxeWatcherOptions options =
    new AxeWatcherOptions()
        .setApiKey(System.getenv("ACCESSIBILITY_API_KEY"))
        .setProjectId(System.getenv("PROJECT_ID"));
// Optional: uncomment and set SERVER_URL if using a regional, private cloud, or on-premises instance:
// options.setServerUrl(System.getenv("SERVER_URL"));
AxeWatcherPlaywright watcher = new AxeWatcherPlaywright(options);
BrowserType.LaunchPersistentContextOptions launchOptions =
    watcher.configure(new BrowserType.LaunchPersistentContextOptions());
// Watcher requires a persistent context. You must set headless explicitly on Playwright 1.49+:
launchOptions.setHeadless(false);
BrowserContext context = browserType.launchPersistentContext(userDataDir, launchOptions);
AxeWatcherPage page = watcher.wrapPage(context.newPage());
```
important

Watcher には Playwright 永続的コンテキスト が必要です。非永続的なBrowserランチとは互換性がありません。Playwright Java 1.49 以降では、setHeadless(false)（または setChannel("chrome") や setChannel("chromium") を使用したsetHeadless(true)）を明示的に呼び出す必要があります。デフォルトのchromium-headless-shellモードはサポートされていません。

このコードスニペットは、アクセシビリティテストを有効にした状態で Playwright Page をラップするAxeWatcherPageインスタンスを作成します。

違反が見つかった場合にスクリーンショットをキャプチャするには、AxeWatcherOptionsに.setTakeScreenshots(true)を追加します。また、スクリーンショットをローカルに保存するには、.setScreenshotDir("./axe-screenshots")をチェーンします。詳細については違反スクリーンショットのキャプチャを参照してください。

ACCESSIBILITY_API_KEY と PROJECT_ID を環境に設定し、個人用 API キー（Axe アカウントの**API KEYS**タブで見つかります）とプロジェクト ID（プロジェクトを作成した際にこれらの指示の上部に表示されるか、プロジェクトページで**プロジェクトを設定**を選択して**設定**から入手できます）を使用してください。組織が地域のプライベートクラウドやオンプレミスの Axe Developer Hub インスタンスを使用している場合は、そのインスタンスのベース URL をSERVER_URLに設定してください（例: https://axe-eu.deque.com）。それ以外の場合、SERVER_URLを省略し、デフォルトのhttps://axe.deque.comが使用されます。
テストセッションの終了時にflush()を呼び出します。
```
page.axeWatcher().flush();
```
flush()を呼び出すことでテストランが終了したことを示し、結果をユーザーに処理・提示することができます。

違反を特定のテストに関連付けるには、テストロジックの前にsetTestContext()を呼び出します。
```
page.axeWatcher().setTestContext(
    "src/test/java/com/acme/LoginTest.java",
    java.util.Arrays.asList("LoginTest", "rejects bad password")
);
```
詳細についてはテストへの違反の帰属を参照してください。

Java と Playwright の手順

Is this page helpful?

Help us improve this page

Still need help?