Instruções para WebdriverIO e JavaScript

No nível raiz da sua pasta de testes, instale o pacote @axe-core/watcher e todas as suas dependências usando o npm ou seu gerenciador de pacotes preferido (por exemplo, yarn ou pnpm).

npm install --save-dev @axe-core/watcher

Nos seus arquivos de teste, importe a função wdioConfig(), a função wrapWdio() e a classe WdioController de @axe-core/watcher/wdio:

const {
  wdioConfig,
  wrapWdio,
  WdioController
} = require('@axe-core/watcher/wdio')

No seu código de configuração de teste (normalmente em um bloco before ou beforeAll), envolva qualquer código existente para criar uma instância de browser com uma chamada para wdioConfig(), fornecendo sua chave de API:

const ACCESSIBILITY_API_KEY = process.env.ACCESSIBILITY_API_KEY
const PROJECT_ID = process.env.PROJECT_ID
const SERVER_URL = process.env.SERVER_URL

const browser = await wdio.remote(
  wdioConfig({
    axe: {
      apiKey: ACCESSIBILITY_API_KEY,
      projectId: PROJECT_ID,
      serverURL: SERVER_URL
    }
  })
)

Certifique-se de configurar ACCESSIBILITY_API_KEY e PROJECT_ID no seu ambiente com sua chave de API pessoal (encontrada na sua Conta Axe, aba **API KEYS**) e o ID do seu projeto (mostrado no topo destas instruções quando você criou seu projeto ou disponível na página de Projetos escolhendo **Configurar projeto** em **Configurações**). Se sua organização usar uma instância regional, nuvem privada ou local do Axe Developer Hub, também configure SERVER_URL com a URL base dessa instância (por exemplo, https://axe-eu.deque.com); caso contrário, omita SERVER_URL e o padrão https://axe.deque.com será utilizado.

Uma vez que você tenha uma instância de browser, crie uma instância da classe WdioController:

const controller = new WdioController(browser)

Envolva sua instância browser com a função wrapWdio(), fornecendo a instância browser e a instância controller:

wrapWdio(browser, controller)

Por fim, assegure-se de que todos os resultados de teste do Axe Watcher sejam eliminados. Para fazer isso, adicione o seguinte bloco de código ao seu código de desmontagem de teste (tipicamente em um bloco afterEach):

afterEach(async () => {
  await controller.flush()
})