Importar e Inicializar com Java

Depois de instalar o Axe DevTools para Web, você precisa importá-lo para o seu arquivo de teste e inicializar a ferramenta em conjunto com seu webdriver.

Pré-requisitos

Para importar e inicializar o Axe DevTools para Web, ele precisa estar instalado primeiro. Se ainda não o fez, leia o guia sobre como instalá-lo de um pacote, do seu repositório de artefatos ou do Agora da Deque. Você também precisará de um Selenium WebDriver baixado e configurado de sua escolha.

Importando

Para usar o Axe DevTools, vários pacotes precisam ser importados. Dependendo da sua configuração, esses pacotes podem variar. A Deque oferece quatro integrações Java:

• Selenium (Escrevendo Testes com Selenium e Referência da API Java Selenium)
• Hamcrest (Escrevendo Testes com Hamcrest e Referência da API Hamcrest)
• Cucumber (Escrevendo Testes com Cucumber)
• Playwright (Usando Playwright e Referência da API Playwright)

Declarações de Importação para Configuração do Selenium

Para usar o Axe DevTools com Selenium, siga esta parte do guia. Use esta configuração se não estiver acoplando o Axe DevTools com uma biblioteca de asserção existente e, em vez disso, escrever seus próprios testes. Além disso, serão necessárias declarações de importação para o webdriver de sua escolha.

O único pacote que é explicitamente necessário para ser importado é o pacote Selenium do Axe DevTools. É ele que comunica entre o Axe DevTools e o Selenium WebDriver para executar as varreduras.

import com.deque.html.axedevtools.selenium.*;

Para esta configuração, recomenda-se mais dois pacotes para permitir a geração e interpretação dos resultados. O pacote de resultados gera um objeto JSON contendo os resultados da varredura, e o pacote de relatórios permite a geração de relatórios em HTML, JUnit XML ou CSV dos resultados da varredura.

import com.deque.html.axedevtools.selenium.results.*;
import com.deque.html.axedevtools.selenium.reporter.*;

Declarações de Importação para Hamcrest

Para ambientes de teste que utilizam o Hamcrest, existem apenas dois pacotes que devem ser importados. O primeiro pacote contém tudo o que é necessário para varreduras padrão.

import com.deque.html.axedevtools.matchers.*;

O segundo pacote adiciona a capacidade de delimitar as varreduras por seletores. Para usar essa funcionalidade, é necessária a importação adicional deste pacote.

import com.deque.html.axedevtools.matchers.selectors;

Declarações de Importação para Cucumber

Para sincronizar o Axe DevTools com o Cucumber, apenas um pacote de importação é necessário.

import com.deque.html.axedevtools.cucumber.*;

Declarações de Importação para Playwright

Você precisa importar dois pacotes para usar a integração com o Playwright.

import com.deque.html.maven.axedevtools.playwright.AxePlaywrightBuilder;
import com.deque.html.maven.axedevtools.utility.axeresults.AxeResults; 

Você também precisa importar os pacotes Playwright da Microsoft.

import com.microsoft.playwright.Browser;
import com.microsoft.playwright.BrowserType;
import com.microsoft.playwright.Page;
import com.microsoft.playwright.Playwright;

Inicializando (não-Playwright)

Depois que as declarações de importação de pacotes necessários foram adicionadas ao seu arquivo de teste, você precisará inicializar o Axe DevTools com seu driver web para executar varreduras de acessibilidade. Usando a configuração padrão, este código inicializará o Axe DevTools. Este exemplo usa o ChromeDriver, mas outros drivers de navegador, como o GeckoDriver, funcionam igualmente bem.

WebDriver webdriver = new ChromeDriver();
AxeDriver axedriver = new AxeDriver(webdriver);

Além disso, se você precisar de um objeto de resultados gerado e/ou um relatório, um objeto Selenium do axe deve ser importado, conforme descrito acima, e inicializado

AxeSelenium axeSelenium = new AxeSelenium();

Inicializando Playwright

Para inicializar o Playwright, você constrói um novo objeto Playwright, usa-o para criar um novo objeto Navegador, e finalmente usa o objeto Navegador para criar um objeto Página.

Playwright playwright = Playwright.create();
Browser browser = playwright.chromium()
    .launch(new BrowserType.LaunchOptions().setHeadless(true));
Page page = browser.newPage();
page.navigate("https://dequeuniversity.com/demo/mars/");

Próximos Passos

Depois de instalar, importar e inicializar o Axe DevTools, você está pronto para passar para a verificação de acessibilidade e a escrita de testes de acessibilidade. Para fazer isso, veja o guia sobre escrevendo testes com Selenium, escrevendo testes com Hamcrest, escrevendo testes com Cucumber ou escrevendo testes com Playwright.

Solução de Problemas

Se você tiver problemas com qualquer uma das importações ou inicializações do Axe DevTools, entre em contato diretamente com seu representante Deque, fale conosco através do nosso suporte técnico ou envie-nos um e-mail. Ficaremos felizes em ajudar.