Instruções para WebDriverJS e JavaScript

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard

Configurando seus testes com WebDriverJS e JavaScript

Not for use with personal data
  1. 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
  2. No seu arquivo ou arquivos de teste, importe a função webdriverConfig(), a função wrapWebdriver() e a classe WebdriverController de @axe-core/watcher/webdriver:

    const {
      webdriverConfig,
      wrapWebdriver,
      WebdriverController
    } = require('@axe-core/watcher/webdriver')
  3. Atualize seu código de configuração de teste (normalmente em um bloco before ou beforeAll), especificando as opções do Chrome ao instanciar sua instância de browser, fornecendo sua chave de API:

    // Original code:
    let browser = await new Builder()
      .forBrowser('chrome')
      .build()
    
    // Becomes:
    const ACCESSIBILITY_API_KEY = process.env.ACCESSIBILITY_API_KEY
    const PROJECT_ID = process.env.PROJECT_ID
    const SERVER_URL = process.env.SERVER_URL
    
    let browser = await new Builder()
      .forBrowser('chrome')
      .setChromeOptions(
        webdriverConfig({
          axe: {
            apiKey: ACCESSIBILITY_API_KEY,
            projectId: PROJECT_ID,
            serverURL: SERVER_URL
          }
        }
      )
      .build()

    Certifique-se de definir ACCESSIBILITY_API_KEY e PROJECT_ID no seu ambiente para a sua chave API pessoal (encontrada na sua conta axe, aba **API KEYS**) e para o ID do seu projeto (mostrado na parte superior destas instruções quando você criou o seu projeto ou disponível na página Projetos ao escolher **Configurar projeto** em **Configurações**). Se a sua organização usa uma instância regional, em nuvem privada ou local do Axe Developer Hub, também defina SERVER_URL para 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.

  4. Crie uma instância de WebdriverController:

    const controller = new WebdriverController(browser)
  5. Envolva sua instância de browser com a função wrapWebdriver():

    browser = wrapWebdriver(browser, controller)
  6. Por fim, certifique-se de que todos os resultados dos testes do axe Watcher sejam eliminados. Para fazer isso, adicione o seguinte bloco de código ao seu código de finalização de teste (normalmente em um bloco afterEach):

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