CLI-referentie
Opdrachtensyntaxis en volledige optie-referentie voor alle Axe DevTools CLI-subcommando's
Een snelle referentie voor elk Axe DevTools CLI-subcommando en de bijbehorende opties. Voor gebruiksinstructies en voorbeelden, volg de link naar het artikel van elke opdracht.
axe <url>— analysereer pagina's op URLaxe bulk-reports— verstuur resultaten naar Axe Reportsaxe bulk-spec— voer een map met specificatiebestanden uitaxe config-selenium— configureer blijvende browserinstellingenaxe devhub— verstuur resultaten naar Axe Developer Hubaxe licenses— toon afhankelijkheidslicentiesaxe reporter— genereer rapporten van JSON-resultatenaxe ruleset— genereer aangepaste regelsaxe spec— voer een specificatiebestand uit
axe <url>
Analyseert een of meer webpagina's op toegankelijkheidsproblemen. Zie Pagina's testen voor volledige documentatie.
axe <url...> [options]Sommige opties worden opgeslagen in een voorkeursbestand en blijven behouden bij CLI-runs. Zie Configuratie voor details.
| Optie | Beschrijving |
|---|---|
-a, --axe-source <path> |
Pad naar een alternatieve axe.js bestand. |
--accept-untrusted |
Accepteer niet-vertrouwde SSL-certificaten. Blijft behouden. |
--axe-devhub-api-key <api-key> |
API-sleutel voor Axe Developer Hub. |
--axe-devhub-project-id <project-id> |
Project-ID voor Axe Developer Hub. |
--axe-devhub-server-url <url> |
URL van de Axe Developer Hub-server. Standaard: https://axe.deque.com. |
--axe-reports-api-key <api-key> |
API-sleutel voor Axe Reports. |
--axe-reports-dimensions <dimensions> |
Door komma's gescheiden JTBD-dimensies om deze scan te labelen in Axe Reports. |
--axe-reports-url <url> |
URL om resultaten naar Axe Reports te verzenden. |
--browser [name] |
Te gebruiken browser. Vereist de bijbehorende WebDriver. Geldige waarden: firefox (standaard), chrome, safari, edge, ie. Blijft behouden. |
--chrome-options [options] |
Door komma's gescheiden Chrome-opdrachten die worden doorgegeven aan ChromeDriver. Blijft behouden. |
--chrome-path <path> |
Absoluut pad naar het Chrome-browseruitvoerbare bestand. |
--chromedriver-path <path> |
Absoluut pad naar het ChromeDriver-uitvoerbare bestand. |
-c, --custom <path> |
Pad naar een aangepast regelbestand dat het standaardbestand overschrijft. |
-d, --dir <path> |
Directory waar JSON-resultaten worden opgeslagen. |
-l, --disable <list> |
Door komma's gescheiden regel-ID's om uit te schakelen. |
-e, --exclude <list> |
Door komma's gescheiden CSS-selectors voor elementen die niet getest hoeven te worden. |
-q, --exit |
Verlaat met code 1 als er overtredingen worden gevonden. |
--enable-tracking <state> |
Inschakelen (true) of uitschakelen (false) van het verzenden van gebruiksgegevens naar de metrische bibliotheek. Blijft behouden. |
-f, --format <value> |
Rapportformaat/-formaten: html, junit, csv, of een +-gescheiden combinatie. Standaard: html. Vereist -r, --report. |
--filter <list> |
Komma-gescheiden resultaattypen die moeten worden opgenomen: passes, violations, incomplete, inapplicable. Vereist --format csv. |
--headless |
Start de browser in headless-modus. Blijft geldig. |
-i, --include <list> |
Komma-gescheiden CSS-selectoren. Alleen overeenkomende elementen worden getest. |
--load-delay <n> |
Milliseconden wachten na het laden van de pagina alvorens de audit uit te voeren. Standaard: 0. |
--no-git-data |
Verzend geen Git-branch en commitgegevens naar Axe Developer Hub. |
--no-reporter |
Onderdruk de uitvoer van de overtredingssamenvatting. |
--page-timeout <ms> |
Maximale milliseconden wachten tot een pagina geladen is. Standaard: 60000. Blijft geldig. |
--post-analyze-pause <ms> |
Milliseconden pauzeren na analyse voordat de volgende actie plaatsvindt. Standaard: 2000. Blijft geldig. |
--post-get-pause <ms> |
Milliseconden pauzeren na het laden van de pagina en voordat de scan begint. Standaard: 2000. Blijft geldig. |
--post-script-pause <ms> |
Milliseconden pauzeren na een scriptactie en vóór de scan. Standaard: 2000. Blijft geldig. |
-r, --report <output-dir> |
Map waar het geformatteerde rapport wordt geschreven. Gebruik met -f, --format. |
--remote-proxy [proxy-server] |
Routeer verkeer via een externe proxy (alleen ChromeDriver). Blijft geldig. |
--remote-server [server-url] |
Maak verbinding met een externe WebDriver-server (bijv. Selenium Grid, BrowserStack). Blijft geldig. |
--rules <list> |
Komma-gescheiden regel-ID's om uit te voeren. Alleen de gespecificeerde regels worden gecontroleerd. |
-s, --save [filename] |
Resultaten opslaan als een JSON-bestand. De bestandsnaam is standaard axe-result.json. |
--script-timeout <ms> |
Maximale milliseconden wachten voor een workflow-script. Standaard: 60000. Blijft geldig. |
--send-axe-reports |
Analyseerresultaten naar Axe Reports verzenden. |
--set-distinct-id <id> |
Overschrijf de unieke ID die wordt gebruikt voor gebruikstracering. Blijft geldig. |
--set-tracking-url <url> |
Overschrijf de URL waar metrische gegevens naartoe worden gestuurd. Blijft geldig. |
--show-errors |
Weergave van de volledige foutstack-trace bij fouten. |
-j, --stdout |
JSON-resultaten naar stdout uitvoeren; onderdrukt alle andere uitvoer. |
-t, --tags <list> |
Komma-gescheiden tags om te filteren welke regels worden uitgevoerd. |
--timer |
Print tijdsmetingen na elke testuitvoering. |
-v, --verbose |
Inclusief toolnaam, versie en omgevingsmetadata in de output. |
-V, --version |
Het versienummer uitvoeren. |
--window-size <width,height> |
Stel de grootte van het browservenster in pixels in. Blijft geldig. |
axe bulk-reports
Verzendt JSON-resultaten naar Axe Reports. Zie Verzenden naar Axe Reports voor volledige documentatie.
axe bulk-reports <results-directory> [options]| Optie | Beschrijving |
|---|---|
--axe-reports-api-key <api-key> |
API-sleutel voor Axe Reports. |
--axe-reports-dimensions <dimensions> |
Komma-gescheiden JTBD-dimensies om deze scan in Axe Reports te labelen. |
--axe-reports-url <url> |
URL om resultaten naar Axe Reports te sturen. |
--send-axe-reports |
Stuur analyse-resultaten naar Axe Reports. |
--verbose |
Schakel gedetailleerde logging in. |
axe bulk-spec
Verwerkt een directory van spec-bestanden in één keer. Zie Workflow Specs voor volledige documentatie.
axe bulk-spec <spec-files-directory> [output-directory] [options]| Optie | Beschrijving |
|---|---|
-a, --axe-source <path> |
Pad naar een alternatief axe.js bestand. |
--accept-untrusted |
Accepteer onbetrouwbare SSL-certificaten. Blijft bewaard. |
--browser [name] |
Te gebruiken browser. Vereist de overeenkomstige WebDriver. Geldige waarden: firefox (standaard), chrome, safari, edge, ie. Blijft bewaard. |
-c, --custom <path> |
Pad naar een aangepast regels-bestand, dat de standaardinstelling vervangt. |
--dismiss-alerts |
Verwijder browser alert(), confirm(), en prompt() dialoogvensters voordat er gescand wordt. |
--enable-tracking <state> |
Zet het verzenden van gebruiksgegevens naar de metriekbibliotheek aan (true) of uit (false). Blijft bewaard. |
-f, --format [value] |
Rapportformaat(-en): html, junit, csv, of een +-gescheiden combinatie. Standaard: html. |
--headless |
Start de browser in headless-modus. Blijft bewaard. |
--no-analyze |
Verwijder de vereiste voor een analyze actie in de actielijst van elke pagina. |
--no-html |
Voorkom de generatie van een HTML-rapport. |
--no-reports |
Voorkom de generatie van alle rapportbestanden. |
--no-wait |
Schakel automatische pauzes tussen workflow-acties uit. |
--page-timeout <ms> |
Maximale milliseconden om te wachten op het laden van een pagina. Standaard: 60000. Blijft bewaard. |
--post-analyze-pause <ms> |
Milliseconden om te pauzeren na analyse voordat de volgende actie begint. Standaard: 2000. Blijft bewaard. |
--post-get-pause <ms> |
Milliseconden om te pauzeren na het laden van een pagina en voordat er gescand wordt. Standaard: 2000. Blijft bewaard. |
--post-script-pause <ms> |
Milliseconden om te pauzeren na een scriptactie en voordat er gescand wordt. Standaard: 2000. Blijft bewaard. |
--remote-proxy [proxy-server] |
Leid verkeer via een externe proxy (alleen ChromeDriver). Blijft bewaard. |
--remote-server [server-url] |
Maak verbinding met een externe WebDriver-server (bijv. Selenium Grid, BrowserStack). Blijft bewaard. |
--script-timeout <ms> |
Maximale milliseconden om te wachten op een workflow-script. Standaard: 60000. Blijft bewaard. |
--set-distinct-id <id> |
Overschrijf de unieke ID gebruikt voor het bijhouden van het gebruik. Blijft behouden. |
--set-tracking-url <url> |
Overschrijf de URL waar metrische gegevens naartoe worden gestuurd. Blijft behouden. |
-t, --tags [list] |
Kommagescheiden tags om te filteren welke regels worden uitgevoerd. |
--user-agent <agent> |
Stel een aangepaste user-agent string in. Blijft behouden. |
--validate |
Valideer de specificatiebestanden zonder ze uit te voeren. |
--wait-network-idle-new-connections [number] |
Nieuwe verbinding drempel voordat het netwerk als inactief wordt beschouwd. |
--wait-network-idle-open-connections [number] |
Open verbinding drempel voordat het netwerk als inactief wordt beschouwd. |
--wait-network-idle-timeout [ms] |
Maximaal aantal milliseconden om te wachten op netwerk inactiviteit voordat verder gegaan wordt. |
--window-size <width,height> |
Stel het formaat van het browservenster in op pixels. Blijft behouden. |
axe config-selenium
Configureert interactief de standaardinstellingen voor persistente browser en timing. Zie Configuratie voor volledige documentatie.
axe config-selenium [options]| Optie | Beschrijving |
|---|---|
-s, --show |
Toon huidige opgeslagen instellingen zonder de interactieve prompt in te voeren. |
axe devhub
Stuurt JSON-resultaten naar Axe Developer Hub. Zie Verzenden naar Axe Developer Hub voor volledige documentatie.
axe devhub <results-directory|file> [options]| Optie | Beschrijving |
|---|---|
--axe-devhub-api-key <api-key> |
API-sleutel voor Axe Developer Hub. Overschrijft de AXE_DEVHUB_API_KEY omgevingsvariabele. |
--axe-devhub-project-id <project-id> |
Project-ID voor Axe Developer Hub. |
--axe-devhub-server-url <url> |
URL van de Axe Developer Hub-server. Standaard: https://axe.deque.com. |
--no-git-data |
Stuur geen Git-branch- en commitgegevens naar Axe Developer Hub. |
axe licenses
Geeft de open-source licenties weer en slaat deze op voor alle CLI-afhankelijkheden.
axe licenses [options]axe reporter
Converteert JSON-resultaten naar HTML-, JUnit XML- of CSV-rapporten. Zie Rapporten genereren voor volledige documentatie.
axe reporter <results-dir> [dest-dir] [options]| Optie | Beschrijving |
|---|---|
-b, --browser [name] |
Wanneer de resultatenmap resultaten van meerdere browsers bevat, genereer het rapport dan alleen van de resultaten van één browser. |
-d, --dest [path] |
Outputmap voor gegenereerde rapporten. Kan ook als het tweede positionele argument worden gespecificeerd. |
--filter <list> |
Kommagescheiden resultaattypes om op te nemen: passes, violations, incomplete, inapplicable. Vereist --format csv. |
-f, --format [type(s)] |
Outputformaat(en): html, junit, csv, of een combinatie. Standaard: html. |
axe ruleset
Genereert aangepaste regelsbestanden. Zie Aangepaste Regels voor volledige documentatie.
axe ruleset [options]| Optie | Beschrijving |
|---|---|
--508 [filename] |
Genereer een standaardconfiguratie voor Section 508-regels. |
--all [filename] |
Genereer een standaardconfiguratie voor alle ondersteunde richtlijnen. |
-a, --axe-source <path> |
Pad naar een aangepaste axe-bron. |
-c, --custom [dir] |
Genereer een aangepaste set regels vanuit een map die een changes.json bestand bevat. |
-d, --destination [dir] |
Uitvoermap. Standaard: huidige werkmap. |
-x, --disable-other-rules |
Schakel alle regels uit die niet zijn opgenomen in de rules eigenschap. Standaard: true. |
--en301549 [filename] |
Genereer een standaardconfiguratie voor EN 301 549-regels. |
-f, --format [format] |
Uitvoerformaat. |
-l, --log |
Genereer ook een lijst van alle regels die zijn opgenomen in de gegenereerde set. |
--only-changes |
Genereer alleen de wijzigingen en toevoegingen aan de set regels. |
--rgaav4 [filename] |
Genereer een standaardconfiguratie voor RGAA v4-regels. |
-t, --tags [list] |
Door komma's gescheiden tags om de standaard set regels te filteren. |
--ttv5 [filename] |
Genereer een standaardconfiguratie voor Trusted Tester v5-regels. |
--wcag2 [filename] |
Genereer een standaardconfiguratie voor WCAG 2.0 AA-regels. |
--wcag21 [filename] |
Genereer een standaardconfiguratie voor WCAG 2.1 AA-regels. |
--wcag21aaa [filename] |
Genereer een standaardconfiguratie voor WCAG 2.1 AAA-regels. |
--wcag22 [filename] |
Genereer een standaardconfiguratie voor WCAG 2.2 AA-regels. |
--wcag22aaa [filename] |
Genereer een standaardconfiguratie voor WCAG 2.2 AAA-regels. |
--wcag2aaa [filename] |
Genereer een standaardconfiguratie voor WCAG 2.0 AAA-regels. |
axe spec
Analyseert pagina's gedefinieerd in een JSON- of YAML-spec bestand. Zie Werkstroom specs voor volledige documentatie.
axe spec <spec-file> [output-directory] [options]| Optie | Beschrijving |
|---|---|
-a, --axe-source <path> |
Pad naar een alternatief axe.js bestand. |
--accept-untrusted |
Accepteer niet-vertrouwde SSL-certificaten. Blijft gehandhaafd. |
--axe-devhub-api-key <api-key> |
API-sleutel voor Axe Developer Hub. |
--axe-devhub-project-id <project-id> |
Project-ID voor Axe Developer Hub. |
--axe-devhub-server-url <url> |
URL van de Axe Developer Hub-server. Standaard: https://axe.deque.com. |
--axe-reports-api-key <api-key> |
API-sleutel voor Axe Reports. |
--axe-reports-dimensions <dimensions> |
Door komma's gescheiden JTBD-dimensies om deze scan te taggen in Axe Reports. |
--axe-reports-url <url> |
URL om resultaten naar Axe Reports te verzenden. |
--browser [name] |
Browser die moet worden gebruikt. Vereist de bijbehorende WebDriver. Geldige waarden: firefox (standaard), chrome, safari, edge, ie. Blijft gehandhaafd. |
--chrome-options [options] |
Door komma's gescheiden Chrome-opdrachtregelopties die worden doorgegeven aan ChromeDriver. Blijft gehandhaafd. |
-c, --custom <path> |
Pad naar een aangepast regelsbestand dat de standaard overschrijft. |
--descendant-links |
Verzamel links op elke pagina en voeg ze toe aan de resultaten. Vereist --verbose. |
--dismiss-alerts |
Sluit browser alert(), confirm(), en prompt() dialoogvensters voordat u scant. |
--download-path <path> |
Stel in waar de browser downloads opslaat (alleen Chrome). |
--enable-tracking <state> |
Inschakelen (true) of uitschakelen (false) het verzenden van gebruiksgegevens naar de metriekbibliotheek. Blijft behouden. |
-f, --format [value] |
Rapportformaat(-formaten): html, junit, csv, of een +-gescheiden combinatie. Standaard: html. |
--filter <list> |
Komma-gescheiden resultaatstypen om op te nemen: passes, violations, incomplete, inapplicable. Vereist --format csv. |
--headless |
Start de browser in headless-modus. Blijft behouden. |
--interactive-mode |
Sta de CLI toe om te draaien op pagina's die interactieve modus gebruiken (alleen Chrome). |
--no-analyze |
Verwijder de vereiste voor een analyze actie in de actielijst van elke pagina. |
--no-exit |
Forceer exitcode 0 zelfs wanneer er overtredingen worden gevonden. |
--no-git-data |
Stuur geen Git-branch- en commitgegevens naar Axe Developer Hub. |
--no-html |
Voorkom de generatie van HTML-rapporten. |
--no-reports |
Voorkom alle rapportbestandgeneratie. |
--no-wait |
Schakel automatische pauzes tussen workflowacties uit. |
--page-name <name> |
Voer alleen de pagina met de opgegeven naam uit het specificatiebestand uit. |
--page-source |
Voeg de gescande HTML-bron toe aan resultaten. Vereist --verbose. |
--page-timeout <ms> |
Maximale milliseconden om te wachten op het laden van een pagina. Standaard: 60000. Blijft behouden. |
--page-title |
Voeg de paginatitel toe aan resultaten. Vereist --verbose. |
--post-analyze-pause <ms> |
Milliseconden om te pauzeren na analyse voordat de volgende actie begint. Standaard: 2000. Blijft behouden. |
--post-get-pause <ms> |
Milliseconden om te pauzeren na paginalading en voor het scannen. Standaard: 2000. Blijft behouden. |
--post-script-pause <ms> |
Milliseconden om te pauzeren na een scriptactie en voor het scannen. Standaard: 2000. Blijft behouden. |
--remote-proxy [proxy-server] |
Leid verkeer via een externe proxy (alleen ChromeDriver). Blijft behouden. |
--remote-server [server-url] |
Maak verbinding met een externe WebDriver-server (bijv. Selenium Grid, BrowserStack). Blijft behouden. |
--resume-from <name> |
Sla alle pagina's over vóór de genoemde pagina in het specificatiebestand. |
--scanned-url |
Voeg de basis-URL en scan-URL toe aan gedetailleerde resultaten. Alleen Chrome. Vereist --verbose. |
--script-timeout <ms> |
Maximale milliseconden om te wachten op een workflow-script. Standaard: 60000. Blijft behouden. |
--send-axe-reports |
Stuur analyseresultaten naar Axe Reports. |
--set-distinct-id <id> |
Overschrijf de unieke ID die wordt gebruikt voor gebruiksregistratie. Blijft behouden. |
--set-legacy-mode |
Schakel de oude scanmodus in. Verouderd — zal worden verwijderd in v5.0. |
--set-tracking-url <url> |
Overschrijf de URL waarnaar metrische gegevens worden verzonden. Blijft bewaard. |
--silent-mode |
Onderdruk alle decoratieve uitvoer; resultaten worden alleen getoond wanneer --verbose ook actief is. |
-t, --tags [list] |
Komma-gescheiden tags om te filteren welke regels worden uitgevoerd. |
--user-agent <agent> |
Stel een aangepaste user-agent string in. Blijft bewaard. |
--validate |
Valideer het spec-bestand zonder het uit te voeren. |
-v, --verbose |
Inclusief toolnaam, versie en omgevingsmetadata in de uitvoer. |
--wait-network-idle-new-connections [number] |
Nieuwe verbinding drempel voordat het netwerk als idle wordt beschouwd. |
--wait-network-idle-open-connections [number] |
Open verbinding drempel voordat het netwerk als idle wordt beschouwd. |
--wait-network-idle-polling-every [ms] |
Poll-interval in milliseconden voor netwerk-idle detectie. |
--wait-network-idle-timeout [ms] |
Maximale milliseconden wachten op netwerk idle voordat wordt doorgegaan. |
--window-size <width,height> |
Stel de grootte van het browservenster in pixels in. Blijft bewaard. |
