Axe DevTools for Web CLI configureren

De vlaggen die in dit artikel worden beschreven zijn beschikbaar voor axe <url>, axe spec, en axe bulk-spec. Wanneer u een van deze vlaggen instelt, wordt de waarde opgeslagen in het voorkeursbestand en wordt dit de standaard voor alle volgende uitvoeringen. Om voorkeuren interactief te bekijken of te wijzigen, inclusief het resetten van waarden waarvoor geen overeenkomstige vlag is, gebruikt u axe config-selenium.

Browseropties

--accept-untrusted

Instructeert de browser om niet-vertrouwde SSL-certificaten te accepteren. Gebruik dit bij het testen van pagina's op lokale ontwikkelservers of interne omgevingen die zelfondertekende certificaten gebruiken. Het gebruik van deze vlag slaat acceptUntrustedCertificates: true op in het voorkeursbestand. Om het te resetten naar false, voer axe config-selenium uit en antwoord Nee wanneer daarom gevraagd wordt, of bewerk het voorkeursbestand direct.

axe <url> --accept-untrusted

--browser <name>

Specificeert welke browser te gebruiken. De overeenkomstige WebDriver moet geïnstalleerd en beschikbaar zijn op uw $PATH. Geldige waarden zijn: firefox (standaard), chrome, safari, edge, ie.

axe <url> --browser chrome

Als u bij uw eerste poging een browserstartfout krijgt, is GeckoDriver (Firefox's WebDriver) mogelijk niet geïnstalleerd. Probeer --browser chrome in plaats daarvan, wat meestal zonder aanvullende instellingen op de meeste systemen werkt.

Het gebruik van deze vlag slaat de browsernaam op in het voorkeursbestand. Alle volgende uitvoeringen, inclusief uitvoeringen zonder --browser, zullen de opgeslagen browser gebruiken. Om de opgeslagen browser te wijzigen, voer axe config-selenium uit en kies een andere browser bij de prompt, of bewerk het voorkeursbestand direct.

--headless

Start de browser in headless-modus (geen zichtbaar venster). De standaard is false.

axe <url> --headless

--remote-server <url>

Verbindt met een externe WebDriver-server in plaats van een lokale browser te starten. De server moet een W3C WebDriver-compatibel eindpunt exposen, zoals een Selenium Grid, BrowserStack, of Sauce Labs remote.

axe <url> --remote-server https://hub.browserstack.com/wd/hub

--window-size <width,height>

Stelt de grootte van het browservenster in pixels in. Dit bepaalt ook de viewportgrootte in headless-modus, wat nuttig is voor het testen van responsieve lay-outs.

axe <url> --window-size 1280,900

Tijdopties

--page-timeout <ms>

Maximale tijd in milliseconden (ms) om te wachten op het laden van een pagina alvorens te falen. Standaard is 60.000 ms (60 seconden). Verhoog dit voor langzaam ladende pagina's of netwerkomgevingen met hoge latentie.

axe <url> --page-timeout 120000

--post-analyze-pause <ms>

Tijd in milliseconden om te pauzeren na het voltooien van een analyse voordat wordt doorgegaan naar de volgende actie in een workflow. Standaard is 2.000 ms (2 seconden).

axe spec workflow.yml --post-analyze-pause 5000

--post-get-pause <ms>

Tijd in milliseconden om te pauzeren na het laden van een pagina en voordat de scan begint. Standaard is 2.000 ms (2 seconden). Verhoog dit als dynamische inhoud meer tijd nodig heeft om te renderen voordat het scannen begint.

axe <url> --post-get-pause 5000

--post-script-pause <ms>

Tijd in milliseconden om te pauzeren na het uitvoeren van een workflow script-actie en voordat wordt doorgegaan naar de volgende actie. Standaard is 2.000 ms (2 seconden).

axe spec workflow.yml --post-script-pause 5000

--script-timeout <ms>

Maximale tijd in milliseconden om te wachten tot een workflow script klaar is met uitvoeren. Standaard is 60.000 ms (60 seconden).

axe spec workflow.yml --script-timeout 120000

Gebruikstracering

Axe DevTools CLI omvat de @deque/metrics-library, die anonieme gebruiksgegevens naar Deque stuurt. Deze gegevens bevatten geaggregeerde informatie zoals overtredingtellings, regeltellings en axe-core engine versie. Het bevat geen URL's, paginainhoud of enige persoonlijk identificeerbare informatie.

Een unieke ID is een waarde die in het voorkeursbestand is opgeslagen en wordt gebruikt om gebeurtenissen over meerdere CLI-uitvoeringen heen te correleren zonder de gebruiker te identificeren. U kunt de tracking wijzigen of uitschakelen met de onderstaande opties. Om tracking volledig uit te schakelen zonder de CLI te gebruiken, stelt u de omgevingsvariabele in AXE_TRACK_USAGE=false.

--enable-tracking <state>

Stelt het verzenden van gebruiksgegevens naar de metrieke bibliotheek in of uit. Geef true op om in te stellen of false om uit te schakelen.

axe <url> --enable-tracking false

--set-distinct-id <id>

Wijzigt de unieke ID die wordt gebruikt om gebruiksgebeurtenissen te correleren. De ID wordt opgeslagen in het voorkeursbestand en gebruikt bij alle uitvoeringen.

axe <url> --set-distinct-id my-team-id

--set-tracking-url <url>

Wijzigt het eindpunt waar gebruiksstatistieken naartoe worden gestuurd. Gebruik dit als uw organisatie telemetrie via een interne proxy doorstuurt.

axe <url> --set-tracking-url https://metrics.example.com/collect

axe config-selenium

Gebruik axe config-selenium om standaarden interactief in te stellen. U wordt gevraagd om waarden in te voeren voor browser, time-out en andere instellingen. Uw antwoorden worden opgeslagen in het voorkeursbestand en worden de standaarden voor alle toekomstige CLI-uitvoeringen.

$ axe config-selenium
? Choose browser for running automated tests: (Use arrow keys)
? Choose browser for running automated tests: chrome
? Enter a value for pageLoadTimeout: 60000
? Enter a value for setScriptTimeout: 60000
? Accept untrusted ssl certs: Yes
? Enter a value for postGetPause: 2000
? Enter a value for postScriptPause: 2000
? Enter a value for postAnalysisPause: 2000
? Launch browser in headless mode: No

Results saved to ~/.config/preferences/com.deque.axe.devtools.cli.pref

Om de huidige opgeslagen instellingen te bekijken zonder de interactieve prompt te openen, gebruikt u de --show vlag:

axe config-selenium --show

Voorkeursbestand

Alle configureerbare standaarden worden opgeslagen in een JSON-bestand op:

~/.config/preferences/com.deque.axe.devtools.cli.pref

Een typisch bestand ziet er als volgt uit:

{
  "selenium": {
    "acceptUntrustedCertificates": false,
    "browser": "firefox",
    "headless": false,
    "pageLoadTimeout": 60000,
    "postAnalysisPause": 2000,
    "postGetPause": 2000,
    "postScriptPause": 2000,
    "setScriptTimeout": 60000
  }
}

U kunt dit bestand direct bewerken als alternatief voor het gebruik van axe config-selenium of vlaggen aan de opdrachtregel toevoegen. Dit is handig voor het opnieuw instellen van booleaanse waarden zoals acceptUntrustedCertificates zonder de interactieve prompt uit te voeren.