Automação de testes de acessibilidade com axe-core e WCAG.
A automação de testes de acessibilidade no Nexus StudioQA executa o axe-core na página em execução ao final de um teste e lista cada regra WCAG violada, com seu impacto e os elementos envolvidos. Por padrão, ela apenas emite avisos. No modo estrito, um teste aprovado com uma violação grave ou crítica recebe o resultado A11Y_VIOLATION. As verificações automatizadas encontram apenas parte dos problemas de acessibilidade, portanto não substituem uma revisão manual.
Pela equipe do Nexus StudioQA, Verdict System LLC.
Última atualização: .
O que é verificado e como ativar
A verificação fica desativada até você solicitá-la: --a11y para uma execução, ou NEXUS_A11Y_ENABLED=true para todas as execuções. Ela requer o complemento @axe-core/playwright; sem ele, o relatório indica “não medido” e o teste não é afetado.
| Configuração | Padrão | O que faz |
|---|---|---|
NEXUS_A11Y_ENABLED | false | Executa a auditoria do axe-core na página em que o teste termina. |
NEXUS_A11Y_STANDARD | wcag21aa | O conjunto de regras: wcag2a, wcag2aa, wcag21a, wcag21aa ou wcag22aa. |
NEXUS_A11Y_FAIL_LEVEL | serious | O menor impacto considerado uma violação: minor, moderate, serious ou critical. |
NEXUS_A11Y_STRICT | false | Quando definido como true, uma violação no nível de reprovação ou acima dele marca um teste aprovado como A11Y_VIOLATION. |
Como funcionam a pontuação e o resultado
A11Y_VIOLATION é um dos 15 resultados possíveis. Ele se aplica apenas a testes aprovados, retorna o código de saída 0 na CI, e o relatório e o Histórico mostram a ressalva. Um teste reprovado nunca tem seu resultado agravado, e a auditoria é ignorada nas execuções de caos. Uma tela sensível ao toque, emulada ou real, também é auditada segundo as WCAG 2.2 AA, que incluem o tamanho do alvo.
| Impact | Peso na pontuação |
|---|---|
| Crítico | 25 pontos por regra violada |
| Grave | 10 pontos por regra violada |
| Moderado | 4 pontos por regra violada |
| Leve | 1 ponto por regra violada |
O que o relatório contém
Uma pontuação e uma classificação
A pontuação é 100 menos os pesos acima, contabilizados uma vez por regra violada, e não por elemento. As classificações são A a partir de 90, B a partir de 75, C a partir de 60, D a partir de 40 e F abaixo disso. É um resumo próprio de uma única página, não um nível de conformidade com as WCAG.
As regras violadas
Até 15 regras, começando pelas mais graves, cada uma com seu impacto, suas etiquetas WCAG, um link para a página de ajuda da regra e até 5 elementos de exemplo. A seção é adicionada ao report.md.
Uma contagem das verificações que precisam de uma pessoa
O axe-core marca algumas verificações como incompletas quando não consegue chegar a uma conclusão. O relatório as contabiliza e informa que precisam de revisão humana.
O que as verificações automatizadas não encontram
Uma verificação automatizada encontra apenas parte dos problemas de acessibilidade de uma página. Um resultado sem problemas não significa que a página seja acessível, e o Nexus StudioQA não certifica a conformidade com as WCAG.
Significado, não apenas marcação
Uma regra pode identificar que uma imagem tem texto alternativo. Ela não consegue avaliar se o texto descreve a imagem, ou se o texto de um link faz sentido fora de contexto.
Uso com teclado ou leitor de tela
É preciso que uma pessoa teste para verificar se a ordem de leitura faz sentido e se a página pode ser usada apenas com o teclado ou com um leitor de tela.
Apenas um estado de página por teste
A auditoria é executada na página em que o teste termina. Uma página que o teste nunca alcança, ou um estado encerrado antes do fim, não é auditado.
Perguntas frequentes
Os testes automatizados substituem uma auditoria manual de acessibilidade?
Não. Eles identificam as violações de regras que uma máquina consegue avaliar e listam as demais como pendentes de revisão. Use-os para impedir regressões entre auditorias manuais, não para substituí-las.
Um problema de acessibilidade fará minha compilação falhar?
Não por padrão. Os problemas são listados no relatório. Com
NEXUS_A11Y_STRICT=true, um teste aprovado com uma violação no nível de reprovação ou acima dele recebe o resultado A11Y_VIOLATION, que ainda retorna o código de saída 0 na CI.Qual versão das WCAG é testada?
WCAG 2.1 AA por padrão. As configurações oferecem 2.0 e 2.1 nos níveis A e AA, e 2.2 AA. Em uma tela sensível ao toque, WCAG 2.2 AA é adicionado.
Funciona com meus testes existentes?
Sim. Ele é executado junto às asserções dos testes Playwright, Selenium ou pytest executados pelo Nexus StudioQA, com
--a11yem uma execução ou com a configuração ativada para todas. Configurações de acessibilidade
Execute na sua própria máquina.
Experimente todos os recursos gratuitamente, nas suas próprias máquinas. Não precisa de cartão.