Automazione dei test di accessibilità con axe-core e WCAG.
L’automazione dei test di accessibilità in Nexus StudioQA esegue axe-core sulla pagina effettiva al termine di un test ed elenca ogni regola WCAG violata, con il relativo impatto e gli elementi coinvolti. Per impostazione predefinita ha solo valore informativo. In modalità rigorosa, un test superato con una violazione grave o peggiore riporta A11Y_VIOLATION. Le verifiche automatiche individuano solo una parte dei problemi di accessibilità, quindi non sostituiscono una revisione manuale.
A cura del gruppo Nexus StudioQA, Verdict System LLC.
Ultimo aggiornamento: .
Cosa verifica e come attivarla
La verifica resta disattivata finché non la richiedi: --a11y per una singola esecuzione, oppure NEXUS_A11Y_ENABLED=true per ogni esecuzione. Richiede il componente aggiuntivo @axe-core/playwright; in sua assenza il rapporto indica “non misurato” e il test non ne risente.
| Impostazione | Predefinito | Cosa fa |
|---|---|---|
NEXUS_A11Y_ENABLED | false | Esegue la verifica con axe-core sulla pagina in cui termina il test. |
NEXUS_A11Y_STANDARD | wcag21aa | Il set di regole: wcag2a, wcag2aa, wcag21a, wcag21aa o wcag22aa. |
NEXUS_A11Y_FAIL_LEVEL | serious | L’impatto minimo da considerare una violazione: minor, moderate, serious o critical. |
NEXUS_A11Y_STRICT | false | Se impostato su true, una violazione pari o superiore alla soglia di errore contrassegna un test superato come A11Y_VIOLATION. |
Come funzionano il punteggio e l’esito
A11Y_VIOLATION è uno dei 15 esiti. Si applica solo a un test superato, restituisce il codice di uscita 0 in CI e il rapporto e la cronologia mostrano la riserva. L’esito di un test non superato non viene mai aggravato e nelle esecuzioni di caos la verifica viene saltata. Per uno schermo tattile, emulato o reale, viene verificata anche la conformità alle WCAG 2.2 AA, che aggiungono la dimensione dei bersagli.
| Impact | Peso nel punteggio |
|---|---|
| Critico | 25 punti per regola violata |
| Grave | 10 punti per regola violata |
| Moderato | 4 punti per regola violata |
| Lieve | 1 punto per regola violata |
Cosa contiene il rapporto
Un punteggio e una valutazione
Il punteggio è pari a 100 meno i pesi indicati sopra, conteggiati una volta per ogni regola violata e non per ogni elemento. Le valutazioni sono A da 90, B da 75, C da 60, D da 40 e F al di sotto. È una nostra sintesi di una singola pagina, non un livello di conformità alle WCAG.
Le regole violate
Fino a 15 regole, dalla più grave, ciascuna con il relativo impatto, le etichette WCAG, un collegamento alla pagina di assistenza della regola e fino a 5 elementi di esempio. La sezione viene aggiunta a report.md.
Un conteggio delle verifiche che richiedono un intervento umano
axe-core contrassegna alcune verifiche come incomplete quando non può determinare l’esito. Il rapporto le conta e indica che richiedono una revisione umana.
Cosa non individuano le verifiche automatiche
Una verifica automatica individua solo una parte dei problemi di accessibilità di una pagina. Un risultato senza problemi non significa che la pagina sia accessibile e Nexus StudioQA non certifica la conformità alle WCAG.
Il significato, non solo il markup
Una regola può rilevare che un’immagine ha un testo alternativo. Non può valutare se il testo descrive l’immagine o se il testo di un collegamento ha senso fuori contesto.
Uso con una tastiera o un lettore di schermo
Per stabilire se l’ordine di lettura è sensato e se la pagina è utilizzabile con la sola tastiera o con un lettore di schermo, serve una persona che la provi.
Un solo stato della pagina per test
La verifica viene eseguita sulla pagina in cui termina il test. Una pagina che il test non raggiunge mai, o uno stato chiuso prima della fine, non vengono verificati.
Domande frequenti
I test automatici sostituiscono una verifica manuale dell’accessibilità?
No. Rilevano le violazioni delle regole valutabili da una macchina ed elencano le altre come da rivedere. Usali per prevenire regressioni tra una verifica manuale e l’altra, non per sostituirle.
Un problema di accessibilità farà fallire la compilazione?
Non per impostazione predefinita. I problemi sono elencati nel rapporto. Con
NEXUS_A11Y_STRICT=true, un test superato con una violazione pari o superiore alla soglia di errore riporta A11Y_VIOLATION, che restituisce comunque il codice di uscita 0 in CI.Quale versione delle WCAG verifica?
WCAG 2.1 AA per impostazione predefinita. Le impostazioni offrono le versioni 2.0 e 2.1 ai livelli A e AA, e la 2.2 AA. Su uno schermo tattile, si aggiunge WCAG 2.2 AA.
Funziona con i miei test esistenti?
Sì. Si esegue insieme alle asserzioni dei test Playwright, Selenium o pytest eseguiti tramite Nexus StudioQA, con
--a11yper una singola esecuzione o con l'impostazione attiva per tutte. Impostazioni di accessibilità
Eseguilo sulla tua macchina.
Prova gratis tutte le funzionalità, sulle tue macchine. Non serve una carta.