Automatización de pruebas de accesibilidad con axe-core y las WCAG.
La automatización de pruebas de accesibilidad en Nexus StudioQA ejecuta axe-core sobre la página activa al finalizar una prueba y enumera cada regla WCAG incumplida, con su impacto y los elementos implicados. De forma predeterminada, es solo informativa. En modo estricto, una prueba superada con una infracción grave o crítica muestra A11Y_VIOLATION. Las comprobaciones automatizadas solo detectan parte de los problemas de accesibilidad, por lo que no sustituyen una revisión manual.
Por el equipo de Nexus StudioQA, Verdict System LLC.
Última actualización: .
Qué comprueba y cómo se activa
La comprobación está desactivada hasta que la solicites: --a11y para una ejecución, o NEXUS_A11Y_ENABLED=true para todas las ejecuciones. Requiere el complemento @axe-core/playwright; sin él, el informe indica “sin medir” y la prueba no se ve afectada.
| Ajuste | Predeterminado | Qué hace |
|---|---|---|
NEXUS_A11Y_ENABLED | false | Ejecuta la auditoría de axe-core en la página donde termina la prueba. |
NEXUS_A11Y_STANDARD | wcag21aa | El conjunto de reglas: wcag2a, wcag2aa, wcag21a, wcag21aa o wcag22aa. |
NEXUS_A11Y_FAIL_LEVEL | serious | El impacto mínimo que cuenta como infracción: minor, moderate, serious o critical. |
NEXUS_A11Y_STRICT | false | Cuando es true, una infracción que alcanza o supera el umbral de fallo marca una prueba superada como A11Y_VIOLATION. |
Cómo funcionan la puntuación y el veredicto
A11Y_VIOLATION es uno de los 15 veredictos. Solo se aplica a una prueba superada, devuelve el código de salida 0 en CI, y el informe y el Historial muestran la salvedad. Una prueba fallida nunca pasa a ese veredicto, y en las ejecuciones de caos se omite la auditoría. Una pantalla táctil, emulada o real, también se audita según las WCAG 2.2 AA, que añaden el tamaño del objetivo.
| Impact | Peso en la puntuación |
|---|---|
| Crítico | 25 puntos por regla incumplida |
| Grave | 10 puntos por regla incumplida |
| Moderado | 4 puntos por regla incumplida |
| Leve | 1 punto por regla incumplida |
Qué contiene el informe
Una puntuación y una calificación
La puntuación es 100 menos los pesos anteriores, que se contabilizan una vez por regla incumplida y no por elemento. Las calificaciones son A a partir de 90, B a partir de 75, C a partir de 60, D a partir de 40 y F por debajo de ese valor. Es nuestro propio resumen de una página, no un nivel de conformidad con las WCAG.
Las reglas incumplidas
Hasta 15 reglas, empezando por las más graves, cada una con su impacto, sus etiquetas WCAG, un enlace a la página de ayuda de la regla y hasta 5 elementos de ejemplo. La sección se añade a report.md.
Un recuento de las comprobaciones que requieren intervención humana
axe-core marca algunas comprobaciones como incompletas cuando no puede determinar el resultado. El informe las contabiliza e indica que necesitan revisión humana.
Qué no detectan las comprobaciones automatizadas
Una comprobación automatizada solo detecta parte de los problemas de accesibilidad de una página. Un resultado sin problemas no significa que la página sea accesible, y Nexus StudioQA no certifica la conformidad con las WCAG.
El significado, no solo el marcado
Una regla puede detectar que una imagen tiene texto alternativo. No puede juzgar si el texto describe la imagen, ni si el texto de un enlace tiene sentido fuera de contexto.
Uso con teclado o lector de pantalla
Para determinar si el orden de lectura tiene sentido y si la página puede usarse solo con un teclado o con un lector de pantalla, es necesario que una persona lo pruebe.
Solo un estado de página por prueba
La auditoría se ejecuta en la página donde termina la prueba. No se auditan las páginas a las que la prueba nunca llega ni los estados que se cerraron antes del final.
Preguntas frecuentes
¿Las pruebas automatizadas sustituyen una auditoría manual de accesibilidad?
No. Detectan las reglas que una máquina puede evaluar y señalan las demás como pendientes de revisión. Úsalas para evitar regresiones entre auditorías manuales, no para sustituirlas.
¿Un problema de accesibilidad hará que falle mi compilación?
No de forma predeterminada. Los problemas se enumeran en el informe. Con
NEXUS_A11Y_STRICT=true, una prueba superada con una infracción que alcanza o supera el umbral de fallo muestra A11Y_VIOLATION, que sigue devolviendo el código de salida 0 en CI.¿Qué versión de las WCAG comprueba?
WCAG 2.1 AA de forma predeterminada. La configuración ofrece 2.0 y 2.1 en los niveles A y AA, y 2.2 AA. En una pantalla táctil, se añade WCAG 2.2 AA.
¿Funciona con mis pruebas actuales?
Sí. Se ejecuta junto con las aserciones de las pruebas de Playwright, Selenium o pytest ejecutadas mediante Nexus StudioQA, con
--a11yen una ejecución o con la opción activada para todas. Configuración de accesibilidad
Ejecútalo en tu propia máquina.
Prueba gratis todas las funciones, en tus propios equipos. Sin tarjeta.