Integrare axe-core nei test Playwright
Far fallire la build quando compaiono regressioni di accessibilità
Integrare axe-core nei test Playwright è una lezione Web Accessibility Academy gratuita su CoddyKit. Questa è la lezione 3 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Web Accessibility Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Web Accessibility Academy include 4 lezioni in totale.
Dalla scansione manuale al test automatizzato
Fare clic su un’estensione del browser è ottimo per una singola pagina. Per proteggere ogni pagina a ogni commit, integri axe-core nella suite di test automatizzati.
Perché Playwright
Playwright controlla un browser reale tramite codice, quindi axe viene eseguito sulla pagina esattamente come la vedono gli utenti, compresi i contenuti generati da JavaScript.
Il pacchetto ponte
Il pacchetto axe-core/playwright collega i due strumenti. Lo installi insieme a Playwright, così i test possono iniettare ed eseguire il motore axe.
npm install --save-dev @axe-core/playwrightImportare il builder
Nel file di test importi AxeBuilder. È l’helper che inietta axe-core nella pagina corrente e raccoglie i risultati al posto Suo.
import AxeBuilder from '@axe-core/playwright';Navigare, poi analizzare
Prima lasci che Playwright carichi la pagina, poi chiami analyze su un nuovo AxeBuilder per scansionare ciò che è attualmente visualizzato nel browser.
await page.goto('/');
const results = await new AxeBuilder({ page }).analyze();Verificare zero violazioni
Il risultato contiene un array violations. Una pagina conforme ha un array vuoto, quindi verifichi che la sua lunghezza sia zero per fare fallire il test in presenza di qualsiasi problema.
expect(results.violations).toEqual([]);Un caso di test completo
Mettendo insieme tutti gli elementi, ottiene un vero test di accessibilità che viene eseguito in CI come qualsiasi altra specifica di Playwright.
test('home page has no a11y violations', async ({ page }) => {
await page.goto('/');
const results = await new AxeBuilder({ page }).analyze();
expect(results.violations).toEqual([]);
});Testare dopo un’interazione
Il vero punto di forza è la scansione degli stati dinamici. Prima apra una finestra modale o espanda un menu, poi analizzi la pagina, così axe controlla l’interfaccia che gli utenti attivano realmente.
await page.getByRole('button', { name: 'Open menu' }).click();
const results = await new AxeBuilder({ page }).analyze();Limitare l’ambito
Può concentrare la scansione su una sola area con include, una soluzione utile quando testa un singolo componente senza il rumore del resto della pagina.
new AxeBuilder({ page }).include('#signup-form').analyze();Scegliere il set di regole
Usi withTags per eseguire solo le regole associate a uno standard, come i criteri WCAG 2.1 AA, così il test corrisponde all’obiettivo di conformità.
new AxeBuilder({ page }).withTags(['wcag2a', 'wcag2aa']).analyze();Ricordare i limiti
Anche i test Playwright con esito positivo coprono solo la parte dei problemi che può essere automatizzata. Completano i controlli manuali con lo screen reader; non li sostituiscono mai.
Controllo rapido
Ricordi come fare fallire un test in presenza di problemi di accessibilità.
Riepilogo: a11y nella pipeline
AxeBuilder inietta axe-core in un browser reale, Lei analizza ogni stato e verifica zero violazioni. Ora le regressioni di accessibilità interrompono automaticamente la compilazione. ✅
Impara HTML con un tutor IA — gratis
Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.
- Corsi
- 30
- Lezioni
- 120
Domande Frequenti
La lezione «Integrare axe-core nei test Playwright» è gratuita?
Sì — il testo completo di «Integrare axe-core nei test Playwright» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Web Accessibility Academy, passa a CoddyKit PRO. Il corso Web Accessibility Academy include 4 lezioni in totale.
Cosa imparerò in «Integrare axe-core nei test Playwright»?
Far fallire la build quando compaiono regressioni di accessibilità Eserciti Web Accessibility Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.
Ho bisogno di esperienza per iniziare Web Accessibility Academy?
Non è richiesta alcuna esperienza precedente. Web Accessibility Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 3 di 4.
Quanto tempo richiede la lezione «Integrare axe-core nei test Playwright»?
La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.
Posso scrivere ed eseguire codice in questa lezione Web Accessibility Academy?
Sì. Ogni lezione Web Accessibility Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.
Tutte le lezioni di questo corso
- Che cosa l'automazione può e non può rilevare
- Scansione con axe DevTools e Lighthouse
- Integrare axe-core nei test Playwright
- Linting e controlli CI per l'accessibilità