Capturer des captures d'écran de violations

Lorsque Axe Watcher trouve des violations d'accessibilité, il peut capturer une capture d'écran de la page à ce moment-là. Les captures d'écran sont téléchargées sur Axe Developer Hub et peuvent éventuellement être enregistrées dans un répertoire local pour inspection pendant le développement.

La capture d'écran est disponible pour toutes les intégrations JavaScript et TypeScript (Playwright Test, Cypress, WebdriverIO et Puppeteer) et les deux intégrations Java (Selenium et Playwright).

Activer la capture d'écran

JavaScript ou TypeScript :

Définissez takeScreenshots: true dans votre AxeConfiguration :

axe: {
  takeScreenshots: true
}

Java :

Appelez setTakeScreenshots(true) sur AxeWatcherOptions :

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

Enregistrer des captures d'écran localement

Vous pouvez également enregistrer des captures d'écran dans un répertoire sur votre machine locale. Cela est utile pour examiner les violations lors de l'exécution locale des tests, sans ouvrir Axe Developer Hub.

JavaScript ou TypeScript :

Ajoutez screenshotDir à votre AxeConfiguration :

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

Java :

Appelez setScreenshotDir() sur AxeWatcherOptions :

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

setScreenshotDir n'a aucun effet à moins que setTakeScreenshots(true) ne soit également défini. Les chemins relatifs sont résolus par rapport au répertoire de travail de la JVM. Si le répertoire n'existe pas, Watcher le crée. En cas d'échec de la création du répertoire ou de l'écriture du fichier, un avertissement est enregistré et la suite de tests continue.

Les captures d'écran sont enregistrées en utilisant ce modèle de nom de fichier : YYYYMMDDTHHmmssSSS-{id}.png. Le préfixe de l'horodatage garde les fichiers triés par date de capture et évite les collisions lorsque plusieurs captures d'écran sont prises lors de la même exécution de test.

Consultez setTakeScreenshots et setScreenshotDir dans la référence API Java pour des détails complets sur les paramètres.