Axe DevTools para Web para Testes Baseados em Node.js e Navegador
Visão geral das integrações de Node.js e JavaScript disponíveis com o Axe DevTools para Web
Esta página apresenta opções para desenvolvimento em Node.js e JavaScript com o Axe DevTools para Web. Cada entrada abaixo nomeia o pacote npm que documenta, para que você possa relacionar um pacote que tenha visto referenciado com seu guia.
Todos os pacotes listados abaixo trazem suas próprias declarações de tipo TypeScript, portanto não há um pacote @types/ separado para instalar e a API do Axe DevTools é a mesma em ambos os idiomas. Os guias de importação e escrita de testes para cada integração rotulam seus exemplos por idioma e fornecem um arquivo de exemplo completo tanto em JavaScript quanto em TypeScript.
Todos esses pacotes são instalados a partir do mesmo registro. Veja Instale o Axe DevTools para Web para Node.js a partir do Agora da Deque para instruções de autenticação e instalação.
Independente do pacote que você escolha, as verificações são realizadas de acordo com o nível AA do WCAG 2.1 por padrão, com as regras de melhores práticas e experimentais desativadas. Veja Personalizando Regras para alterar o conjunto de regras ou ativar as melhores práticas.
Integrações com frameworks de teste
Escolha o pacote que coincide com a ferramenta que seus testes já utilizam. Cada guia abrange a instalação, importação e inicialização, escrita de testes e a referência completa da API.
- JavaScript para Navegadores (
@axe-devtools/browser) - Cypress (
@axe-devtools/cypress) - Playwright JavaScript (
@axe-devtools/playwright) - Puppeteer (
@axe-devtools/puppeteer) - WebdriverIO (
@axe-devtools/webdriverio) - WebDriverJS (
@axe-devtools/webdriverjs)
Relatórios e registro de logs
Esses pacotes funcionam junto com qualquer uma das integrações de frameworks de teste acima.
- Node Reporter (
@axe-devtools/reporter): gera relatórios a partir dos resultados de acessibilidade. - Node Logger (
@axe-devtools/logger): registra os resultados de acessibilidade enquanto seus testes são executados.
Outras integrações
Elementos Personalizados e ElementInternals
A partir do Axe DevTools for Web 4.13.0, as verificações leem a semântica ARIA que os componentes da web declaram em JavaScript através de ElementInternals, em vez de somente os atributos role e aria-* presentes no markup. Não é necessária nenhuma configuração, e isso se aplica a todas as integrações nesta página. A semântica no DOM ainda tem precedência: um atributo role ou aria-* explícito no elemento sobrescreve o valor de ElementInternals.
Seus componentes devem publicar seus internos para que qualquer um desses efeitos ocorra, e um componente que os armazena em um campo de classe privada não pode ser lido. Veja Testando Elementos Personalizados que Usam ElementInternals.