Instalación de Axe DevTools para Web CLI

Axe DevTools CLI está disponible en dos formas. Elija la que se adapte a su entorno:

• Ejecutables: binarios autónomos sin requisitos previos
• Paquete de Node.js: instalados a través de npm o Yarn, requiere Node.js

Requisitos

Axe DevTools CLI requiere un controlador de navegador para cada navegador que desees usar. El controlador debe estar en tu PATH. Mantén tanto tu navegador como su controlador actualizados.

Instalar el ejecutable

Los ejecutables no tienen requisitos previos; Node.js no es necesario.

Descarga el ejecutable adecuado para tu plataforma desde el sección CLI de la página de descargas:

• axe-linux (Linux)
• axe-macos (macOS)
• axe-win.exe (Windows)

Configurar en Linux

Hacer el archivo ejecutable:

chmod +x axe-linux

Configurar en macOS

Hacer el archivo ejecutable, luego eliminar el atributo de cuarentena que macOS añade a los archivos descargados:

chmod +x axe-macos
xattr -d com.apple.quarantine axe-macos

Pruebe su instalación

Ejecute el comando de ayuda desde el directorio donde colocó el ejecutable:

• Linux: ./axe-linux --help
• macOS: ./axe-macos --help
• Windows: axe-win --help

Dependiendo de la configuración de su cuenta, puede que necesite privilegios de administrador.

Hacer que la CLI esté disponible globalmente

Para ejecutar axe desde cualquier directorio, coloca el ejecutable en un directorio de tu PATH.

Instalar mediante Node.js

Necesitas tener Node.js instalado. Para verificar, ejecuta node -v en tu terminal.

Paso 1: Obtenga un Token de Identidad de Agora

Agora es el registro npm privado de Deque que aloja paquetes @axe-devtools. Para acceder, necesitas un token de identidad.

1. Visita tu página de perfil de Agora. (Si eres redirigido después de iniciar sesión, haz clic en el enlace una segunda vez o haz clic en Editar perfil en la esquina superior derecha.)
2. Haz clic en Generar un Token de Identidad.
3. Opcionalmente, agregue una descripción para identificar el token más tarde.
4. Copie el token en su portapapeles. Guárdelo en un lugar seguro porque no podrá recuperarlo de Agora nuevamente.

Paso 2: Configura tu .npmrc

1. Visita la herramienta Configuración del acceso a los paquetes de Agora. Ninguna de la información que ingreses se almacena ni se transmite.
2. Ingrese su dirección de correo de Agora y el token de identidad.
3. Haz clic en Generar configuración y copia el resultado.
4. Pega las líneas copiadas en tu archivo ~/.npmrc (%USERPROFILE%/.npmrc en Windows).

Tu .npmrc debería verse así:

@axe-devtools:registry=https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:_auth="<generated-auth-string>"
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:email=<your-email@example.com>
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:always-auth=true

El valor de _auth es la codificación base64 de <your-email>:<your-identity-token>.

Paso 3: Instale el paquete

Instale globalmente con npm:

npm install -g @axe-devtools/cli

O con Yarn:

yarn global add @axe-devtools/cli

Pruebe su instalación

axe --help

Si aparece el texto de ayuda, el CLI está instalado y listo para usar.