Pa11y y axe para pruebas de accesibilidad

Pa11y y axe-core son herramientas de código abierto que automatizan las pruebas de accesibilidad alineadas con WCAG. Ambas analizan una página, ejecutan reglas sobre el DOM e informan de las infracciones. Detecte automáticamente la mayoría de los problemas de accesibilidad y reserve las pruebas manuales para el resto.

axe-core es una biblioteca de JavaScript que impulsa las auditorías de accesibilidad de Chrome DevTools, Lighthouse, Jest, Cypress, Playwright y muchas otras herramientas. Es el estándar de facto para las pruebas automatizadas de accesibilidad: amplia cobertura de reglas y una baja tasa de falsos positivos.

La extensión de navegador axe DevTools (Chrome, Firefox, Edge) añade una pestaña "Accessibility" a DevTools. Haga clic en "Scan all pages" y mostrará cada infracción con los elementos afectados, la gravedad y las instrucciones para corregirla. Es ideal para auditorías puntuales durante el desarrollo.

Pa11y es una CLI de Node.js: npx pa11y https://example.com audita una URL. Muestra una lista de problemas en la terminal. Utilícelo para auditorías rápidas, en scripts de shell o para una integración de CI de baja sobrecarga.

Combine axe-core con Playwright para realizar pruebas de accesibilidad de extremo a extremo: const results = await new AxeBuilder({ page }).analyze(). Compruebe que results.violations.length === 0. Así detectará las regresiones antes de que lleguen a producción.

jest-axe ejecuta axe sobre componentes renderizados en pruebas de Jest. Renderice el componente con React Testing Library y pase el contenedor a axe: expect(await axe(container)).toHaveNoViolations(). Ahora cada prueba de componente incluye una comprobación de accesibilidad.

Ambas herramientas permiten desactivar o modificar reglas por proyecto: desactive las reglas que entren en conflicto con decisiones de diseño intencionadas y aumente el nivel de exigencia de las reglas críticas conocidas. Documente cada regla desactivada con un comentario que explique el motivo, ya que los futuros desarrolladores necesitarán ese contexto.

Las herramientas automatizadas detectan aproximadamente entre el 30 % y el 40 % de los problemas de WCAG. El resto (un orden de foco significativo, texto alt comprensible, una jerarquía semántica de encabezados y un uso de ARIA que refleje el comportamiento real de la interfaz) requiere una revisión humana. La automatización es necesaria, pero no suficiente, para garantizar la accesibilidad.

Realice pruebas con NVDA en Windows, VoiceOver en Mac y JAWS para audiencias empresariales. Las pruebas con lectores de pantalla reales revelan problemas que la automatización no puede detectar: anuncios confusos, regiones de referencia rotas y un orden de foco ilógico. Una vez por versión en cada lector de pantalla principal es una línea base razonable.

La validación de accesibilidad más valiosa proviene de usuarios con discapacidad que utilizan el producto real. Reclútelos a través de consultorías de accesibilidad, servicios universitarios de apoyo a personas con discapacidad o plataformas de pruebas como UserTesting.com. Sus comentarios basados en la experiencia real detectan problemas que ninguna herramienta automatizada muestra.

Bloquee los PR que introduzcan regresiones de accesibilidad (infracciones nuevas), pero no los que contengan infracciones heredadas (incluidas en la línea base existente). Así se eleva el nivel sin impedir los lanzamientos. Realice un seguimiento del número total de infracciones a lo largo del tiempo como indicador adelantado del estado general de la accesibilidad.

Utilice varias herramientas: axe para la comprobación automatizada exhaustiva, Pa11y como segunda opinión y pruebas manuales con lectores de pantalla para cubrir la parte cualitativa. La superposición es reducida; juntas cubren más problemas de los que puede detectar cualquier herramienta por sí sola.

¿Qué porcentaje de los problemas de accesibilidad de WCAG pueden detectar de forma fiable herramientas automatizadas como axe y Pa11y?

axe-core impulsa la mayoría de las auditorías de accesibilidad; la extensión de navegador es excelente para comprobaciones puntuales, y las integraciones con jest-axe y Playwright, para pruebas continuas. Pa11y es una CLI complementaria. La automatización detecta aproximadamente entre el 30 % y el 40 % de los problemas; combínela con pruebas manuales con lectores de pantalla (NVDA, VoiceOver) y pruebas con usuarios con discapacidad reales para obtener una cobertura completa. Bloquee las regresiones nuevas en CI sin bloquear el desarrollo por la línea base heredada.