Instalación

Axe Watcher integra pruebas de accesibilidad en sus conjuntos de pruebas de extremo a extremo existentes. Esta guía cubre la instalación para las versiones del paquete en JavaScript/TypeScript y Java.

Requisitos del sistema

Antes de instalar Axe Watcher, asegúrese de que su entorno cumpla con estos requisitos:

• Compatibilidad con el idioma: Sus pruebas deben estar escritas en JavaScript, TypeScript o Java.

• Node.js (solo para JavaScript/TypeScript): Use una versión de Long Term Support (LTS) actualmente mantenida de Node.js.

• Java (solo para Java): Use una versión LTS actualmente mantenida de Java.

• Versiones de plataformas de automatización de navegadores: Axe Watcher admite la última versión o la versión principal anterior de cada plataforma compatible (excepto para Playwright y Playwright Test, que es la versión menor anterior y posteriores).

• Navegador: Watcher utiliza la última versión estable de Chrome para Testing o Chromium (con JavaScript/TypeScript o Java con Playwright, también puede usar Microsoft Edge). Tenga en cuenta que el navegador Electron integrado de Cypress no es compatible con Watcher, y deberá invocar Cypress con cypress run --browser chrome-for-testing --headless, cypress run --browser chromium --headless o cypress run --browser edge --headless.

• Acceso al registro npm (solo para JavaScript/TypeScript): Su entorno debe tener permiso para descargar e instalar paquetes de El registro npm.

• Acceso al repositorio Maven Central (solo para Java): Su entorno debe tener permiso para descargar e instalar paquetes de Maven Central.

• Repositorio Git (opcional pero recomendado): Usar Git le permite asociar resultados de accesibilidad con commits específicos y monitorear el progreso de accesibilidad de su proyecto con el tiempo.

Instalación de JavaScript y TypeScript

El paquete @axe-core/watcher está disponible en npm. Instálelo en el nivel raíz de su carpeta de pruebas utilizando su gestor de paquetes preferido:

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

O con yarn:

yarn add --dev @axe-core/watcher

O con pnpm:

pnpm add --save-dev @axe-core/watcher

Plataformas compatibles

El paquete de JavaScript/TypeScript es compatible con estas plataformas de automatización de navegadores (versión actual y una versión principal anterior):

• Cypress (incluidas pruebas de componentes)
• Playwright (se admite la versión menor anterior y posteriores)
• Playwright Test (se admite la versión menor anterior y posteriores)
• Puppeteer
• WebdriverIO
• WebdriverIO Testrunner
• WebDriverJS (Selenium)

Después de la instalación, siga las instrucciones específicas del marco de JavaScript o TypeScript en la documentación de Axe Watcher para configurar su conjunto de pruebas.

Instalación de Java

El paquete Java Watcher está disponible en Maven Central. Agregue la dependencia a su pom.xml:

<dependencies>
  <dependency>
    <groupId>com.deque.axe_core</groupId>
    <artifactId>watcher</artifactId>
    <version>4.0.0</version>
  </dependency>
</dependencies>

Actualice el número de versión según sea necesario para usar la última versión. Puede encontrar más información sobre las versiones disponibles del paquete en Maven Central.

Plataformas compatibles

El paquete Java es compatible con Selenium WebDriver (la versión actual y la versión principal anterior).

Próximos pasos

Una vez que haya instalado el paquete, deberá:

1. Crea un proyecto en Axe Developer Hub para obtener tu ID de proyecto
2. Modifica tu suite de pruebas según las instrucciones para tu marco de pruebas específico
3. Configura tus ACCESSIBILITY_API_KEY y PROJECT_ID como variables de entorno
4. Ejecuta tus pruebas y visualiza los resultados en Axe Developer Hub

Para obtener instrucciones detalladas de configuración específicas para tu marco de pruebas, consulta las páginas de documentación específicas del marco.