Axe DevTools voor Web CLI

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard

Een commandoregeltool voor het automatiseren van toegankelijkheidstests voor websites zonder het schrijven van testcode.

Not for use with personal data

Axe DevTools voor Web CLI is een commandoregeltool die toegankelijkheidsanalyses uitvoert op webpagina's en rapporten genereert. Het is ontworpen voor teams die toegankelijkheidstests willen automatiseren zonder axe te integreren in een bestaand testframework, bijvoorbeeld als een stap in een CI/CD-pijplijn, of wanneer Axe DevTools API's niet beschikbaar zijn voor jouw taal.

Hoe het werkt

Elke axe-analyse produceert JSON-resultaatbestanden, één per geanalyseerde paginatoestand. Deze bestanden worden gegenereerd tijdens het testen en je gebruikt ze bij het rapporteren of uploaden van resultaten.

De gebruikelijke workflow heeft twee fasen:

  1. Pagina's analyseren: voer een of meer URL's uit via axe en sla de JSON-resultaten op:

    axe <url>              → test a URL directly
axe spec <spec-file>   → test pages and workflows defined in a YAML/JSON file
axe bulk-spec <dir>    → test using all spec files in a directory

  2. Iets doen met resultaten: converteer, upload of verzend ze elders:

    axe reporter <results>     → generate HTML, JUnit XML, or CSV reports
axe bulk-reports <results> → upload to the Axe Reports service
axe devhub <results>       → send to Axe Developer Hub

De axe- en axe spec- commando's ondersteunen ook --format- en --report-vlaggen om rapporten in één stap te genereren, zonder een aparte axe reporter-aanroep.

Commando's

Commando Doel
axe <url...> Analyseer direct één of meer URL's. Standaardbrowser: Firefox. Standaardregels: WCAG 2.1 AA.
axe spec <spec-file> Analyseer pagina's gedefinieerd in een YAML- of JSON-spec bestand, inclusief stappenplannen.
axe bulk-spec <dir> Voer alle spec-bestanden uit die in een map en zijn submappen worden gevonden.
axe reporter <results-dir> Converteer JSON-resultaten naar HTML, JUnit XML of CSV-rapporten.
axe bulk-reports <results-dir> Upload JSON-resultaten naar de Axe Reports-service.
axe devhub <results-dir> Stuur JSON-resultaten naar de Axe Developer Hub.
axe ruleset Lijst, valideer of beheer aangepaste regels.
axe config-selenium Bekijk of werk browser-/Selenium-instellingen bij.

JSON-resultaten

Wanneer je axe spec uitvoert of axe <url> --save gebruikt, worden resultaten als JSON-bestanden naar de uitvoermap geschreven. Elk bestand legt de volledige axe-analyse vast voor een enkele paginatoestand: overtredingen, geslaagde controles, onvoltooide controles en niet-toepasbare regels, samen met metadata zoals de URL, browser en tijdstempel.

Resultaatbestanden worden georganiseerd per project en genoemd naar de pagina die wordt getest:

<output-dir>/<project-id>/<project-id>-<page-id>[-<analyze-title>].json

Deze bestanden worden gebruikt door axe reporter, axe bulk-reports en axe devhub. Voor details over bestandsnaamgeving en directorystructuur, zie Rapporten genereren.

Het JSON-resultaatschema is gedefinieerd door axe-core. Voor een volledige referentie, zie de axe-core API documentatie.

In deze sectie

Is this page helpful?

Help us improve this page

Still need help?