Configurazione di Axe DevTools per Web CLI

Le flag descritte in questo articolo sono disponibili per axe <url>, axe spec, e axe bulk-spec. Quando imposti una di queste flag, il valore viene salvato nel file delle preferenze e diventa il predefinito per tutte le esecuzioni successive. Per visualizzare o modificare le preferenze in modo interattivo, inclusi i valori di reset che non hanno una flag corrispondente, usa axe config-selenium.

Opzioni del Browser

--accept-untrusted

Istruisce il browser ad accettare certificati SSL non attendibili. Utilizza questa opzione quando testi pagine su server di sviluppo locali o ambienti interni che utilizzano certificati autofirmati. Passando questa flag salva acceptUntrustedCertificates: true nel file delle preferenze. Per reimpostarlo su false, esegui axe config-selenium e rispondi No quando richiesto, o modifica direttamente il file delle preferenze.

axe <url> --accept-untrusted

--browser <name>

Specifica quale browser utilizzare. Il corrispondente WebDriver deve essere installato e disponibile sul tuo $PATH. I valori validi sono: firefox (predefinito), chrome, safari, edge, ie.

axe <url> --browser chrome

Se ricevi un errore di avvio del browser alla prima esecuzione, potrebbe non essere stato installato il GeckoDriver (il WebDriver di Firefox). Prova --browser chrome al suo posto, che generalmente funziona senza configurazioni aggiuntive sulla maggior parte dei sistemi.

Passando questa flag, il nome del browser viene salvato nel file delle preferenze. Tutte le esecuzioni successive, incluse quelle senza --browser, utilizzeranno il browser salvato. Per cambiare il browser salvato, esegui axe config-selenium e scegli un browser diverso al prompt, o modifica direttamente il file delle preferenze .

--headless

Avvia il browser in modalità headless (senza finestra visibile). Il predefinito è false.

axe <url> --headless

--remote-server <url>

Si connette a un server WebDriver remoto invece di avviare un browser locale. Il server deve esporre un endpoint compatibile con W3C WebDriver, come un Selenium Grid, BrowserStack o un remoto Sauce Labs.

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

--window-size <width,height>

Imposta la dimensione della finestra del browser in pixel. Questo controlla anche la dimensione del viewport in modalità headless, rendendolo utile per testare layout responsive.

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

Opzioni di Temporizzazione

--page-timeout <ms>

Tempo massimo in millisecondi (ms) per attendere il caricamento di una pagina prima di fallire. Il predefinito è 60.000 ms (60 secondi). Aumenta questo valore per pagine a caricamento lento o ambienti di rete con alta latenza.

axe <url> --page-timeout 120000

--post-analyze-pause <ms>

Tempo in millisecondi per attendere dopo aver completato un'analisi prima di passare alla prossima azione in un flusso di lavoro. Il predefinito è 2.000 ms (2 secondi).

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

--post-get-pause <ms>

Tempo in millisecondi per attendere dopo il caricamento di una pagina e prima di iniziare la scansione. Il predefinito è 2.000 ms (2 secondi). Aumenta questo valore se il contenuto dinamico necessita di più tempo per essere renderizzato prima che inizi la scansione.

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

--post-script-pause <ms>

Tempo in millisecondi per attendere dopo aver eseguito un'azione di script del flusso di lavoro e prima di continuare con l'azione successiva. Il predefinito è 2.000 ms (2 secondi).

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

--script-timeout <ms>

Tempo massimo in millisecondi per attendere il completamento dell'esecuzione di uno script del flusso di lavoro. Il predefinito è 60.000 ms (60 secondi).

axe spec workflow.yml --script-timeout 120000

Tracciamento dell'Uso

Axe DevTools CLI include il @deque/metrics-library, che invia dati di utilizzo anonimi a Deque. Questi dati includono informazioni aggregate come il conteggio delle violazioni, il conteggio delle regole e la versione del motore axe-core. Non include URL, contenuti delle pagine o alcuna informazione di identificazione personale.

Un ID distintivo è un valore memorizzato nel file delle preferenze utilizzato per correlare eventi tra più esecuzioni CLI senza identificare l'utente. Puoi modificare o disattivare il tracciamento con le opzioni sottostanti. Per disattivare completamente il tracciamento senza usare il CLI, imposta la variabile di ambiente AXE_TRACK_USAGE=false.

--enable-tracking <state>

Abilita o disabilita l'invio dei dati di utilizzo alla libreria delle metriche. Passare true per abilitare o false per disabilitare.

axe <url> --enable-tracking false

--set-distinct-id <id>

Modifica l'ID distinto utilizzato per correlare gli eventi di utilizzo. L'ID è memorizzato nel file delle preferenze e utilizzato nelle esecuzioni successive.

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

--set-tracking-url <url>

Modifica l'endpoint a cui vengono inviate le metriche di utilizzo. Utilizzare questo se la vostra organizzazione instrada la telemetria attraverso un proxy interno.

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

axe config-selenium

Usare axe config-selenium per configurare i valori predefiniti in modo interattivo. Vi verrà chiesto di inserire i valori per il browser, il timeout e altre impostazioni. Le vostre risposte vengono salvate nel file delle preferenze e diventano i predefiniti per tutte le esecuzioni successive della CLI.

$ 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

Per visualizzare le impostazioni salvate attuali senza entrare nel prompt interattivo, utilizzare il flag --show :

axe config-selenium --show

File delle Preferenze

Tutti i valori predefiniti configurabili sono memorizzati in un file JSON in:

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

Un file tipico appare così:

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

Potete modificare direttamente questo file come alternativa all'uso di axe config-selenium o al passaggio di flag nella riga di comando. Questo è utile per reimpostare i valori booleani come acceptUntrustedCertificates senza eseguire il prompt interattivo.