Seus testes continuam em Playwright, Selenium e pytest. Não os substituímos. Nós os preparamos para uso empresarial, e você mantém a propriedade do seu código, das suas evidências e do seu histórico.

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çãoPadrãoO que faz
NEXUS_A11Y_ENABLEDfalseExecuta a auditoria do axe-core na página em que o teste termina.
NEXUS_A11Y_STANDARDwcag21aaO conjunto de regras: wcag2a, wcag2aa, wcag21a, wcag21aa ou wcag22aa.
NEXUS_A11Y_FAIL_LEVELseriousO menor impacto considerado uma violação: minor, moderate, serious ou critical.
NEXUS_A11Y_STRICTfalseQuando 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.

ImpactPeso na pontuação
Crítico25 pontos por regra violada
Grave10 pontos por regra violada
Moderado4 pontos por regra violada
Leve1 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 --a11y em 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.