Generar informes

Cuando utilizas las API de Axe DevTools o el CLI de axe para probar la accesibilidad, los resultados se guardan como archivos JSON. Usa el comando axe reporter para convertir esos archivos JSON en informes en formato HTML, JUnit XML, CSV o formato universal. También puedes filtrar los resultados por tipo antes de generar un informe.

• El Comando axe reporter
• Especifica el directorio de salida para los informes generados. En su lugar, puedes especificar el destino como el segundo argumento posicional.
• Entender cómo el CLI de Axe DevTools nombra y organiza los archivos de resultados JSON es útil al trabajar con el

El Comando axe reporter

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

El <results-dir> es el directorio que contiene los archivos de resultados JSON. El [dest-dir] opcional es donde se escriben los informes; también puedes usar --dest para especificarlo.

Generar informes en múltiples formatos a la vez:

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

Opciones

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

Especifica el directorio de salida para los informes generados. En su lugar, puedes especificar el destino como el segundo argumento posicional.

-d, --dest <path>

Formato(s) de salida:

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

Formato(s) de salida: html, junit (XML), csv o universal. Para generar múltiples formatos en una sola ejecución, proporciónalos separados por comas, espacios, puntos y comas o signos más. Se ignoran los espacios alrededor de los separadores.

El valor universal produce un archivo JSON en el Formato Universal de Axe, que es un esquema estándar compartido entre los productos Axe. Usa las opciones complementarias a continuación para controlar qué metadatos se registran en la salida.

--universal-ruleset <id>

Especifica el ID del conjunto de reglas para registrar en los metadatos de la salida en formato universal. Por defecto, es wcag2.1. Consulta tabla de conjuntos de reglas para ver los valores válidos.

--universal-best-practices

Registra bestPracticesEnabled=true en los metadatos de la salida en formato universal.

--filter <type(s)>

Filtra qué tipos de resultados incluir en el informe. Acepta uno o más de: passes, violations, incomplete, inapplicable. Separa múltiples valores con comas y sin espacios. Requiere --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>

Cuando un directorio de resultados contiene resultados de múltiples navegadores, usa esta opción para generar un informe a partir de los resultados de un solo navegador. El nombre debe coincidir con el navegador usado al ejecutar las pruebas, por ejemplo, chrome o firefox.

Entender cómo el CLI de Axe DevTools nombra y organiza los archivos de resultados JSON es útil al trabajar con el

Entender cómo el CLI de Axe DevTools nombra y organiza los archivos de resultados JSON es útil cuando se trabaja con el comando axe reporter o se procesan resultados programáticamente.

Para cada proyecto en un archivo de especificación, los resultados se guardan en un subdirectorio nombrado según el

Para cada proyecto en un archivo de especificaciones, los resultados se guardan en un subdirectorio nombrado después del id del proyecto, dentro del directorio de salida que especifiques:

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

Este subdirectorio se crea automáticamente. Si ya existe de una ejecución anterior, se archiva renombrándolo a <project-id>-<timestamp> antes de crear un nuevo directorio.

Nombrado de archivos

Cada archivo de resultados JSON se nombra usando el id del proyecto y un estado de la página derivado de la id de la página y el title opcional de la acción analyze:

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

La id de la página proviene del campo id en pageList. Si id no se establece explícitamente en una página, se deriva automáticamente de la name de la página eliminando los espacios.

El segmento analyze-title se añade solo cuando se proporciona un título en la acción analyze, o cuando una página tiene múltiples llamadas analyze (en cuyo caso cada resultado tiene un sufijo único para evitar colisiones).

Ejemplo

Dado un proyecto con id: "deque" y una página con name: "Deque search" (sin id explícito), el ID de página auto-derivado es Dequesearch. Una sola llamada analyze sin título produce:

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

Con analyze the page with title "initial state":

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