Pa11y e axe para testes de acessibilidade

Pa11y e axe-core são ferramentas de código aberto que automatizam testes de acessibilidade alinhados à WCAG. Ambas analisam uma página, executam regras contra o DOM e relatam violações. Detecte automaticamente a maior parte dos problemas de acessibilidade; reserve os testes manuais para o restante.

axe-core é uma biblioteca JavaScript que fornece as auditorias de acessibilidade do Chrome DevTools, Lighthouse, Jest, Cypress, Playwright e muitas outras ferramentas. É o padrão de fato para testes automatizados de acessibilidade — ampla cobertura de regras e baixa taxa de falsos positivos.

A extensão de navegador axe DevTools (Chrome, Firefox, Edge) adiciona uma guia "Acessibilidade" ao DevTools. Clique em "Analisar todas as páginas" e ela listará cada violação com os elementos afetados, a gravidade e orientações de correção. É ideal para auditorias pontuais durante o desenvolvimento.

Pa11y é uma CLI do Node.js: npx pa11y https://example.com audita uma URL. Exibe uma lista de problemas no terminal. Use-a para auditorias rápidas, em scripts do shell ou na integração de baixa sobrecarga à CI.

Combine axe-core com Playwright para testes de acessibilidade de ponta a ponta: const results = await new AxeBuilder({ page }).analyze(). Verifique que results.violations.length === 0. Isso detecta regressões antes que cheguem à produção.

jest-axe executa o axe contra componentes renderizados em testes do Jest. Renderize o componente com a React Testing Library e passe o contêiner ao axe: expect(await axe(container)).toHaveNoViolations(). Agora, cada teste de componente inclui uma verificação de acessibilidade.

Ambas as ferramentas permitem desativar ou modificar regras por projeto: desative regras que entrem em conflito com decisões intencionais de projeto e aumente o rigor para regras conhecidas como críticas. Documente cada regra desativada com um comentário explicando o motivo — um contexto de que futuros desenvolvedores precisarão.

As ferramentas automatizadas detectam cerca de 30–40% dos problemas da WCAG. O restante (ordem de foco significativa, texto alternativo legível, hierarquia semântica de títulos e uso de ARIA que reflita o comportamento real da interface) exige revisão humana. A automação é necessária, mas não suficiente, para a acessibilidade.

Faça testes com NVDA no Windows, VoiceOver no Mac e JAWS para públicos corporativos. Testes reais com leitores de tela revelam problemas que a automação não consegue detectar — anúncios confusos, regiões danificadas e ordem de foco ilógica. Uma vez por versão em cada SR principal é uma linha de base razoável.

A validação de acessibilidade mais valiosa vem de usuários com deficiência usando o produto real. Recrute-os por meio de consultorias de acessibilidade, serviços universitários para pessoas com deficiência ou plataformas de teste como UserTesting.com. O feedback do mundo real detecta problemas que nenhuma ferramenta automatizada revela.

Bloqueie PRs por regressões de acessibilidade (novas violações), mas não por violações legadas (presentes na linha de base). Assim, o padrão de qualidade continua subindo sem bloquear a entrega. Acompanhe a contagem total de violações ao longo do tempo como um indicador antecedente da saúde geral da acessibilidade.

Use várias ferramentas: axe para a verificação automatizada abrangente, Pa11y como uma segunda opinião e testes manuais com leitores de tela para preencher a lacuna qualitativa. A sobreposição é pequena; juntas, elas cobrem mais problemas do que qualquer ferramenta isolada consegue encontrar.

Que porcentagem dos problemas de acessibilidade da WCAG pode ser detectada de forma confiável por ferramentas automatizadas como axe e Pa11y?

axe-core fornece a maioria das auditorias de acessibilidade; a extensão de navegador é excelente para verificações pontuais, e as integrações com jest-axe e Playwright são adequadas para testes contínuos. Pa11y é uma CLI complementar. A automação detecta cerca de 30–40% dos problemas; combine-a com testes manuais usando leitores de tela (NVDA, VoiceOver) e testes com usuários com deficiência para obter cobertura completa. Bloqueie novas regressões na CI sem bloquear a entrega por causa da linha de base legada.