Axe DevTools para CLI Web
Una herramienta de línea de comandos para automatizar pruebas de accesibilidad web sin escribir código de prueba.
Axe DevTools para CLI Web es una herramienta de línea de comandos que ejecuta análisis de accesibilidad en páginas web y genera informes. Está diseñada para equipos que desean automatizar las pruebas de accesibilidad sin integrar axe en un marco de pruebas existente, por ejemplo, como un paso en una canalización CI/CD, o cuando las API de Axe DevTools no están disponibles para su idioma.
Cómo Funciona
Cada axe análisis produce archivos de resultados JSON, uno por estado de página analizado. Estos archivos se producen durante las pruebas, y los utilizas al informar o subir resultados.
El flujo de trabajo típico tiene dos fases:
-
Analizar páginas: ejecuta una o más URL a través de
axey guarda los resultados JSON:axe <url> → test a URL directly axe spec <spec-file> → test pages and workflows defined in a YAML/JSON file axe bulk-spec <dir> → test using all spec files in a directory -
Hacer algo con los resultados: conviértelos, súbelos o envíalos a otro lugar:
axe reporter <results> → generate HTML, JUnit XML, or CSV reports axe bulk-reports <results> → upload to the Axe Reports service axe devhub <results> → send to Axe Developer Hub
Los axe y axe spec comandos también admiten --format y --report banderas para generar informes en un solo paso, sin una axe reporter invocación separada.
Comandos
| Comando | Propósito |
|---|---|
axe <url...> |
Analizar una o más URLs directamente. Navegador predeterminado: Firefox. Conjunto de reglas predeterminado: WCAG 2.1 AA. |
axe spec <spec-file> |
Analizar páginas definidas en un archivo de especificación YAML o JSON, incluidos flujos de trabajo de varios pasos. |
axe bulk-spec <dir> |
Ejecutar todos los archivos de especificación encontrados en un directorio y sus subdirectorios. |
axe reporter <results-dir> |
Convertir resultados JSON a informes HTML, JUnit XML o CSV. |
axe bulk-reports <results-dir> |
Subir resultados JSON al servicio de informes de Axe. |
axe devhub <results-dir> |
Enviar resultados JSON al Centro de Desarrolladores de Axe. |
axe ruleset |
Listar, validar o gestionar conjuntos de reglas personalizados. |
axe config-selenium |
Ver o actualizar los ajustes predeterminados del navegador/Selenium. |
Resultados JSON
Cuando ejecutas axe spec o utilizas axe <url> --save, los resultados se escriben como archivos JSON en el directorio de salida. Cada archivo captura el axe análisis completo para un estado de página único: violaciones, pasadas, comprobaciones incompletas y reglas no aplicables, junto con metadatos como la URL, el navegador y la marca de tiempo.
Los archivos de resultados se organizan por proyecto y se nombran según la página que se está probando:
<output-dir>/<project-id>/<project-id>-<page-id>[-<analyze-title>].jsonEstos archivos son consumidos por axe reporter, axe bulk-reports, y axe devhub. Para más detalles sobre el nombrado de archivos y la estructura de directorios, consulta Generar Informes.
El esquema de resultados JSON está definido por axe-core. Para una referencia completa, consulta la documentación de la API de axe-core.
En Esta Sección
- Comenzar: tareas comunes con ejemplos de trabajo
- Instalar: opciones de instalación (ejecutable o paquete Node.js)
- Analizar Páginas: todas las opciones para
axe <url> - Analizar Páginas Usando un Archivo Específico: estructura del archivo específico, acciones y procesamiento por lotes
- Generar Informes: formatos de informe, filtrado y estructura de resultados JSON
- Enviar a Axe Reports: subir resultados al servicio Axe Reports
- Enviar al Centro de Desarrolladores de Axe: integrar resultados con el Centro de Desarrolladores de Axe
- Configurar: selección de navegador, tiempos de espera y configuraciones persistentes
- Conjuntos de Reglas Personalizados: WCAG 2.x, Sección 508, y conjuntos de reglas personalizados