Importeren en Initialiseren met Java

Zodra je Axe DevTools voor Web hebt geïnstalleerd, moet je het importeren in je testbestand en het hulpmiddel initialiseren in combinatie met de webdriver.

Vereisten

Om Axe DevTools voor Web te importeren en initialiseren, moet het eerst geïnstalleerd zijn. Als je dat nog niet hebt gedaan, lees dan de gids over hoe je het installeert uit een bundel, uit je artefactrepository, of uit Deque's Agora. Je hebt ook een gedownloade en geconfigureerde Selenium WebDriver naar keuze nodig.

Importeren

Om Axe DevTools te gebruiken, moeten er verschillende pakketten worden geïmporteerd. Afhankelijk van je configuratie kunnen deze pakketten variëren. Deque biedt vier Java-integraties:

• Selenium (Tests schrijven met Selenium en Java Selenium API-referentie)
• Hamcrest (Tests schrijven met Hamcrest en Hamcrest API-referentie)
• Cucumber (Tests schrijven met Cucumber)
• Playwright (Gebruik van Playwright en Playwright API-referentie)

Selenium-configuratie Importstatements

Om Axe DevTools met Selenium te gebruiken, volg je dit deel van de gids. Gebruik deze configuratie als je Axe DevTools niet combineert met een bestaande assertiebibliotheek en in plaats daarvan je eigen tests schrijft. Daarnaast zijn importstatements vereist voor de webdriver van je keuze.

Het enige pakket dat expliciet moet worden geïmporteerd, is het Axe DevTools Selenium-pakket. Dit is wat communiceert tussen Axe DevTools en de Selenium WebDriver om de scans uit te voeren.

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

Voor deze configuratie worden twee extra pakketten aanbevolen waarmee je resultaten kunt genereren en interpreteren. Het resultaatspakket genereert een JSON-object met de scanresultaten, en het rapporterpakket stelt je in staat om HTML-, JUnit XML- of CSV-rapporten van de scanresultaten te genereren.

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

Hamcrest Importstatements

Voor testomgevingen die gebruikmaken van Hamcrest, hoeven er maar twee pakketten worden geïmporteerd. Het eerste pakket bevat alles wat nodig is voor standaardscans.

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

Het tweede pakket voegt de mogelijkheid toe om de scans te beperken op basis van selectors. Om deze functionaliteit te gebruiken, is de aanvullende import van dit pakket vereist.

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

Cucumber Importstatements

Om Axe DevTools met Cucumber te combineren, is slechts één importpakket vereist.

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

Playwright Importstatements

Je moet twee pakketten importeren om de Playwright-integratie te gebruiken.

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

Je moet ook de Microsoft Playwright-pakketten importeren.

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

Initialiseren (niet-Playwright)

Nadat de vereiste importstatements aan je testbestand zijn toegevoegd, moet je Axe DevTools initialiseren met zijn web driver om toegankelijkheidsscans uit te voeren. Met behulp van de standaardconfiguratie zal deze code Axe DevTools initialiseren. Dit voorbeeld gebruikt ChromeDriver, maar andere browserdrivers zoals GeckoDriver werken net zo goed.

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

Daarnaast, als je een gegenereerd resultatenobject en/of een rapport nodig hebt, moet een axe Selenium-object zoals hierboven beschreven worden geïmporteerd en geïnitialiseerd.

AxeSelenium axeSelenium = new AxeSelenium();

Initialiseren Playwright

Om Playwright te initialiseren, construeer je een nieuw Playwright-object, gebruik je het om een nieuw Browser-object te maken, en gebruik je ten slotte het Browser-object om een Pagina-object te maken.

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

Volgende Stappen

Zodra je Axe DevTools hebt geïnstalleerd, geïmporteerd en geïnitialiseerd, ben je klaar om verder te gaan met het scannen op toegankelijkheid en het schrijven van toegankelijkheidstests. Om dat te doen, zie de gids over tests schrijven met Selenium, tests schrijven met Hamcrest, tests schrijven met Cucumber, of tests schrijven met Playwright.

Probleemoplossing

Als je problemen hebt met het importeren of initialiseren van Axe DevTools, neem dan rechtstreeks contact op met je Deque-vertegenwoordiger, bereik ons via onze ondersteuningsdesk of stuur ons een e-mail. We helpen je graag.