JavaとPlaywrightを使ったAxe DevTools

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

PlaywrightとAxe DevTools for Webを使用したJavaでのアクセシビリティテストのセットアップと記述

Not for use with personal data

Axe DevToolsのためのPlaywright Javaのチェイン可能なAPI統合。

必要条件

  • Playwright。詳細については、システム要件を参照してください
  • Java 8以上。

セットアップ

DequeからPlaywrightの統合を取得する方法については、インストールガイドを参照してください。

まだ追加していない場合は、Playwright Javaをpom.xmlに追加します:

<!-- Latest Version: https://mvnrepository.com/artifact/com.microsoft.playwright/playwright -->
<dependency>
    <groupId>com.microsoft.playwright</groupId>
    <artifactId>playwright</artifactId>
    <version>1.17.1</version>
</dependency>

@axe-core-maven-playwright依存関係をpom.xmlに追加します:

<dependency>
    <groupId>com.deque.html.axe-devtools</groupId>
    <artifactId>playwright</artifactId>
    <version>4.4.0</version>
</dependency>

ローカル開発

初めてインストールする場合は、次を使用してください:

mvn clean install

テストを実行するには:

mvn test -q

個別のテストを実行するには:

// -Dtest=<class>#<function> example:
mvn test -Dtest=PlaywrightJavaTest#shouldReturnAxeResults

以下は、Playwrightをセットアップし、ページのアクセシビリティエラーをチェックするための最小限の例です:

import com.deque.html.maven.axedevtools.playwright.AxePlaywrightBuilder;
import com.deque.html.maven.axedevtools.utility.axeresults.AxeResults;
import com.microsoft.playwright.Browser;
import com.microsoft.playwright.BrowserType;
import com.microsoft.playwright.Page;
import com.microsoft.playwright.Playwright;
import org.junit.Test;

public class MyPlaywrightTestSuite {

    @Test
    public void testMyWebPage() {
        Playwright playwright = Playwright.create();
        Browser browser = playwright.chromium()
                .launch(new BrowserType.LaunchOptions().setHeadless(true));
        Page page = browser.newPage();
        page.navigate("https://dequeuniversity.com/demo/mars/");

        AxePlaywrightBuilder axePlaywrightBuilder = new AxePlaywrightBuilder(page);

        try {
            AxeResults axeResults = axePlaywrightBuilder.analyze();
           // Do something with axeResults
        } catch (RuntimeException e) {
            // Do something with the error
        }
    }
}

次のステップ

この統合のAPIに関する詳細については、Playwright API リファレンスを参照してください。