Lighthouse accessibility

Definizione — Lighthouse è uno strumento di audit (open source) integrato in Chrome/Chromium che valuta diversi ambiti, tra cui accessibilità. Lo use-case tipico è eseguire controlli automatici durante lo sviluppo o in pipeline CI per prevenire regressioni. Il risultato comprende uno score e una lista di opportunità/problemi con suggerimenti.

Come si esegue

• DevTools: Apri DevTools → tab Lighthouse → seleziona “Accessibility” → Analyze page load.
• CLI: npx lighthouse https://example.com --only-categories=accessibility --view
• CI (lighthouse-ci): esegui automaticamente sugli URL di preview/produzione e fallisci la build sotto una soglia.

Interpretazione dei risultati

• Lo score è un indicatore sintetico: utile per trend e gating, ma non esaurisce la conformità WCAG.
• I controlli coprono errori automatizzabili (es. alt mancanti, contrasti, nomi accessibili); alcuni item richiedono verifica manuale.
• Molti problemi derivano da componenti ripetuti: risolvi alla radice nel design system.

Buone pratiche di utilizzo

• Esegui Lighthouse in modalità autenticata (se serve) o su ambienti di staging con dati realistici.
• Affianca sempre test manuali (con screen reader e tastiera) e altri tool come axe-core e Pa11y.
• Monitora lo score nel tempo e imposta soglie minime (es. ≥ 95) come regola di merge.

Esempio di CI con lighthouse-ci (principio)

# package.json (script)
"ci:lh": "lhci autorun --collect.url=https://preview.example.com --assert.preset=lighthouse:recommended --assert.assertions.accessibility-score>=0.95"

Limiti

• Non sostituisce un audit completo sui 50 criteri WCAG 2.1 AA.
• Può mancare problemi legati a flusso, significato o interazione (ordine di focus, gestione modali, etichette contestuali).