Tus pruebas siguen siendo Playwright, Selenium y pytest. No las reemplazamos. Las hacemos listas para la empresa, y tu código, tu evidencia y tu historial son tuyos.

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.

AjustePredeterminadoQué hace
NEXUS_A11Y_ENABLEDfalseEjecuta la auditoría de axe-core en la página donde termina la prueba.
NEXUS_A11Y_STANDARDwcag21aaEl conjunto de reglas: wcag2a, wcag2aa, wcag21a, wcag21aa o wcag22aa.
NEXUS_A11Y_FAIL_LEVELseriousEl impacto mínimo que cuenta como infracción: minor, moderate, serious o critical.
NEXUS_A11Y_STRICTfalseCuando 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.

ImpactPeso en la puntuación
Crítico25 puntos por regla incumplida
Grave10 puntos por regla incumplida
Moderado4 puntos por regla incumplida
Leve1 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 --a11y en 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.