Axe DevTools para Web para pruebas basadas en Node.js y navegador
Visión general de las integraciones de Node.js y JavaScript disponibles con Axe DevTools para Web
Esta página le presenta opciones para el desarrollo de Node.js y JavaScript con Axe DevTools para Web. Cada entrada a continuación nombra el paquete npm que documenta, para que pueda asociar un paquete que haya visto mencionado con su guía.
Cada paquete listado a continuación incluye sus propias declaraciones de tipos de TypeScript, por lo que no hay un paquete @types/ por separado para instalar y la API de Axe DevTools es la misma en ambos lenguajes. Las guías de importación y escritura de pruebas para cada integración etiquetan sus ejemplos por idioma y proporcionan un archivo de muestra completo tanto en JavaScript como en TypeScript.
Todos estos paquetes se instalan desde el mismo registro. Vea Instalar Axe DevTools para Web para Node.js desde Agora de Deque para instrucciones de autenticación e instalación.
Independientemente del paquete que elijas, las exploraciones se ejecutan contra las normas WCAG 2.1 Nivel AA de forma predeterminada, con las reglas de mejores prácticas y experimentales desactivadas. Consulta Personalización de reglas para cambiar el conjunto de reglas o activar las mejores prácticas.
Integraciones con marcos de prueba
Elija el paquete que coincida con la herramienta que sus pruebas ya utilizan. Cada guía cubre la instalación, importación e inicialización, escritura de pruebas y la referencia completa de la API.
- JavaScript para navegador (
@axe-devtools/browser) - Cypress (
@axe-devtools/cypress) - Playwright JavaScript (
@axe-devtools/playwright) - Puppeteer (
@axe-devtools/puppeteer) - WebdriverIO (
@axe-devtools/webdriverio) - WebDriverJS (
@axe-devtools/webdriverjs)
Informes y registros
Estos paquetes funcionan junto con cualquiera de las integraciones de marcos de prueba mencionadas anteriormente.
- Node Reporter (
@axe-devtools/reporter): genera informes a partir de sus resultados de accesibilidad. - Node Logger (
@axe-devtools/logger): registra los resultados de accesibilidad mientras se ejecutan sus pruebas.
Otras integraciones
Elementos personalizados y ElementInternals
A partir de Axe DevTools for Web 4.13.0, los análisis leen las semánticas ARIA que los componentes web declaran en JavaScript a través de ElementInternals, en lugar de solo los atributos role y aria-* presentes en el marcado. No se requiere configuración, y esto se aplica a cada integración en esta página. Las semánticas en el DOM aún tienen precedencia: un atributo explícito role o aria-* en el elemento anula el valor de ElementInternals.
Sus componentes deben publicar sus internos para que esto surta efecto, y un componente que los almacena en un campo de clase privado no puede ser leído. Ver Pruebas de elementos personalizados que usan ElementInternals.