Aan de slag met Axe Watcher
Hoe Axe Watcher te gebruiken met je testsuites
Deze gids leidt je door het instellen van Axe Watcher om geautomatiseerde toegankelijkheidstests toe te voegen aan je bestaande end-to-end testsuite.
Watcher en Axe Developer Hub begrijpen
Axe Watcher is een invoerbron voor Axe Developer Hub die je integreert in je testsuite, terwijl Axe Developer Hub het webplatform is waar je je toegankelijkheidsresultaten bekijkt en beheert. Samen vormen ze een complete oplossing voor toegankelijkheidstests:
Axe Watcher wordt uitgevoerd met je geautomatiseerde tests en analyseert elke pagina die je tests bezoeken op toegankelijkheidsproblemen. Het detecteert veranderingen in de DOM en legt meerdere paginastaten vast, waardoor het ideaal is voor het testen van dynamische inhoud zoals single-page applicaties, inlogstromen en interactieve componenten. Wanneer geïntegreerd met Git, koppelt Watcher resultaten aan specifieke commits en branches.
Axe Developer Hub ontvangt toegankelijkheidsresultaten van invoerbronnen zoals Watcher en presenteert ze in een georganiseerde interface. Je kunt toegankelijkheidsproblemen volgen over commits, branches vergelijken, filteren op ernst en de voortgang van de toegankelijkheid van je project in de loop der tijd monitoren. Het platform elimineert duplicaten van problemen, zodat je elk uniek probleem slechts één keer ziet.
Installatiestappen
Deze stappen veronderstellen dat je een Axe-account hebt en toegang tot een Axe Developer Hub-abonnement.
Voor hulp met je Axe-account of Axe Developer Hub-abonnement, neem direct contact op met je Deque-vertegenwoordiger, neem contact op via onze ondersteuningsdesk, of mail ons.
1. Maak een Watcher Project
Een project in Axe Developer Hub bevat je toegankelijkheidsresultaten, testinformatie en Git-gegevens. Elk project heeft een unieke project-ID die je testlopen eraan koppelt.
Om een project te maken:
- Bezoek de Axe Developer Hub-opstartpagina of klik Voeg nieuw project toe vanaf je Projectenpagina.
- Kies Axe Watcher van de Kies je integratiemethode pagina.
- Geef je project een naam.
- Selecteer je programmeertaal.
- Kies je browserautomatiseringsplatform.
Voor volledige instructies, zie Projecten instellen.
2. Wijzig je testsuite
Het integreren van Watcher vereist minimale wijzigingen in je bestaande tests. Het algemene proces omvat:
- De Watcher-pakket installeren
- De configuratiefuncties en controllerklassen importeren
- Je browserconfiguratie omwikkelen met de config-functie van Watcher
- Je browser- of paginainstantie omwikkelen met Watcher
- Je resultaten na elke test wissen om resultaten naar Axe Developer Hub te sturen
De specifieke implementatie varieert per platform. Kies je taal uit de onderstaande links om naar instructies te worden geleid die specifiek zijn voor je browserautomatiseringsplatform:
Als je geen bestaande testsuite hebt om te wijzigen, biedt de Axe Watcher Voorbeelden repository werkende voorbeelden voor elk ondersteund platform.
3. Voer je tests uit en controleer de resultaten
Zodra je je testsuite hebt aangepast, voer je deze uit zoals je normaal zou doen. Watcher analyseert automatisch pagina's en stuurt resultaten naar Axe Developer Hub.
Nadat de testrun is voltooid, bezoek je je project in Axe Developer Hub om de resultaten te bekijken. Je ziet:
- Branches pagina (Git-projecten): Toont alle gescande branches met toegankelijkheidssamenvattingen.
- Commits pagina (Git-projecten): Toont commits binnen een branch met vergelijkingsgegevens.
- Testrunspagina (niet-Git-projecten): Toont elke testrun met tijdstempels en aantal problemen.
- Overzichtspagina: Toont alle geschonden toegankelijkheidsregels met aantallen problemen per impact.
- Detailpagina: Biedt gedetailleerde informatie over elke schending, inclusief de locatie van het element, broncode en aanwijzingen voor herstel.
Voor richtlijnen over het navigeren door uw resultaten, zie Resultaten begrijpen.
Volgende stappen
- Automatiseer toegankelijkheidscontroles in CI/CD: Gebruik de GitHub-actie om pull-aanvragen met toegankelijkheidsfouten te blokkeren, of integreer met andere platforms met behulp van de REST-service
- Pas uw test aan: Leer over handmatige modus om te bepalen welke pagina's worden geanalyseerd
- Stel drempels in: Stel de a11y-drempel in om de tolerantie van uw organisatie voor toegankelijkheidsfouten te definiëren
- Gebruik een globale configuratie: Pas consistente toegankelijkheidsnormen toe in uw organisatie