Importieren und Initialisieren mit Java

Nachdem Sie axe DevTools for Web installiert haben, müssen Sie es in Ihre Testdatei importieren und das Tool zusammen mit seinem Webtreiber initialisieren.

Voraussetzungen

Um axe DevTools for Web zu importieren und zu initialisieren, muss es zuerst installiert werden. Falls noch nicht geschehen, lesen Sie die Anleitung zur Installation aus einem Bundle, aus Ihrem Artefakt-Repository oder von Deques Agora. 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. Je nach Konfiguration können diese Pakete variieren. Deque bietet vier Java-Integrationen:

– Selenium (Tests mit Selenium schreiben und Java Selenium API-Referenz) – Hamcrest (Tests mit Hamcrest schreiben und Hamcrest API-Referenz)

• Cucumber (Tests mit Cucumber schreiben)

– Playwright (Verwendung von Playwright und Playwright-API-Referenz)

Selenium-Konfigurationsimportanweisungen

Befolgen Sie diesen Teil des Handbuchs, um axe DevTools mit Selenium zu verwenden. Verwenden Sie diese Konfiguration, wenn Sie axe DevTools nicht mit einer vorhandenen Assertion-Bibliothek koppeln und stattdessen Ihre eigenen Tests schreiben. Darüber hinaus werden Importanweisungen für den Webtreiber Ihrer Wahl benötigt.

Das einzige Paket, das ausdrücklich importiert werden muss, ist das axe DevTools Selenium-Paket. Dies ist die Kommunikation zwischen axe DevTools und dem Selenium WebDriver, um die Scans auszuführen.

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

Für diese Konfiguration werden zwei weitere Pakete empfohlen, die es Ihnen ermöglichen, Ergebnisse zu generieren und zu interpretieren. Das Ergebnispaket generiert ein JSON-Objekt, das die Scan-Ergebnisse enthält, und das Reporterpaket ermöglicht die Generierung von HTML-, JUnit-XML- oder CSV-Berichten der Scan-Ergebnisse.

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

Hamcrest-Importanweisungen

Für Testumgebungen, die Hamcrest verwenden, 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, den Scanumfang nach Selektoren einzuschränken. 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 koppeln, 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 Playwright-Pakete von Microsoft importieren.

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

Initializing (non-Playwright)

Nachdem die erforderlichen Paketimportanweisungen zu Ihrer Testdatei hinzugefügt wurden, müssen Sie axe DevTools mit seinem WebDriver initialisieren, um Barrierefreiheitsscans auszuführen. Mit der Standardkonfiguration initialisiert dieser Code axe DevTools. Dieses Beispiel verwendet ChromeDriver, aber andere Browsertreiber wie GeckoDriver funktionieren genauso gut.

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

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

AxeSelenium axeSelenium = new AxeSelenium();

Playwright wird initialisiert

Zum Initialisieren von Playwright konstruieren Sie ein neues Playwright -Objekt, verwenden es zum Erstellen eines neuen Browser -Objekts und verwenden schließlich das Browser -Objekt zum Erstellen eines Page -Objekts.

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ächster Schritt

Nachdem Sie axe DevTools installiert, importiert und initialisiert haben, können Sie mit dem Scannen auf Barrierefreiheit und dem Schreiben von Barrierefreiheitstests fortfahren. Lesen Sie dazu die Anleitungen zum Schreiben von Tests mit Selenium, Schreiben von Tests mit Hamcrest, Schreiben von Tests mit Cucumber oder Schreiben von Tests mit Playwright.

Fehlerbehebung

Wenn Sie Probleme beim Importieren oder Initialisieren von axe DevTools haben, wenden Sie sich direkt an Ihren Deque-Vertreter, erreichen Sie uns über unseren Support-Desk oder senden Sie uns eine E-Mail. Wir helfen Ihnen gerne weiter.