Configuración
Cada runner toma el mismo objeto engineOptions plano: sin archivo de configuración que mantener, sin una superficie de flags separada solo para la CLI que sincronizar. La CLI y cada integración (binding) simplemente construyen ese objeto por ti a partir de sus propios flags o métodos constructores, así que lo que aprendas aquí se aplica en cualquier sitio donde ejecutes un análisis. Vale la pena acertar pronto en cuatro cosas:
Opciones del motor
Limita un análisis exactamente a las reglas que quieres: nombrando una versión y un nivel de WCAG (WCAG 2.2 AA en una sola opción, con las buenas prácticas encima si las quieres), por ID, por etiqueta o nombrando un perfil de conformidad como WCAG 2.1 AA, para cualquier versión y nivel de WCAG, para que una ejecución informe solo de lo que realmente eres responsable, ni más ni menos. Juzga un análisis con varios perfiles a la vez, WCAG junto a WAI-ARIA o tu propia política, y mira qué hace cada uno de cada hallazgo. Los perfiles EN 301 549 de core siguen funcionando, pero están obsoletos: esa norma viene ahora como un pack, y el perfil Section 508, que solo es WCAG 2.0 AA con otro nombre, deja paso a wcag20-aa. Ejecuta solo unas pocas comprobaciones y obtén igualmente los criterios de WCAG a los que pertenecen, en el nivel que se te exige, y enumera lo que informará un análisis antes de ejecutarlo. Silencia widgets globalmente ruidosos conocidos o para una sola regla sin perder cobertura en el resto, ajusta cuán agresivas son las comprobaciones de contraste para un auditor humano frente a una puerta de CI desatendida, e incorpora una regla propia de tu organización junto a las incorporadas cuando el catálogo no cubre algo que te importa, y pasa a las reglas el CSS de una hoja de estilo de otro origen que la página no puede leer. Ver Opciones del motor para la referencia completa.
Packs
Prueba contra más que WCAG sin bifurcar el motor. Un pack trae un estándar nacional, la política de accesibilidad de tu organización o unas cuantas reglas propias desde un paquete independiente, y el motor lo ejecuta igual que sus propias reglas: sus perfiles seleccionan qué se ejecuta, sus elementos de lista de comprobación devuelven un resultado cada uno, y todos los informes los muestran junto a los criterios de WCAG. El mismo pack funciona desde Node, cada integración, los test matchers y la CLI, y npx surea11y-pack new genera uno que pasa sus propias pruebas tal como sale. Un estándar puede archivar los hallazgos de una regla en los requisitos a los que pertenecen, y una regla de un pack puede explicar a una persona cómo responder lo que deja sin decidir, y cómo evaluar a mano cada requisito. Hay dos estándares listos para instalar: EN 301 549 y WAI-ARIA 1.2, que hace fallar lo que WAI-ARIA exige donde WCAG solo pregunta. Ver Packs para usar uno o escribir uno.
Integración con CI
Consigue una puerta de accesibilidad funcionando en tu pipeline de CI sin escribirla desde cero: plantillas listas para pegar de GitHub Actions y Bitbucket Pipelines que condicionan una compilación al propio código de salida de la CLI, establecen una línea base de las violaciones preexistentes de un sitio ya existente para que solo falles en las genuinamente nuevas, y suben resultados SARIF directamente a GitHub Code Scanning donde tu equipo ya mira. Las recetas para GitLab CI y Azure DevOps llevan los resultados a sus propias vistas de pruebas como JUnit, escrito por la CLI en el mismo paso, y un informe JUnit puede convertir en fallos los hallazgos sin decidir con tendencia a fallo, para que un fallo probable no pase como prueba omitida. Ver Integración con CI para las plantillas completas.
Locales
Entrega hallazgos que tu equipo realmente pueda accionar en el idioma que lea más rápido: cada título de regla y el resumen y la pista de cada ocurrencia se resuelven desde un diccionario basado en claves, con una alternativa elegante por cadena de texto al inglés en lugar de un vacío o un error. Hoy se incluyen cinco configuraciones regionales (inglés, francés, alemán, español, japonés), y un resultado siempre te dice exactamente qué configuración regional usó, así que nada se degrada en silencio sin que lo sepas. Los pasos para responder un hallazgo sin decidir («Cómo comprobarlo»), y los procedimientos de prueba para evaluar a mano cada criterio, llegan en los mismos cinco idiomas. Ver Locales para la cobertura y cómo aportar tu propio diccionario.