Sobre el proyecto

axe-core es un motor de pruebas de accesibilidad para sitios web y otras interfaces de usuario basadas en HTML. Está diseñado para ser rápido, ligero e integrarse con entornos de prueba existentes, de modo que las comprobaciones de accesibilidad puedan ejecutarse junto con las pruebas funcionales regulares. Reglas y cobertura El motor implementa reglas para WCAG 2.0, 2.1 y 2.2 en niveles A, AA y AAA, junto con comprobaciones de mejores prácticas, como asegurar que una página tenga un encabezado h1 y evitar errores comunes de ARIA. El proyecto afirma que axe-core puede encontrar en promedio el 57% de los problemas WCAG automáticamente, y devuelve elementos como "incompletos" cuando no puede estar seguro, indicando que se necesita revisión manual. Se proporciona una lista completa de reglas agrupadas por nivel WCAG y mejores prácticas en la documentación del repositorio. Primeros pasos Instala el paquete con npm o pnpm como dependencia de desarrollo, incluye axe.min.js en cada iframe de los accesorios o sistema de prueba, y llama a axe.run() en puntos donde nueva UI se hace visible. La promesa se resuelve con resultados; las violaciones pueden inspeccionarse y usarse para fallar una prueba. El paquete API consiste en axe.js y un axe.min.js minificado. Filosofía e integración La filosofía declarada del proyecto es que las pruebas de accesibilidad automatizadas ahorran tiempo, no requieren experiencia especial y permiten a los equipos enfocar recursos expertos en problemas que los necesitan. Axe pretende funcionar con navegadores, herramientas y entornos de prueba modernos, y ser configurable. Soporta accesorios en memoria, accesorios estáticos, pruebas de integración e iframes anidados, y determina automáticamente qué reglas ejecutar según el contexto de evaluación. El proyecto afirma cero falsos positivos aparte de errores. Soporte de navegadores La API soporta completamente Microsoft Edge v40+, Google Chrome v42+, Mozilla Firefox v38+, Apple Safari v7+ e Internet Explorer v11 (obsoleto). Solo Chrome y Firefox se prueban en cada solicitud de extracción. El soporte de JSDOM es limitado; se sabe que la regla de contraste de color no funciona allí. Los entornos deben soportar de forma nativa las características requeridas o aplicar polyfills correctamente; la implementación obsoleta de Shadow DOM v0 no se soporta. Localización Axe puede construirse en un idioma local añadiendo un archivo JSON de locale al directorio locales y compilando con una bandera --lang, o con --all-lang para todos los locales. Las traducciones pueden generarse con un script de traducción y aplicarse en tiempo de ejecución mediante axe.configure() con un objeto locale. Los locales contribuidos por la comunidad incluyen azerbaiyano, vasco, chino simplificado y tradicional, danés, neerlandés, francés, alemán, griego, hebreo, italiano, japonés, coreano, noruego bokmål, polaco, portugués brasileño, español y sueco; no se garantiza su completitud. Lanzamientos y seguridad Nuevas versiones menores aparecen cada tres a cinco meses, generalmente añadiendo reglas y funciones. Se proporcionan actualizaciones de seguridad para líneas de versiones menores de hasta 18 meses de antigüedad. La documentación cubre la política de lanzamiento y soporte y la compatibilidad hacia atrás. Licencia y comunidad Axe-core se distribuye bajo la Licencia Pública de Mozilla 2.0 y agrupa dependencias de terceros bajo sus propios términos. Es respaldado activamente por Deque Systems, un importante proveedor de accesibilidad. El repositorio incluye guías para proponer reglas, arquitectura y contribución, más una lista de proyectos que usan axe-core. El uso de marcas comerciales se rige por la política de marcas de Deque.