Gerar Relatórios

Quando você usa as APIs do Axe DevTools ou o CLI axe para testar acessibilidade, os resultados são salvos como arquivos JSON. Use o comando axe reporter para converter esses arquivos JSON em relatórios nos formatos HTML, JUnit XML, CSV ou universal. Você também pode filtrar os resultados por tipo antes de gerar um relatório.

• O Comando axe reporter
• Opções
• Resultados JSON no Disco

O Comando axe reporter

axe reporter <results-dir> [dest-dir] [options]

O <results-dir> é o diretório que contém os arquivos de resultados JSON. O opcional [dest-dir] é onde os relatórios são escritos; você também pode usar --dest para especificá-lo.

Gerar um relatório CSV a partir de resultados JSON:

axe reporter ./axe-results/ ./axe-reports/csv/ --format=csv

Gerar relatórios em múltiplos formatos de uma só vez:

axe reporter ./axe-results/ ./axe-reports/ --format=csv,html,junit

Opções

-d, --dest <path>

Especifica o diretório de saída para os relatórios gerados. Você também pode especificar o destino como o segundo argumento posicional.

-f, --format <type(s)>

Formato(s) de saída: html, junit (XML), csv ou universal. Para gerar vários formatos em uma única execução, forneça-os separados por vírgulas, espaços, pontos e vírgulas ou sinais de mais. O espaçamento ao redor dos separadores é ignorado.

O valor universal produz um arquivo JSON no Formato Universal Axe, que é um esquema padrão compartilhado entre os produtos Axe. Use as opções a seguir para controlar quais metadados são registrados na saída.

--universal-ruleset <id>

Especifica o ID do conjunto de regras a ser registrado nos metadados da saída no formato universal. O padrão é wcag2.1. Veja o tabela de conjuntos de regras para valores válidos.

--universal-best-practices

Registra bestPracticesEnabled=true nos metadados da saída no formato universal.

--filter <type(s)>

Filtra quais tipos de resultados incluir no relatório. Aceita um ou mais de: passes, violations, incomplete, inapplicable. Separe múltiplos valores com vírgulas e sem espaços. Requer --format csv.

# Include only violations and incomplete results
axe reporter ./axe-results/ --format=csv --filter violations,incomplete

# Include only passed checks
axe reporter ./axe-results/ --format=csv --filter passes

-b, --browser <name>

Quando um diretório de resultados contém resultados de vários navegadores, use esta opção para gerar um relatório apenas dos resultados de um browser. O nome deve corresponder ao navegador usado ao executar os testes, por exemplo, chrome ou firefox.

Resultados JSON no Disco

Entender como o CLI do Axe DevTools nomeia e organiza arquivos de resultados JSON é útil ao trabalhar com o comando axe reporter ou ao processar resultados programaticamente.

Estrutura de Diretório

Para cada projeto em um arquivo de definição, os resultados são salvos em um subdiretório nomeado pelo id do projeto, dentro do diretório de saída que você especificar:

<output-dir>/<project-id>/

Este subdiretório é criado automaticamente. Se ele já existir de uma execução anterior, é arquivado renomeando-o para <project-id>-<timestamp> antes da criação de um novo diretório.

Nomeação de Arquivos

Cada arquivo de resultado JSON é nomeado usando o id do projeto e um estado de página derivado da id da página e o opcional title da ação analyze:

<project-id>-<page-id>[-<analyze-title>].json

A id da página vem do campo id no pageList. Se id não estiver explicitamente definido em uma página, ele é derivado automaticamente da name da página removendo espaços.

O segmento analyze-title é acrescentado apenas quando um título é fornecido na ação analyze, ou quando uma página tem múltiplas chamadas analyze (neste caso, cada resultado recebe um sufixo único para evitar colisões).

Exemplo

Dado um projeto com id: "deque" e uma página com name: "Deque search" (sem id explícito), o ID da página derivado automaticamente é Dequesearch. Uma única chamada analyze sem título produz:

<output-dir>/deque/deque-Dequesearch.json

Com analyze the page with title "initial state":

<output-dir>/deque/deque-Dequesearch-initial state.json