Importieren und Initialisieren mit Java

Nachdem Sie Axe DevTools für das Web installiert haben, müssen Sie es in Ihre Testdatei importieren und das Tool zusammen mit seinem Webdriver initialisieren.

Voraussetzungen

Um Axe DevTools für das Web zu importieren und zu initialisieren, muss es zuerst installiert werden. Wenn Sie dies noch nicht getan haben, lesen Sie den Leitfaden darüber, wie Sie es aus einem Bundle, aus Ihrem Artefakt-Repository oder aus Deques Agora installieren. Sie benötigen außerdem einen heruntergeladenen und konfigurierten Selenium-WebDriver Ihrer Wahl.

Importieren

Um Axe DevTools zu verwenden, müssen mehrere Pakete importiert werden. Abhängig von Ihrer Konfiguration können diese Pakete variieren. Deque bietet vier Java-Integrationen an:

• Selenium (Tests schreiben mit Selenium und Java Selenium API-Referenz)
• Hamcrest (Tests schreiben mit Hamcrest und Hamcrest API-Referenz)
• Cucumber (Tests schreiben mit Cucumber)
• Playwright (Verwendung von Playwright und Playwright API-Referenz)

Selenium-Konfigurationsimportanweisungen

Um Axe DevTools mit Selenium zu verwenden, folgen Sie diesem Teil des Leitfadens. Verwenden Sie diese Konfiguration, wenn Sie Axe DevTools nicht mit einer bestehenden Assertionsbibliothek koppeln und stattdessen Ihre eigenen Tests schreiben. Zusätzlich werden Importanweisungen für den Webdriver Ihrer Wahl erforderlich sein.

Das einzige Paket, das explizit importiert werden muss, ist das Axe DevTools Selenium-Paket. Dieses kommuniziert zwischen Axe DevTools und dem Selenium-WebDriver, um die Scans durchzuführen.

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

Für diese Konfiguration werden zwei weitere Pakete empfohlen, um Ergebnisse zu generieren und zu interpretieren. Das Ergebnisse-Paket erzeugt ein JSON-Objekt, das die Scanergebnisse enthält, und das Reporter-Paket ermöglicht die Erstellung von Berichten in HTML, JUnit XML oder CSV über die Scanergebnisse.

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

Hamcrest-Importanweisungen

Für Testumgebungen, die Hamcrest nutzen, müssen nur zwei Pakete importiert werden. Das erste Paket enthält alles, was für Standardscans benötigt wird.

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

Das zweite Paket fügt die Möglichkeit hinzu, die Scans mittels Selektoren zu begrenzen. Um diese Funktionalität zu nutzen, ist der zusätzliche Import dieses Pakets erforderlich.

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

Cucumber-Importanweisungen

Um Axe DevTools mit Cucumber zu kombinieren, ist nur ein Importpaket erforderlich.

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

Playwright-Importanweisungen

Sie müssen zwei Pakete importieren, um die Playwright-Integration zu verwenden.

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

Sie müssen auch die Microsoft Playwright-Pakete importieren.

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

Initialisierung (nicht-Playwright)

Nachdem die erforderlichen Paketimportanweisungen in Ihre Testdatei hinzugefügt wurden, müssen Sie Axe DevTools mit seinem Webdriver initialisieren, um Barrierefreiheitsscans durchzuführen. Mit der Standardkonfiguration wird dieser Code Axe DevTools initialisieren. Dieses Beispiel verwendet ChromeDriver, aber auch andere Browser-Driver wie GeckoDriver funktionieren genauso gut.

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

Wenn Sie zudem ein erzeugtes Ergebnisobjekt und/oder einen Bericht benötigen, muss ein Axe Selenium-Objekt, wie oben beschrieben, importiert und initialisiert werden.

AxeSelenium axeSelenium = new AxeSelenium();

Initialisierung Playwright

Um Playwright zu initialisieren, konstruieren Sie ein neues Playwright-Objekt, verwenden es, um ein neues Browser-Objekt zu erstellen, und verwenden schließlich das Browser-Objekt, um ein Seite-Objekt zu erstellen.

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

Nächste Schritte

Nachdem Sie Axe DevTools installiert, importiert und initialisiert haben, sind Sie bereit, mit dem Scannen zur Barrierefreiheit und dem Schreiben von Barrierefreiheitstests fortzufahren. Um dies zu tun, lesen Sie den Leitfaden zu Tests schreiben mit Selenium, Tests schreiben mit Hamcrest, Tests schreiben mit Cucumber oder Tests schreiben mit Playwright.

Fehlerbehebung

Wenn Sie Probleme mit dem Importieren oder Initialisieren von Axe DevTools haben, kontaktieren Sie direkt Ihren Deque-Ansprechpartner, erreichen Sie uns über unser Support-Team oder senden Sie uns eine E-Mail. Wir helfen Ihnen gerne weiter.