Configurar temporizadores

Al ejecutar pruebas de accesibilidad con Axe Watcher, puede encontrarse con tiempos de espera, especialmente en páginas complejas, a través de redes lentas o en entornos de CI/CD con recursos limitados. Esta guía explica cómo configurar los valores de temporización para asegurar que sus pruebas se completen con éxito.

Comprender los tiempos de espera de Watcher

Axe Watcher se comunica con los servidores de Deque durante las ejecuciones de prueba y realiza operaciones de análisis que pueden variar en duración según la complejidad de la página. Cuatro operaciones tienen tiempos de espera configurables:

• analyze: Tiempo permitido para analizar la accesibilidad de una página (por defecto: 5000ms)
• flush: Tiempo permitido para enviar resultados al Centro de Desarrolladores de Axe (por defecto: 5000ms)
• start: Tiempo permitido para reanudar el autoanálisis (por defecto: 2000ms)
• stop: Tiempo permitido para pausar el autoanálisis (por defecto: 5000ms)

Si encuentra errores de tiempo de espera con Watcher, verá un mensaje similar a:

Error: Watcher could not send results to the server. To resolve this problem, adjust your `timeout.flush` property within your configuration or see [Troubleshooting](https://docs.deque.com/devtools-for-web/wa-troubleshooting) for more troubleshooting guidance.

Configuración para JavaScript y TypeScript

Para proyectos de JavaScript y TypeScript que utilicen el paquete @axe-core/watcher, puede configurar los tiempos de espera a través de la propiedad timeout en su objeto AxeConfiguration.

Configuración básica de temporización

const config = playwrightConfig({
  axe: {
    apiKey: process.env.API_KEY,
    projectId: process.env.PROJECT_ID,
    timeout: {
      analyze: 10000,  // 10 seconds
      flush: 15000,    // 15 seconds
      start: 5000,     // 5 seconds
      stop: 10000      // 10 seconds
    }
  }
});

Solo necesita especificar los tiempos de espera que desea sobrescribir; cualquier valor omitido usará sus valores predeterminados.

Consideraciones importantes para JavaScript/TypeScript

Los valores de tiempo de espera de Watcher son independientes de los tiempos de espera de su propio marco de prueba. Si está viendo fallos por tiempo de espera, puede que necesite ajustar ambos. El ejemplo a continuación muestra cómo configurar el tiempo de espera de Playwright para que coincida con el de Watcher.

// In your Watcher config
timeout: {
  analyze: 45000,
  flush: 20000
}

// Adjust the timeout for a single Playwright test.
test('basic functionality test', async ({ page }) => {
  test.setTimeout(45000);
  // ...
});

Si está encadenando comandos, asegúrese de que el tiempo de espera total de su prueba tome en cuenta la duración total de las operaciones.

Configuración para Java

El Watcher para Java actualmente no admite temporizaciones personalizadas. Los valores de tiempo de espera se configuran en la implementación de Java con los valores iniciales de JavaScript/TypeScript.

Soluciones para problemas de tiempo de espera en Java

Aunque no puede configurar directamente los tiempos de espera en Java, considere estos enfoques:

1. Optimizar la complejidad de la página: Si las páginas se agotan consistentemente durante el análisis, considere dividir las pruebas en casos de prueba más pequeños y enfocados que analicen menos estados de página.

2. Verificar condiciones de red: Asegúrese de tener una conectividad de red estable entre su entorno de prueba y los servidores de Deque, especialmente en las canalizaciones de CI/CD.

3. Contactar con el soporte de Deque: Si los problemas de tiempo de espera persisten, póngase en contacto con el equipo de soporte de Deque, ya que futuras versiones del Watcher para Java pueden incluir temporizaciones configurables.

Cuándo aumentar los tiempos de espera

Considere aumentar los valores de temporización cuando:

• Prueba de páginas con estructuras DOM grandes (miles de elementos)
• Ejecución de pruebas en entornos de CI/CD con recursos limitados
• Pruebas a través de conexiones de red de alta latencia
• Análisis de páginas con DOMs complejos
• Ejecución de múltiples procesos de prueba paralelos

Solución de errores de tiempo de espera

Si está experimentando errores de tiempo de espera:

1. Identifique qué operación está agotando el tiempo: El mensaje de error indica si es analyze, flush, start o stop.

2. Verificar otros problemas: Los tiempos de espera a veces pueden indicar problemas subyacentes como problemas de red, proxies mal configurados o páginas que no logran cargarse completamente.

3. Revisar la guía de solución de problemas: Consulte Solución de problemas para obtener orientación adicional.

Resumen

Para proyectos de JavaScript y TypeScript, configurar tiempos de espera apropiados asegura una ejecución fiable de las pruebas en diferentes entornos. Los usuarios de Java deben centrarse en optimizar la estructura de las pruebas y las condiciones de la red.