Instalar Axe DevTools para Web para Puppeteer desde el Agora de Deque

Para los clientes que no tienen un repositorio de artefactos interno y desean una solución más sostenible y escalable para la instalación que descargar directamente Axe DevTools, Deque pone su propio repositorio de artefactos a disposición de ciertos clientes. Para información sobre otras formas de instalar Axe DevTools, ve las guías sobre Instalación desde un paquete o Instalación desde tu repositorio de artefactos.

Requisitos previos

Para instalar Axe DevTools desde Agora, debes tener credenciales de inicio de sesión de Agora. Además, debes tener un proyecto web basado en NodeJS existente para instalar Axe DevTools. Dependiendo de la configuración de tu entorno de pruebas, puede ser necesario incluir tu biblioteca de pruebas como una dependencia adicional.

Creando un Token de Identidad

La forma más sencilla de crear un Token de Identidad es a través de la Aplicación web Agora. Una vez que inicies sesión, puedes crear un Token de Identidad haciendo clic en el botón etiquetado Bienvenido tu-dirección-de-correo en la barra superior junto al botón de ayuda. Desde allí, puedes crear y copiar tu Token de Identidad.

Agregando Autenticación

Para acceder a los paquetes de Axe DevTools a través de NPM o Yarn, necesitarás agregar tu información de autenticación de Agora a un archivo ~/.npmrc. La forma más sencilla de hacerlo es con un comando curl.

curl -u"<your-email>":<your-identity-token> "https://agora.dequecloud.com/artifactory/api/npm/auth"

Al ejecutar este comando, reemplaza con tu correo de inicio de sesión de Agora, y reemplaza con el Token de Identidad que copiaste en el paso anterior. El resultado del comando debería verse así:

_auth = <generated-auth-string>
always-auth = true
email = <your-email>

Configurando tu archivo .npmrc (yarn/npm)

Abre tu archivo ~/.npmrc para editar. Agrega primero la información del registro, luego agrega la salida del comando curl. El producto final 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@email.com>
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:always-auth=true

Configurando tu archivo .yarnrc.yml (yarn moderno)

Abre tu archivo ~/.yarnrc.yml para editar. Agrega primero la información del registro, luego agrega la salida del comando curl. El producto final debería verse así:

npmScopes:
  axe-devtools:
      npmRegistries: 'https://agora.dequecloud.com/artifactory/api/npm/dequelabs/':
      npmAuthIdent: <generated-auth-string>
      npmRegistryServer: 'https://agora.dequecloud.com/artifactory/api/npm/dequelabs/'
      npmAlwaysAuth: true

Si no puedes ejecutar comandos curl, puedes generar tu cadena de autenticación codificando <your-email>:<your-identity-token> en base-64 y agregando el producto al archivo ~/.npmrc de la misma manera que si se hubiera generado con el comando curl.

Instalación

Para instalar Axe DevTools Puppeteer en tu proyecto, ejecuta este comando:

npm install @axe-devtools/puppeteer

Si aún no has instalado Puppeteer, puedes instalarlo con el comando

npm install puppeteer

Próximos pasos

Una vez que Axe DevTools se haya instalado correctamente en tu entorno, lee la guía sobre importar e inicializar.

Si tienes problemas para instalar Axe DevTools, contacta directamente a tu representante de Deque, pregúntanos a través de nuestra mesa de ayuda, o envíanos un correo electrónico. Estaremos encantados de ayudarte a empezar.