Importar e inicializar con Java

Una vez que haya instalado axe DevTools for Web, deberá importarlo a su archivo de prueba e inicializar la herramienta junto con su controlador web.

Prerrequisitos

Para importar e inicializar axe DevTools for Web, primero es necesario instalarlo. Si aún no lo has hecho, lee la guía sobre cómo instalarlo desde un paquete, desde tu repositorio de artefactos o desde el Ágora de Deque. También necesitarás un Selenium WebDriver de tu elección descargado y configurado.

Importación

Para utilizar axe DevTools es necesario importar varios paquetes. Dependiendo de su configuración, estos paquetes pueden variar. Deque ofrece cuatro integraciones de Java:

• Selenium (Escritura de pruebas con Selenium y Referencia de la API de Java Selenium)
• Hamcrest (Escritura de pruebas con Hamcrest y Referencia de la API de Hamcrest)
• Cucumber (Escritura de pruebas con Cucumber)
• Playwright (Uso de Playwright y Referencia de la API de Playwright)

Declaraciones de importación de configuración de Selenium

Para utilizar axe DevTools con Selenium siga esta parte de la guía. Utilice esta configuración si no está vinculando axe DevTools con una biblioteca de aserciones existente y en su lugar escribe sus propias pruebas. Además, se requerirán declaraciones de importación para el controlador web de su elección.

El único paquete cuya importación se requiere explícitamente es el paquete de axe DevTools para Selenium. Esto es lo que se comunica entre axe DevTools y Selenium WebDriver para ejecutar los escaneos.

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

Para esta configuración, se recomiendan dos paquetes más que le permitan generar e interpretar resultados. El paquete de resultados genera un objeto JSON que contiene los resultados del escaneo, y el paquete reporter permite la generación de informes HTML, JUnit XML o CSV de los resultados del escaneo.

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

Declaraciones de importación de Hamcrest

Para los entornos de prueba que utilizan Hamcrest, solo hay dos paquetes que deben importarse. El primer paquete contiene todo lo necesario para realizar escaneos estándar.

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

El segundo paquete agrega la capacidad de delimitar los escaneos mediante selectores. Para utilizar esta funcionalidad, se requiere la importación adicional de este paquete.

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

Declaraciones de importación de Cucumber

Para emparejar axe DevTools con Cucumber, solo se requiere un paquete de importación.

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

Declaraciones de importación de Playwright

Necesita importar dos paquetes para utilizar la integración de Playwright.

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

También es necesario importar los paquetes Playwright de Microsoft.

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

Initializing (non-Playwright)

Una vez que se hayan agregado las declaraciones de importación de paquetes necesarias a su archivo de prueba, deberá inicializar axe DevTools con su controlador web para ejecutar análisis de accesibilidad. Usando la configuración estándar, este código inicializará axe DevTools. Este ejemplo utiliza ChromeDriver, pero otros controladores de navegador como GeckoDriver funcionan igualmente bien.

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

Además, si necesita un objeto de resultados generados y/o un informe, se debe importar un objeto Selenium axe, como se describe anteriormente, e inicializarlo.

AxeSelenium axeSelenium = new AxeSelenium();

Inicializando Playwright

Para inicializar Playwright, se construye un nuevo objeto Playwright , se lo utiliza para crear un nuevo objeto Browser y, finalmente, se utiliza el objeto Browser para crear un objeto Page .

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 pasos

Una vez que haya instalado, importado e inicializado axe DevTools, estará listo para pasar a escanear en busca de accesibilidad y escribir pruebas de accesibilidad. Para ello, consulta la guía sobre cómo escribir pruebas con Selenium, cómo escribir pruebas con Hamcrest, cómo escribir pruebas con Cucumber o cómo escribir pruebas con Playwright.

Solución de problemas

Si tiene problemas con la importación o inicialización de axe DevTools, comuníquese directamente con su representante de Deque, contáctenos a través de nuestra mesa de soporte o envíenos un correo electrónico. Estaremos encantados de ayudarle.