axe

Qué es

axe, publicado como biblioteca JavaScript de código abierto
axe-core, es un conjunto de reglas automáticas de accesibilidad que
se ejecuta dentro de una página web, inspecciona lo renderizado por
el navegador e informa de cada elemento que incumple una regla. Lo
mantiene Deque Systems, empresa de accesibilidad, bajo Mozilla
Public License 2.0. Otras herramientas se apoyan en él: la categoría
de accesibilidad de Lighthouse de Chrome pondera las auditorías
según las clasificaciones de impacto de axe, y la propia guía de
Playwright ejecuta axe mediante un pequeño paquete complementario.

El motor es un único script. Un ejecutor de pruebas o una extensión
lo carga en la página y llama a `axe.run`; entonces recorre el
documento, incluidos marcos anidados y shadow DOM, aplicando todas
las reglas cuyas condiciones se cumplan. Como lee después de que el
navegador haya dispuesto la página, comprueba cosas que el código
fuente no revela: si el texto es visible, sobre qué color aparece y
si un elemento está oculto. Por eso algunas reglas requieren un
navegador real. El proyecto afirma que el contraste no funciona en
JSDOM, el documento simulado de muchos entornos de pruebas
unitarias.

Cada regla lleva etiquetas. Una señala la versión y nivel WCAG, como
`wcag2a`, `wcag2aa`, `wcag21aa` o `wcag22aa`, o indica
`best-practice` cuando ningún criterio la exige. Otras relacionan
reglas con EN 301 549, Section 508 o las reglas W3C de pruebas de
conformidad. Mediante esas etiquetas decide el equipo qué comprueba
cada ejecución.

El resultado no es un único aprobado o suspenso, sino cuatro listas:

  * `violations`: elementos que incumplieron una regla, cada uno con
impacto menor, moderado, grave o crítico, un resumen breve de la
solución y un enlace a una explicación más extensa.

  * `passes`: elementos que la superaron, lo que permite ver que una
regla llegó a ejecutarse.

  * `incomplete`, también llamada «needs review» en la
documentación: elementos que el motor no pudo aprobar ni rechazar
con certeza y que debe examinar una persona.

  * `inapplicable`: reglas sin nada que probar, como las de vídeo en
una página sin vídeo.

Por qué importa

axe ayuda a decidir qué partes de la accesibilidad delegar en una
máquina y si un fallo debe impedir una versión. Dos propiedades lo
hacen adecuado. Su ejecución es barata y permite comprobar cada
build en vez de auditar una vez al año. Además, sus autores declaran
el objetivo de cero falsos positivos, salvo errores del propio
motor: cualquier duda va a la lista de revisión, no a la de
infracciones. Una comprobación que da falsas alarmas acaba
desactivada; una que solo informa de lo demostrable puede detener un
build sin que nadie lo considere injustificado.

El límite es la cobertura. Deque dice que axe-core encuentra
automáticamente una media del 57 por ciento de los problemas WCAG y
devuelve resultados inciertos para su revisión manual. La cifra
describe los problemas detectados, no la proporción de criterios de
conformidad que puede evaluar una máquina.

Lo que queda fuera del alcance es sobre todo el juicio. axe puede
confirmar que una imagen tiene texto alternativo, que un botón tiene
nombre y que un campo de formulario tiene etiqueta. No puede
determinar si el texto describe la imagen, si el nombre dice qué
hace el botón o si la página tiene sentido al leerse en voz alta y
en orden. Esas preguntas necesitan una persona con lector de
pantalla y teclado, y el tiempo que una máquina ahorra en las
comprobaciones mecánicas es tiempo que esa persona puede dedicarles.

Elegir etiquetas tiene su propia contrapartida. Ejecutar solo las
WCAG da un resultado directamente vinculable a una declaración de
conformidad, y nada más. Añadir buenas prácticas detecta problemas
que WCAG no nombra pero el usuario encuentra: contenido fuera de
todas las regiones o una página sin encabezado principal. El coste
son algunos fallos que una auditoría de conformidad no citaría.

Cómo se aplica en la práctica

Dos páginas del sitio muestran qué se confía al motor.

En la batería de una plataforma acompaña a cuatro capas de pruebas.
Un control axe-core exige cero infracciones WCAG 2.0 y 2.1 A y AA,
convirtiendo la accesibilidad en fallo de build, no en hallazgo
meses después. La clave es el momento: corrige el defecto quien
acaba de escribirlo, mientras el cambio sigue abierto.

En este sitio, los créditos describen auditorías de páginas
representativas, una por plantilla en cada idioma, contra WCAG 2.2 A
y AA en ambos esquemas de color, como parte del control obligatorio
y no como informe aparte. Probar ambos permite que un fallo de
contraste solo visible en oscuro bloquee el build. El muestreo
supone que las páginas de una plantilla comparten estructura; así 38
páginas representaron un sitio de 2.268 en octubre de 2026. Las
reglas automatizadas no cubren todos los juicios que exige WCAG; por
eso el registro se mantiene por criterio, no como una nota de
aprobado.

Dónde surgen los problemas

La mayoría son fallos de confianza: una ejecución comprobó menos de
lo aparente o se interpreta el resultado más allá de lo que dice.

La lista de etiquetas omite reglas. Las etiquetas no son
acumulativas. `wcag2aa` solo contiene las reglas para los criterios
de nivel AA de WCAG 2.0, por lo que limitar una ejecución a ella
omite todas las reglas de nivel A; la documentación de la API dice
expresamente que hacen falta tanto `wcag2a` como `wcag2aa`. Del
mismo modo, `wcag21aa` solo contiene reglas de los criterios que
añadió 2.1, y una ejecución limitada a etiquetas WCAG nunca ejecuta
una regla `best-practice`. Las descripciones de las reglas enumeran
las de WCAG 2.2 como desactivadas por defecto, por lo que una
ejecución sin etiquetas las omite; nombrar su etiqueta las activa.
Enumere todas las etiquetas que deba cubrir la ejecución y conserve
la lista junto a la declaración que respalda:

```js
const results = await axe.run(document, {
    runOnly: {
        type: "tag",
        values: ["wcag2a", "wcag2aa", "wcag21a", "wcag21aa", "wcag22aa"],
    },
});
```

Una regla ausente de las cuatro listas no se ejecutó. Por eso
conviene leerlas cada vez que cambie la configuración.

Una ejecución limpia se interpreta como página accesible. Cero
infracciones significa que las reglas ejecutadas no pudieron
demostrar un fallo. No dice si el texto alternativo es correcto, el
orden de foco sensato o una persona con lector puede terminar la
tarea. Tómela como base y programe las comprobaciones que no puede
hacer.

Se descarta la lista de revisión. Un control que solo falla por
infracciones deja pasar `incomplete` sin que nadie lo vea. Son
elementos examinados y dejados sin decidir, precisamente los que más
necesitan atención humana. Envíelos a alguien que los lea o haga que
también detengan el build.

La página se prueba en un solo estado. El motor comprueba lo que
está renderizado en el momento en que se ejecuta. Un menú cerrado,
un diálogo sin abrir, un mensaje de error que aparece solo tras un
envío incorrecto y el otro esquema de color quedan fuera de una
ejecución contra la página tal como se carga por primera vez. Lleve
la página a cada estado importante y ejecute de nuevo el motor en
cada uno.

El motor corre donde no se dibuja nada. Un documento simulado carece
de disposición y color calculado. El proyecto enumera el contraste
entre las reglas que no funcionan allí. Las pruebas unitarias con
axe aún detectan problemas estructurales; el contraste y lo visual
pertenecen a un navegador real.

Se desactiva una regla para publicar. Apagarla para toda la
ejecución porque falla un componente oculta sus infracciones en los
demás, incluidas páginas futuras. Excluya solo ese elemento, con una
nota que explique por qué y cuándo debe retirarse la excepción.

Lecturas adicionales

  * axe-core — el código fuente del motor, sus principios declarados
y la lista de navegadores compatibles.

  * Descripciones de reglas — cada regla con su impacto y etiquetas,
agrupadas por versión WCAG, buenas prácticas, AAA, experimentales y
obsoletas.

  * API de axe-core — las etiquetas, la opción `runOnly`, cómo
incluir o excluir partes de una página y la estructura de las cuatro
listas de resultados.

  * Pruebas de accesibilidad — la guía de Playwright para ejecutar
axe dentro de las pruebas de navegador, incluido el análisis de una
página después de interactuar con ella.

hEsta página en la web	URL:https://engineer.company/es/glossary/axe/	engineer.company	70
