Escrevendo Testes para Axe DevTools para Web para WebDriverJS

Escrevendo testes com Axe DevTools

Os trechos individuais nas seções abaixo são em JavaScript e eles compilam sem alterações no TypeScript. A seção Arquivo Completo de Exemplo fornece o teste completo em ambas as linguagens.

Pré-requisitos

Para testar páginas com Axe DevTools, primeiro você precisa importá-lo e inicializá-lo em seu projeto. Se ainda não completou esta etapa, veja este guia sobre como fazer isso.

Obtendo o Contexto da Varredura

Antes de poder fazer uma varredura de uma página para acessibilidade, ela precisa ser acessada pelo webdriver.

await driver.get('<URL>');

Uma vez que o webdriver tenha acessado a página, você pode escaneá-la com o Axe DevTools e salvar os resultados. A maneira mais simples de visualizar os resultados da varredura é registrar o objeto de resultados no console.

const results = await new AxeDevToolsBuilder(driver).analyze();
console.log(results);

Arquivo Completo de Exemplo

O mesmo teste é mostrado abaixo em JavaScript e TypeScript. A API do Axe DevTools é idêntica em ambos; a versão TypeScript usa a sintaxe import e anota o driver e os resultados da varredura.

JavaScript

const { AxeDevToolsBuilder } = require('@axe-devtools/webdriverjs');
const WebDriver = require('selenium-webdriver');

var driver = new WebDriver.Builder().forBrowser('chrome').build();

driver.get('https://google.com').then(function() {
  new AxeDevToolsBuilder(driver).analyze(function(err, results) {
    if (err) {
      // Handle error
    }
    console.log(results);
  });
});

TypeScript

import { AxeDevToolsBuilder } from '@axe-devtools/webdriverjs';
import { Builder } from 'selenium-webdriver';
import type { WebDriver } from 'selenium-webdriver';
import type { AxeResults } from 'axe-core';

(async () => {
  const driver: WebDriver = new Builder().forBrowser('chrome').build();

  try {
    await driver.get('https://google.com');
    const results: AxeResults = await new AxeDevToolsBuilder(driver).analyze();
    console.log(results);
  } finally {
    await driver.quit();
  }
})();

Próximos Passos

Agora que você completou com sucesso uma varredura de acessibilidade, está pronto para avançar para tópicos de escaneamento mais avançados como geração de relatórios e usando o objeto de resultados.

Resolução de Problemas

Se você tiver problemas para obter resultados de varredura, entre em contato diretamente com seu representante da Deque, alcance-nos através da nossa central de suporte, ou envie-nos um e-mail. Ficaremos felizes em ajudar.