Configuración Global

Visión General de la Configuración Global

El panel de Global de Configuración de Axe proporciona una forma centralizada de gestionar y controlar la configuración de pruebas de accesibilidad en toda tu organización. Esta poderosa función permite a los administradores empresariales establecer estándares de prueba consistentes mientras ofrece a los equipos y desarrolladores individuales la flexibilidad que necesitan para trabajar eficazmente.

¿Qué es la Configuración Global?

La configuración global (la pestaña Global de Axe Configuration) es un conjunto de controles que determinan cómo opera Axe Watcher durante las pruebas de accesibilidad. Estas configuraciones incluyen:

• Qué estándares de accesibilidad probar (como WCAG 2.1 AA o EN 301 549)
• Si incluir verificaciones de mejores prácticas
• Si habilitar reglas experimentales
• Qué versión de axe-core utilizar para las pruebas

Estas configuraciones pueden ser gestionadas tanto a nivel empresarial como a nivel de usuario individual, creando un entorno de pruebas flexible pero controlado.

¿Por Qué Usar la Configuración Global?

La configuración global resuelve varios desafíos comunes en las pruebas de accesibilidad en empresas:

• Consistencia: Asegurar que todos los equipos prueben contra los mismos estándares de accesibilidad
• Cumplimiento: Hacer cumplir requisitos de prueba específicos en toda tu organización
• Flexibilidad: Permitir que los equipos personalicen su enfoque de prueba dentro de parámetros aprobados
• Control de Versiones: Gestionar qué versiones de axe-core pueden usarse en los proyectos
• Garantía de Calidad: Mantener estándares de prueba mientras se habilitan optimizaciones específicas del equipo

Cómo Funciona la Configuración Global

Administradores

Los administradores establecen los valores predeterminados a nivel organizacional y definen qué configuraciones pueden modificar los usuarios a través de la propiedad configurationOverrides (JavaScript/TypeScript) o el método AxeWatcherOptions.setConfgurationOverrides() (Java). Estas configuraciones establecen la base para las pruebas de Axe Watcher dentro de la organización. Estos ajustes se cambian en el panel de Global de Configuración de Axe.

Usuarios

Los usuarios individuales personalizan Axe Watcher cambiando o agregando la opción configurationOverrides en su código de configuración de pruebas para elegir valores diferentes a los configurados por su administrador de la organización (pero solo para las configuraciones donde el administrador marcó la casilla de Permitir que los usuarios cambien).

La opción configurationOverrides interactúa con las configuraciones en el panel de Global según lo definido en la tabla de Escenarios Comunes de Configuración Global y Anulación de Configuración.

Las referencias de la API incluyen más información sobre (JavaScript/TypeScript) configurationOverrides o (Java) ConfigurationsOverrides y sus propiedades.

Escenarios Comunes de Configuración Global y Anulación de Configuración

Cuando se ejecuta una prueba, Axe Developer Hub combina configuraciones empresariales y de usuario para crear la configuración final de prueba. Esto asegura que todas las personalizaciones permanezcan dentro de parámetros aprobados mientras se da a los usuarios la flexibilidad necesaria.

La siguiente tabla ilustra escenarios comunes que encontrarás al trabajar con configuraciones globales. Cada escenario muestra cómo interactúan las configuraciones empresariales con la configuración de tu proyecto.

Entendiendo los Resultados

• ✅ Éxito: La configuración funciona como se esperaba
• ⚠️ Advertencia: La configuración funciona pero no se recomienda
• ❌ Error: La configuración fallará

Recomendaciones

1. Siempre preferir configurationOverrides sobre runOptions.
2. Verifique la configuración de su empresa antes de configurar las anulaciones.
3. Solo anule las configuraciones cuando sea necesario.
4. Use la configuración más simple que satisfaga sus necesidades.

Ejemplo de Anulación de Configuración

Aquí hay un ejemplo de configuración que demuestra anulaciones para cumplir con WCAG 2.1 AA, establecer axe-core a la versión 4.9.1 y permitir reglas experimentales y mejores prácticas:

const config = {
  axe: {
    apiKey: 'YOUR_API_KEY',
    projectId: 'YOUR_PROJECT_ID',

    configurationOverrides: {
      accessibilityStandard: 'WCAG 2.1 AA',
      axeCoreVersion: '4.9.1',
      experimentalRules: true,
      bestPractices: true
    }
};

Vea (JavaScript/TypeScript) ConfigurationOverrides Interfaz o (Java) ConfigurationOverrides Clase para una explicación de las propiedades.

Errores y Advertencias

Errores

Estándar No Permitido

Si intenta usar un estándar que no está permitido, recibirá un código de respuesta del servidor 422, Contenido No Procesable. Mensaje de ejemplo:

Error: Server responded to https://axe.deque.com/api-pub/watcher/sessions with status code 422: "error": "Invalid accessibility standard: WCAG 2.0 AA. Allowed options: EN 301 549, Trusted Tester v5"

Usando runOptions.runOnly con configurationOverrides

Si usa ambos runOptions.runOnly con configurationOverrides, sus pruebas fallarán de inmediato.

Advertencias

Usando runOptions con runOnly o rules

Si establece las propiedades runOnly o rules en el objeto runOptions, recibirá este mensaje:

This scan was created using runOptions. This may not be aligned with your organization's global configurations.

Usar ya sea runOnly o rules podría permitir que su código use reglas de accesibilidad que no están permitidas por la configuración global que utiliza su organización.

@axe-core/watcher Sin Soporte de Configuración Global

Si usa una versión de @axe-core/watcher que es demasiado antigua para soportar configuraciones globales, recibirá este mensaje:

Ver También

• Configuración de Axe
• (JavaScript/TypeScript) referencia de configurationOverrides
• (Java) ConfigurationOverrides Clase