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: se instala a través de npm o Yarn, requiere Node.js

Requisitos

Axe DevTools CLI requiere un controlador de navegador para cada navegador que desee utilizar. El controlador debe estar en su PATH. Mantenga tanto su navegador como su controlador actualizados.

Instalar el ejecutable

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

Descargue el ejecutable apropiado para su plataforma desde la 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

Probar 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, coloque el ejecutable en un directorio de su PATH.

Instalar mediante Node.js

Necesita tener Node.js instalado. Para verificarlo, ejecute node -v en su terminal.

Paso 1: Obtenga un Token de Identidad de Agora

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

1. Visite su página de perfil de Agora. (Si es redirigido después de iniciar sesión, haga clic en el enlace una segunda vez o haga clic en Editar perfil en la esquina superior derecha.)
2. Haga 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: Configure su .npmrc

1. Visite la herramienta de Configuración del acceso a los paquetes de Agora . Ninguna de la información que ingrese se almacena o transmite.
2. Ingrese su dirección de correo de Agora y el token de identidad.
3. Haga clic en Generar configuración y copie el resultado.
4. Pegue las líneas copiadas en su ~/.npmrc archivo (%USERPROFILE%/.npmrc en Windows).

Su .npmrc debería lucir 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 _auth valor 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.