Capturar Capturas de Tela de Violações

Quando o Axe Watcher encontra violações de acessibilidade, ele pode capturar uma captura de tela da página naquele momento. As capturas de tela são enviadas para o Axe Developer Hub e podem, opcionalmente, ser salvas em um diretório local para inspeção durante o desenvolvimento.

A captura de tela está disponível para todas as integrações JavaScript e TypeScript (Playwright Test, Cypress, WebdriverIO, WebDriverJS e Puppeteer) e ambas as integrações Java (Selenium e Playwright).

As capturas de tela são visualizáveis automaticamente na página de problemas do Developer Hub para o resultado afetado, nenhuma configuração adicional é necessária.

Habilitar Captura de Tela

JavaScript ou TypeScript:

Defina takeScreenshots: true no seu AxeConfiguration:

axe: {
  takeScreenshots: true
}

Java:

Chame setTakeScreenshots(true) em AxeWatcherOptions:

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

Salvar Capturas de Tela Localmente

Você também pode salvar capturas de tela em um diretório na sua máquina local. Isso é útil para revisar violações enquanto os testes estão sendo executados localmente, sem abrir o Axe Developer Hub.

JavaScript ou TypeScript:

Adicione screenshotDir ao seu AxeConfiguration:

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

Java:

Chame setScreenshotDir() em AxeWatcherOptions:

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

setScreenshotDir não tem efeito a menos que setTakeScreenshots(true) também esteja definido. Caminhos relativos são resolvidos em relação ao diretório de trabalho da JVM. Se o diretório não existir, o Watcher o cria. Se a criação do diretório ou a gravação do arquivo falhar, um aviso é registrado e a suíte de testes continua.

As capturas de tela são gravadas usando este padrão de nome de arquivo: YYYYMMDDTHHmmssSSS-{id}.png. O prefixo de timestamp mantém os arquivos ordenados por tempo de captura e evita colisões quando várias capturas de tela são feitas na mesma execução de teste.

Consulte setTakeScreenshots e setScreenshotDir na referência da API Java para obter detalhes completos dos parâmetros.