Aan de slag met Axe DevTools CLI
Snelstartgids met de meest voorkomende Axe DevTools CLI-taken
Voordat u begint, installeer Axe DevTools CLI.
Axe DevTools CLI werkt via de axe opdracht. Deze gids behandelt de drie meest voorkomende taken.
Een Webpagina Analyseren
Geef één of meer URL's rechtstreeks door aan de axe opdracht. Standaard gebruikt de CLI Firefox en voert het de WCAG 2.1 AA regels uit, waarbij resultaten naar stdout worden afgedrukt:
axe https://example.com/Analyseer meerdere pagina's tegelijk:
axe https://example.com/ https://example.com/about.htmlBewaar resultaten als een JSON-bestand voor later gebruik:
axe https://example.com/ --save=./axe-results.jsonGenereer direct een HTML-rapport:
axe https://example.com/ --report=./axe-reports/Zie voor alle opties Pagina's Analyseren.
Pagina's Analyseren met een Spec-bestand
Voor complexere scenario's zoals navigeren door een single-page app, inloggen, dialogen sluiten of een pagina op meerdere punten in een workflow analyseren, gebruik de axe spec opdracht met een spec-bestand.
Een spec-bestand (JSON of YAML) definieert een lijst van pagina's om te analyseren en de acties die op elke pagina moeten worden uitgevoerd vóór de analyse. Een minimaal voorbeeld (axe-workflow.yaml):
projects:
- name: example
id: example
pageList:
- name: Homepage
url: https://example.com/
- name: Search Results
url: https://example.com/
actions:
- type "axe" into element "#searchform input"
- click element "#searchform button[type=submit]"
- wait for element ".search-results" to be found
- analyzeVoer het uit met axe spec, waarbij u het spec-bestand en een uitvoermap voor de resultaten specificeert:
axe spec ./axe-workflow.yaml ./axe-resultsZie voor een volledige referentie van de structuur van het spec-bestand, acties en opties Pagina's Analyseren met een Spec-bestand.
Een Rapport Genereren van Opgeslagen Resultaten
Gebruik de axe reporter opdracht om opgeslagen JSON-resultaten om te zetten in HTML, JUnit XML, of CSV:
axe reporter ./axe-results --format=htmlGenereer een JUnit XML-rapport (nuttig in CI-pijplijnen):
axe reporter ./axe-results --format=junitGenereer een CSV-rapport:
axe reporter ./axe-results --format=csvZie voor filtering en andere opties Rapporten Genereren.
Volgende Stappen
- Pagina's Analyseren: alle opties voor het analyseren van individuele pagina's
- Pagina's Analyseren met een Spec-bestand: spec-bestanden, acties en batchverwerking
- Rapporten Genereren: rapportformaten, filtering en JSON-resultaatstructuur
- Naar Axe Reports Verzenden: resultaten uploaden naar de Axe Reports-service
- Naar Axe Developer Hub Verzenden: resultaten integreren met Axe Developer Hub
- Configureren: browserselectie, time-outs, en blijvende instellingen
- Aangepaste Regels: WCAG 2.x, Sectie 508, en aangepaste regels
