Capturar capturas de pantalla de violaciones

Cuando Axe Watcher encuentra violaciones de accesibilidad, puede capturar una captura de pantalla de la página en ese momento. Las capturas de pantalla se suben al Axe Developer Hub y opcionalmente se pueden guardar en un directorio local para su inspección durante el desarrollo.

La captura de capturas de pantalla está disponible para todas las integraciones de JavaScript y TypeScript (Playwright Test, Cypress, WebdriverIO y Puppeteer) y ambas integraciones de Java (Selenium y Playwright).

Habilitar la captura de capturas de pantalla

JavaScript o TypeScript:

Configure takeScreenshots: true en su AxeConfiguration:

axe: {
  takeScreenshots: true
}

Java:

Llame a setTakeScreenshots(true) en AxeWatcherOptions:

AxeWatcherOptions options = new AxeWatcherOptions()
    .setApiKey(System.getenv("ACCESSIBILITY_API_KEY"))
    .setProjectId(System.getenv("PROJECT_ID"))
    .setTakeScreenshots(true);

Guardar capturas de pantalla localmente

También puede guardar capturas de pantalla en un directorio en su máquina local. Esto es útil para revisar violaciones mientras las pruebas se ejecutan localmente, sin abrir Axe Developer Hub.

JavaScript o TypeScript:

Agregue screenshotDir a su AxeConfiguration:

axe: {
  takeScreenshots: true,
  screenshotDir: './axe-screenshots'
}

Java:

Llame a setScreenshotDir() en AxeWatcherOptions:

AxeWatcherOptions options = new AxeWatcherOptions()
    .setApiKey(System.getenv("ACCESSIBILITY_API_KEY"))
    .setProjectId(System.getenv("PROJECT_ID"))
    .setTakeScreenshots(true)
    .setScreenshotDir("./axe-screenshots");

setScreenshotDir no tiene efecto a menos que también se configure setTakeScreenshots(true). Las rutas relativas se resuelven en relación con el directorio de trabajo de la JVM. Si el directorio no existe, Watcher lo crea. Si falla la creación del directorio o la escritura del archivo, se registra una advertencia y la suite de pruebas continúa.

Las capturas de pantalla se escriben usando este patrón de nombre de archivo: YYYYMMDDTHHmmssSSS-{id}.png. El prefijo de marca de tiempo mantiene los archivos ordenados por hora de captura y previene colisiones cuando se toman múltiples capturas de pantalla en la misma ejecución de prueba.

Consulte setTakeScreenshots y setScreenshotDir en la referencia de API de Java para obtener detalles completos de los parámetros.