Geautomatiseerd toegankelijkheidstesten met axe-core en WCAG.
Bij geautomatiseerd toegankelijkheidstesten in Nexus StudioQA controleert axe-core de actuele pagina aan het einde van een test en worden alle overtreden WCAG-regels vermeld, met hun impact en de betrokken elementen. Standaard is dit adviserend. In de strikte modus krijgt een geslaagde test met een ernstige of zwaardere overtreding de status A11Y_VIOLATION. Geautomatiseerde controles vinden slechts een deel van de toegankelijkheidsproblemen en vervangen dus geen handmatige beoordeling.
Door het Nexus StudioQA-team, Verdict System LLC.
Laatst bijgewerkt: .
Wat er wordt gecontroleerd en hoe je dit inschakelt
De controle staat uit totdat je deze inschakelt: --a11y voor één uitvoering, of NEXUS_A11Y_ENABLED=true voor elke uitvoering. Hiervoor is de uitbreiding @axe-core/playwright nodig; zonder deze uitbreiding vermeldt het rapport “niet gemeten” en blijft de test ongewijzigd.
| Instelling | Standaard | Wat het doet |
|---|---|---|
NEXUS_A11Y_ENABLED | false | Voert de axe-core-audit uit op de pagina waarop de test eindigt. |
NEXUS_A11Y_STANDARD | wcag21aa | De regelset: wcag2a, wcag2aa, wcag21a, wcag21aa of wcag22aa. |
NEXUS_A11Y_FAIL_LEVEL | serious | De laagste impact die als overtreding telt: minor, moderate, serious of critical. |
NEXUS_A11Y_STRICT | false | Bij true krijgt een geslaagde test de status A11Y_VIOLATION als een overtreding op of boven de ingestelde foutdrempel ligt. |
Hoe de score en het oordeel werken
A11Y_VIOLATION is een van de 15 oordelen. Het geldt alleen voor een geslaagde test, geeft afsluitcode 0 in CI en toont het voorbehoud in het rapport en de geschiedenis. Een mislukte test wordt nooit geëscaleerd en bij chaosuitvoeringen wordt de audit overgeslagen. Een aanraakscherm, geëmuleerd of echt, wordt ook getoetst aan WCAG 2.2 AA, waarin ook de grootte van aanraakdoelen wordt gecontroleerd.
| Impact | Gewicht in de score |
|---|---|
| Kritiek | 25 punten per overtreden regel |
| Ernstig | 10 punten per overtreden regel |
| Matig | 4 punten per overtreden regel |
| Gering | 1 punt per overtreden regel |
Wat het rapport bevat
Een score en een beoordeling
De score is 100 min de bovenstaande gewichten, eenmaal geteld per overtreden regel en niet per element. De beoordelingen zijn A vanaf 90, B vanaf 75, C vanaf 60, D vanaf 40 en F daaronder. Dit is onze eigen samenvatting van één pagina, geen WCAG-conformiteitsniveau.
De overtreden regels
Maximaal 15 regels, de ernstigste eerst, elk met de impact, de WCAG-tags, een link naar de hulppagina van de regel en maximaal 5 voorbeeldelementen. De sectie wordt toegevoegd aan report.md.
Het aantal controles dat menselijke beoordeling vereist
axe-core markeert sommige controles als onvolledig wanneer het geen uitsluitsel kan geven. Het rapport telt deze en vermeldt dat menselijke beoordeling nodig is.
Wat geautomatiseerde controles niet vinden
Een geautomatiseerde controle vindt slechts een deel van de toegankelijkheidsproblemen op een pagina. Een resultaat zonder problemen betekent niet dat de pagina toegankelijk is, en Nexus StudioQA certificeert geen WCAG-conformiteit.
Betekenis, niet alleen opmaak
Een regel kan vaststellen dat een afbeelding alternatieve tekst heeft. De regel kan niet beoordelen of de tekst de afbeelding beschrijft, of dat de tekst van een link buiten de context begrijpelijk is.
Gebruik met een toetsenbord of een schermlezer
Of de leesvolgorde logisch is en of de pagina met alleen een toetsenbord of met een schermlezer kan worden gebruikt, moet iemand zelf uitproberen.
Slechts één paginastatus per test
De audit wordt uitgevoerd op de pagina waarop de test eindigt. Een pagina die de test nooit bereikt, of een status die vóór het einde is gesloten, wordt niet gecontroleerd.
Veelgestelde vragen
Vervangt geautomatiseerd testen een handmatige toegankelijkheidsaudit?
Nee. Het detecteert overtredingen van regels die een machine kan beoordelen en vermeldt dat de rest beoordeling nodig heeft. Gebruik het om terugval tussen handmatige audits te voorkomen, niet als vervanging ervan.
Zorgt een toegankelijkheidsprobleem ervoor dat mijn build mislukt?
Niet standaard. Problemen worden in het rapport vermeld. Met
NEXUS_A11Y_STRICT=truekrijgt een geslaagde test met een overtreding op of boven de ingestelde foutdrempel de status A11Y_VIOLATION, die nog steeds afsluitcode 0 in CI geeft.Aan welke WCAG-versie wordt getoetst?
Standaard WCAG 2.1 AA. De instellingen bieden 2.0 en 2.1 op niveau A en AA, en 2.2 AA. Op een aanraakscherm wordt WCAG 2.2 AA toegevoegd.
Werkt het met mijn bestaande tests?
Ja. Het wordt naast de controles van Playwright-, Selenium- of pytest-tests uitgevoerd via Nexus StudioQA, met
--a11yvoor één uitvoering of met de instelling ingeschakeld voor alle uitvoeringen. Toegankelijkheidsinstellingen
Draai het op je eigen machine.
Probeer alle functies gratis op je eigen machines. Geen creditcard nodig.