JavaとPlaywrightを使ったAxe DevTools
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 リファレンスを参照してください。
