Installatie

Axe Watcher integreert toegankelijkheidstesten in je bestaande end-to-end testsuites. Deze handleiding behandelt de installatie voor zowel de JavaScript/TypeScript als de Java-versies van het pakket.

Systeemvereisten

Voordat je Axe Watcher installeert, zorg ervoor dat je omgeving aan deze vereisten voldoet:

• Taalondersteuning: Je tests moeten geschreven zijn in JavaScript, TypeScript of Java.

• Node.js (alleen JavaScript/TypeScript): Gebruik een momenteel ondersteunde Long Term Support (LTS) versie van Node.js.

• Java (alleen Java): Gebruik een momenteel ondersteunde LTS-versie van Java.

• Browser-automatiseringsplatformversies: Axe Watcher ondersteunt de laatste versie of de vorige hoofdversie van elk ondersteund platform (behalve voor Playwright en Playwright Test, die de vorige minore versie en later ondersteunen).

• Browser: Watcher gebruikt de nieuwste stabiele versie van Chrome voor Testing of Chromium (met JavaScript/TypeScript of Java met Playwright, kun je ook Microsoft Edge gebruiken). Let op dat Cypress' ingebouwde Electron-browser niet compatibel is met Watcher, en dat je Cypress moet aanroepen met cypress run --browser chrome-for-testing --headless, cypress run --browser chromium --headless of cypress run --browser edge --headless.

• Toegang tot npm-register (alleen JavaScript/TypeScript): Je omgeving moet toestemming hebben om pakketten te downloaden en installeren van Het npm-register.

• Toegang tot Maven Central-repository (alleen Java): Je omgeving moet toestemming hebben om pakketten te downloaden en installeren van Maven Central.

• Git-repository (optioneel maar aanbevolen): Met Git kun je toegankelijkheidsresultaten koppelen aan specifieke commits en de toegankelijkheidsvoortgang van je project in de loop der tijd monitoren.

JavaScript- en TypeScript-installatie

Het @axe-core/watcher-pakket is beschikbaar op npm. Installeer het op het hoofdniveau van je testmap met behulp van je favoriete pakketbeheerder:

npm install --save-dev @axe-core/watcher

Of met yarn:

yarn add --dev @axe-core/watcher

Of met pnpm:

pnpm add --save-dev @axe-core/watcher

Ondersteunde platforms

Het JavaScript/TypeScript-pakket ondersteunt deze browser-automatiseringsplatforms (huidige versie en één hoofdversie terug):

• Cypress (inclusief componenttesten)
• Playwright (vorige minore versie en later worden ondersteund)
• Playwright Test (vorige minore versie en later worden ondersteund)
• Puppeteer
• WebdriverIO
• WebdriverIO Testrunner
• WebDriverJS (Selenium)

Na de installatie, volg de JavaScript of TypeScript framework-specifieke instructies in de Axe Watcher-documentatie om je testsuite te configureren.

Java-installatie

Het Java Watcher-pakket is beschikbaar op Maven Central. Voeg de afhankelijkheid toe aan je pom.xml:

<dependencies>
  <dependency>
    <groupId>com.deque.axe_core</groupId>
    <artifactId>watcher</artifactId>
    <version>4.0.0</version>
  </dependency>
</dependencies>

Werk het versienummer bij indien nodig om de laatste release te gebruiken. Meer informatie over de beschikbare versies van het pakket vind je op Maven Central.

Ondersteunde platforms

Het Java-pakket ondersteunt Selenium WebDriver (de huidige versie en de vorige hoofdversie).

Volgende stappen

Zodra je het pakket hebt geïnstalleerd, moet je:

1. Maak een project aan in Axe Developer Hub om je project-ID te verkrijgen
2. Pas je testsuite aan volgens de instructies voor je specifieke testframework
3. Stel je ACCESSIBILITY_API_KEY en PROJECT_ID in als omgevingsvariabelen
4. Voer je tests uit en bekijk de resultaten in Axe Developer Hub

Voor gedetailleerde installatie-instructies die specifiek zijn voor je testframework, zie de documentatiepagina's specifiek voor het framework.