Javaを使用したインポートと初期化

Axe DevTools for Webをインストールしたら、それをテストファイルにインポートし、webdriverと連動してツールを初期化する必要があります。

前提条件

Axe DevTools for Webをインポートおよび初期化するには、まずそれをインストールする必要があります。まだインストールしていない場合は、バンドルから、アーティファクトリポジトリから、またはDequeのAgoraからのガイドを参照してください。また、任意のSelenium WebDriverをダウンロードして設定する必要があります。

インポート

Axe DevToolsを使用するためには、いくつかのパッケージをインポートする必要があります。あなたの設定に応じて、これらのパッケージは異なる場合があります。Dequeは4つのJava統合を提供しています：

• Selenium（Seleniumを使用したテストの作成とJava Selenium APIリファレンス）
• Hamcrest（Hamcrestを使用したテストの作成とHamcrest APIリファレンス）
• Cucumber（Cucumberを使用したテストの作成）
• Playwright（Playwrightの使用とPlaywright APIリファレンス）

Selenium構成インポート文

Axe DevToolsをSeleniumと一緒に使用するには、このガイドの該当部分を参照してください。Axe DevToolsを既存のアサーションライブラリと組み合わせず、自分のテストを書く場合、この設定を使用します。また、選択したwebdriverのインポート文も必要です。

明示的にインポートを必要とする唯一のパッケージは、Axe DevTools Seleniumパッケージです。これがAxe DevToolsとSelenium WebDriverとの間でスキャンを実行するための通信を行います。

import com.deque.html.axedevtools.selenium.*;

この設定では、結果を生成し解釈するためにもう2つのパッケージをインポートすることが推奨されます。結果パッケージは、スキャン結果を含むJSONオブジェクトを生成し、レポーターパッケージは、スキャン結果のHTML、JUnit XML、またはCSVレポートの生成を可能にします。

import com.deque.html.axedevtools.selenium.results.*;
import com.deque.html.axedevtools.selenium.reporter.*;

Hamcrestインポート文

Hamcrestを利用するテスト環境のためには、インポートすべきパッケージは2つだけです。最初のパッケージは標準スキャンに必要なすべてを含んでいます。

import com.deque.html.axedevtools.matchers.*;

2つ目のパッケージは、セレクタによってスキャンの範囲を限定する機能を追加します。この機能を使用するには、このパッケージの追加インポートが必要です。

import com.deque.html.axedevtools.matchers.selectors;

Cucumberインポート文

Axe DevToolsをCucumberと組み合わせるには、1つのインポートパッケージだけが必要です。

import com.deque.html.axedevtools.cucumber.*;

Playwrightインポート文

Playwrightインテグレーションを使用するには2つのパッケージをインポートする必要があります。

import com.deque.html.maven.axedevtools.playwright.AxePlaywrightBuilder;
import com.deque.html.maven.axedevtools.utility.axeresults.AxeResults; 

また、MicrosoftのPlaywrightパッケージもインポートする必要があります。

import com.microsoft.playwright.Browser;
import com.microsoft.playwright.BrowserType;
import com.microsoft.playwright.Page;
import com.microsoft.playwright.Playwright;

初期化（非Playwright）

テストファイルに必要なパッケージのインポート文を追加した後、Axe DevToolsをwebドライバーと一緒に初期化してアクセシビリティスキャンを実行する必要があります。標準構成を使用して、このコードはAxe DevToolsを初期化します。この例ではChromeDriverを使用していますが、GeckoDriverなど他のブラウザドライバーも同様にうまく動作します。

WebDriver webdriver = new ChromeDriver();
AxeDriver axedriver = new AxeDriver(webdriver);

さらに、生成された結果オブジェクトやレポートが必要な場合は、上記のように、axe Seleniumオブジェクトをインポートして初期化する必要があります。

AxeSelenium axeSelenium = new AxeSelenium();

Playwrightを初期化

Playwrightを初期化するには、新しいPlaywrightオブジェクトを構築し、それを使用して新しいブラウザーオブジェクトを作成し、最後にブラウザーオブジェクトを使用してページオブジェクトを作成します。

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/");

次のステップ

Axe DevToolsのインストール、インポート、および初期化が完了したら、アクセシビリティのスキャンとアクセシビリティテストの作成に進む準備が整いました。そのためには、Seleniumを使用したテストの作成、Hamcrestを使用したテストの作成、Cucumberを使用したテストの作成、またはPlaywrightを使用したテストの作成のガイドを参照してください。

トラブルシューティング

Axe DevTools のインポートや初期化に問題がある場合は、Deque の担当者に直接連絡するか、サポートデスク または メールを送るでお問い合わせください。喜んでお手伝いします。