I tuoi test restano in Playwright, Selenium e pytest. Non li sostituiamo. Li rendiamo pronti per l'uso aziendale, e il codice, le evidenze e la cronologia restano di tua proprietà.

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.

ImpostazionePredefinitoCosa fa
NEXUS_A11Y_ENABLEDfalseEsegue la verifica con axe-core sulla pagina in cui termina il test.
NEXUS_A11Y_STANDARDwcag21aaIl set di regole: wcag2a, wcag2aa, wcag21a, wcag21aa o wcag22aa.
NEXUS_A11Y_FAIL_LEVELseriousL’impatto minimo da considerare una violazione: minor, moderate, serious o critical.
NEXUS_A11Y_STRICTfalseSe 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.

ImpactPeso nel punteggio
Critico25 punti per regola violata
Grave10 punti per regola violata
Moderato4 punti per regola violata
Lieve1 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 --a11y per 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.