Axe DevTools per il Web per Node.js e Test Basati su Browser
Panoramica delle integrazioni Node.js e JavaScript disponibili con Axe DevTools per il Web
Questa pagina ti presenta opzioni per lo sviluppo di Node.js e JavaScript con Axe DevTools per il Web. Ogni voce qui sotto nomina il pacchetto npm che documenta, così puoi abbinare un pacchetto che hai visto menzionato alla sua guida.
Ogni pacchetto elencato di seguito include le proprie dichiarazioni dei tipi TypeScript, quindi non c'è nessun pacchetto @types/ separato da installare e l'API di Axe DevTools è la stessa in entrambe le lingue. Le guide di importazione e scrittura dei test per ogni integrazione etichettano i loro esempi per lingua e forniscono un file di esempio completo sia in JavaScript che in TypeScript.
Tutti questi pacchetti si installano dallo stesso registry. Vedi Installa Axe DevTools per il Web per Node.js da Agora di Deque per le istruzioni di autenticazione e installazione.
Qualunque sia il pacchetto scelto, le scansioni vengono eseguite per impostazione predefinita secondo WCAG 2.1 Livello AA, con le regole delle migliori pratiche ed esperimentali disattivate. Vedi Personalizzazione delle regole per modificare il set di regole o attivare le migliori pratiche.
Integrazioni con framework di test
Scegli il pacchetto che corrisponde allo strumento che i tuoi test usano già. Ogni guida copre installazione, importazione e inizializzazione, scrittura dei test, e il riferimento completo delle API.
- JavaScript per browser (
@axe-devtools/browser) - Cypress (
@axe-devtools/cypress) - Playwright JavaScript (
@axe-devtools/playwright) - Puppeteer (
@axe-devtools/puppeteer) - WebdriverIO (
@axe-devtools/webdriverio) - WebDriverJS (
@axe-devtools/webdriverjs)
Rapporti e registrazione
Questi pacchetti funzionano insieme a una qualsiasi delle integrazioni con framework di test sopra menzionate.
- Node Reporter (
@axe-devtools/reporter): genera report dai tuoi risultati di accessibilità. - Node Logger (
@axe-devtools/logger): registra i risultati di accessibilità mentre i tuoi test vengono eseguiti.
Altre integrazioni
Elementi personalizzati ed ElementInternals
A partire da Axe DevTools per Web 4.13.0, le scansioni leggono le semantiche ARIA che i componenti web dichiarano in JavaScript tramite ElementInternals, anziché solo gli attributi role e aria-* presenti nel markup. Non è richiesta alcuna configurazione e ciò si applica a ogni integrazione su questa pagina. Le semantiche nel DOM hanno comunque la precedenza: un attributo esplicito role o aria-* sull'elemento sovrascrive il valore da ElementInternals.
I tuoi componenti devono pubblicare i loro elementi interni affinché questo abbia effetto, e un componente che li memorizza in un campo privato della classe non può essere letto. Vedi Testare gli elementi personalizzati che utilizzano ElementInternals.