Axe DevTools voor Web voor Node.js en Browser-gebaseerd Testen
Overzicht van de Node.js- en JavaScript-integraties beschikbaar met Axe DevTools voor Web
Deze pagina biedt u opties voor Node.js en JavaScript-ontwikkeling met Axe DevTools voor Web. Elke vermelding hieronder noemt het npm-pakket dat het documenteert, zodat u een pakket dat u hebt gezien kunt koppelen aan de bijbehorende handleiding.
Elke hieronder vermelde package levert zijn eigen TypeScript type-verklaringen, dus er is geen apart @types/ package dat geïnstalleerd moet worden en de Axe DevTools API is in beide talen hetzelfde. De handleidingen voor het importeren en schrijven van tests voor elke integratie labelen hun voorbeelden per taal en geven een compleet voorbeeldbestand in zowel JavaScript als TypeScript.
Al deze pakketten worden geïnstalleerd vanuit hetzelfde register. Zie Installeer Axe DevTools voor Web voor Node.js vanuit Deque's Agora voor authenticatie- en installatie-instructies.
Welk pakket je ook kiest, scans worden standaard uitgevoerd tegen WCAG 2.1 Niveau AA, met best practice- en experimentele regels uitgeschakeld. Zie Regels aanpassen om het regelsysteem te wijzigen of best practices in te schakelen.
Integraties met testframeworks
Kies het pakket dat past bij het hulpmiddel dat uw tests al gebruiken. Elke handleiding behandelt installatie, importeren en initialiseren, het schrijven van tests en de volledige API-referentie.
- Browser JavaScript (
@axe-devtools/browser) - Cypress (
@axe-devtools/cypress) - Playwright JavaScript (
@axe-devtools/playwright) - Puppeteer (
@axe-devtools/puppeteer) - WebdriverIO (
@axe-devtools/webdriverio) - WebDriverJS (
@axe-devtools/webdriverjs)
Rapportage en logging
Deze pakketten werken samen met een van de bovenstaande integraties met testframeworks.
- Node Reporter (
@axe-devtools/reporter): genereert rapporten van uw toegankelijkheidsresultaten. - Node Logger (
@axe-devtools/logger): logt toegankelijkheidsresultaten terwijl uw tests worden uitgevoerd.
Andere integraties
Aangepaste elementen en ElementInternals
Vanaf Axe DevTools for Web 4.13.0 lezen scans de ARIA-semantic die webcomponenten in JavaScript verklaren via ElementInternals, in plaats van alleen de role- en aria-*-attributen die aanwezig zijn in de markup. Er is geen configuratie vereist, en dit geldt voor elke integratie op deze pagina. Semantic in de DOM hebben nog steeds voorrang: een expliciet role- of aria-*-attribuut op het element overschrijft de waarde van ElementInternals.
Uw componenten moeten hun internals publiceren om dit te laten werken, en een component die ze in een privéklasseveld opslaat, kan niet worden gelezen. Zie Aangepaste elementen testen die ElementInternals gebruiken.