Acquisizione di Screenshot delle Violazioni

Quando Axe Watcher rileva violazioni di accessibilità, può acquisire uno screenshot della pagina in quel momento. Gli screenshot vengono caricati su Axe Developer Hub e possono opzionalmente essere salvati in una directory locale per ispezione durante lo sviluppo.

L'acquisizione degli screenshot è disponibile per tutte le integrazioni JavaScript e TypeScript (Playwright Test, Cypress, WebdriverIO e Puppeteer) e entrambe le integrazioni Java (Selenium e Playwright).

Attivare l'Acquisizione di Screenshot

JavaScript o TypeScript:

Imposta takeScreenshots: true nel tuo AxeConfiguration:

axe: {
  takeScreenshots: true
}

Java:

Chiama setTakeScreenshots(true) su AxeWatcherOptions:

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

Salvare Gli Screenshot Localmente

Puoi anche salvare gli screenshot in una directory sul tuo computer locale. Questo è utile per esaminare le violazioni mentre i test vengono eseguiti localmente, senza aprire Axe Developer Hub.

JavaScript o TypeScript:

Aggiungi screenshotDir al tuo AxeConfiguration:

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

Java:

Chiama setScreenshotDir() su AxeWatcherOptions:

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

setScreenshotDir non ha effetto a meno che anche setTakeScreenshots(true) non sia impostato. I percorsi relativi vengono risolti rispetto alla directory di lavoro della JVM. Se la directory non esiste, Watcher la crea. Se la creazione della directory o la scrittura del file fallisce, viene registrato un avviso e la suite di test continua.

Gli screenshot vengono scritti utilizzando questo modello di nome file: YYYYMMDDTHHmmssSSS-{id}.png. Il prefisso di timestamp mantiene i file ordinati per orario di acquisizione e previene collisioni quando vengono scattati più screenshot nella stessa esecuzione del test.

Consulta setTakeScreenshots e setScreenshotDir nella documentazione API Java per tutti i dettagli sui parametri.