Importar e Inicializar con Java

Una vez que hayas instalado Axe DevTools para Web, necesitas importarlo a tu archivo de pruebas e inicializar la herramienta junto con su controlador web.

Requisitos previos

Para poder importar e inicializar Axe DevTools para Web, primero debe estar instalado. Si no lo has hecho aún, lee la guía sobre cómo instalarlo desde un paquete, desde tu repositorio de artefactos, o desde el Agora de Deque. También necesitas un Selenium WebDriver descargado y configurado de tu elección.

Importación

Para usar Axe DevTools se deben importar varios paquetes. Dependiendo de tu configuración, estos paquetes pueden variar. Deque ofrece cuatro integraciones con Java:

• Selenium (Escribiendo pruebas usando Selenium y Referencia de la API de Java Selenium)
• Hamcrest (Escribiendo pruebas usando Hamcrest y Referencia de la API de Hamcrest)
• Cucumber (Escribiendo pruebas usando Cucumber)
• Playwright (Usando Playwright y Referencia de la API de Playwright)

Declaraciones de importación para la configuración de Selenium

Para usar Axe DevTools con Selenium sigue esta sección de la guía. Usa esta configuración si no estás acoplando Axe DevTools con una biblioteca de aserciones existente y en su lugar escribes tus propias pruebas. Además, se requerirán declaraciones de importación para el controlador web de tu elección.

El único paquete que es obligatorio importar es el paquete Selenium de Axe DevTools. Este es el que se comunica entre Axe DevTools y el Selenium WebDriver para ejecutar los análisis.

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

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

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

Declaraciones de importación para Hamcrest

Para entornos de prueba que usan Hamcrest, sólo se deben importar dos paquetes. El primer paquete contiene todo lo necesario para análisis estándar.

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

El segundo paquete añade la capacidad de delimitar los análisis por selectores. Para usar esta funcionalidad, se requiere la importación adicional de este paquete.

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

Declaraciones de importación para Cucumber

Para emparejar Axe DevTools con Cucumber, sólo se requiere un paquete de importación.

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

Declaraciones de importación para Playwright

Necesitas importar dos paquetes para usar la integración con Playwright.

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

También necesitas importar los paquetes de Playwright de Microsoft.

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

Inicialización (no Playwright)

Después de añadir las declaraciones de importación de los paquetes requeridos a tu archivo de prueba, necesitarás 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 usa ChromeDriver, pero otros controladores de navegador como GeckoDriver funcionan igualmente bien.

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

Además, si necesitas un objeto generado de resultados y/o un reporte, se debe importar un objeto Selenium de Axe, como se describió anteriormente, y ser inicializado

AxeSelenium axeSelenium = new AxeSelenium();

Inicialización de Playwright

Para inicializar Playwright, construyes un nuevo objeto Playwright, lo usas para crear un nuevo objeto Navegador, y finalmente usas el objeto Navegador para crear un 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 pasos

Una vez que hayas instalado, importado e inicializado Axe DevTools, estás listo para pasar a la exploración de accesibilidad y escribir pruebas de accesibilidad. Para hacerlo, consulta la guía sobre escribiendo pruebas con Selenium, escribiendo pruebas con Hamcrest, escribiendo pruebas con Cucumber, o escribiendo pruebas con Playwright.

Solución de problemas

Si tienes problemas con la importación o inicialización de Axe DevTools, contacta a tu representante de Deque directamente, comunícate con nosotros a través de nuestro mesa de ayuda, o envíanos un correo electrónico. Estaremos encantados de ayudarte.