Instalar Axe DevTools para Web para Node.js 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 a disposición su propio repositorio de artefactos para clientes selectos. Esta guía abarca la instalación de cualquiera de los paquetes Node.js de Axe DevTools desde el repositorio de artefactos Agora de Deque. Para obtener información sobre otras formas de instalar Axe DevTools, consulte la guía sobre Instalación desde su Repositorio de Artefactos.

Requisitos previos

Para instalar Axe DevTools desde Agora, debe tener credenciales de inicio de sesión de Agora. Además, debe tener un proyecto web basado en Node.js existente para instalar Axe DevTools. Dependiendo de la configuración de su entorno de prueba, su biblioteca de pruebas (por ejemplo, Cypress, Playwright, Puppeteer, WebdriverIO o WebDriverJS) puede ser requerida como una dependencia adicional.

Crear un Token de Identidad

La forma más sencilla de crear un Token de Identidad es a través de la aplicación web de Agora. Una vez que haya iniciado sesión, puede crear un Token de Identidad haciendo clic en el botón etiquetado como Bienvenido su-dirección-de-correo-electrónico en la barra superior junto al botón de ayuda. Desde allí, puede crear y copiar su Token de Identidad.

Agregar 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 herramienta Configurar Acceso a paquetes de Agora puede generar este contenido .npmrc para ti a partir de tu correo electrónico de Agora y del Token de Identidad. De lo contrario, la forma más sencilla de hacerlo manualmente 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 your-email con tu correo de inicio de sesión de Agora, y reemplaza your-identity-token con el Token de Identidad que copiaste en el paso anterior. Mantén las comillas y no añadas paréntesis angulares alrededor de los valores sustituidos: en la mayoría de los shells, < y > son operadores de redirección, por lo que dejaroslos hace que el comando falle con un error engañoso. El retorno del comando debería verse así:

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

Configurar su archivo .npmrc (yarn/npm)

Abre tu archivo ~/.npmrc para editarlo. Añade primero la información del registro, luego añade el resultado 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

Configurar su archivo .yarnrc.yml (yarn moderno)

Abre tu archivo ~/.yarnrc.yml para editarlo. Añade primero la información del registro, luego añade el resultado del comando curl. El producto final debería verse así:

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

Si no puedes ejecutar los comandos curl, puedes generar tu cadena de autenticación codificando en base-64 tu correo electrónico de Agora y el Token de Identidad en la forma your-email:your-identity-token, luego añadiendo el resultado al archivo ~/.npmrc de la misma manera como si se hubiera generado con el comando curl.

Instalación

Una vez configurada la autenticación, instale el paquete para su biblioteca de pruebas.

JavaScript para Navegador (@axe-devtools/browser)

npm install @axe-devtools/browser

Una vez instalado, lea la guía sobre importación e inicialización.

Cypress (@axe-devtools/cypress)

npm install @axe-devtools/cypress

Si aún no ha instalado Cypress, puede instalarlo con el comando

npm install cypress

Playwright (@axe-devtools/playwright)

npm install @axe-devtools/playwright

Si aún no ha instalado Playwright, puede instalarlo con el comando

npm install playwright

Una vez instalado, lea la guía sobre importación e inicialización.

Puppeteer (@axe-devtools/puppeteer)

npm install @axe-devtools/puppeteer

Si aún no ha instalado Puppeteer, puede instalarlo con el comando

npm install puppeteer

Una vez instalado, lea la guía sobre importación e inicialización.

WebdriverIO (@axe-devtools/webdriverio)

npm install @axe-devtools/webdriverio

Una vez instalado, lea la guía sobre importación e inicialización.

WebDriverJS (@axe-devtools/webdriverjs)

npm install @axe-devtools/webdriverjs

Una vez instalado, lea la guía sobre importación e inicialización.

Próximos pasos

Si tiene problemas para instalar Axe DevTools, contacte a su representante de Deque directamente, pregúntenos a través de nuestra mesa de soporte, o envíenos un correo electrónico. Estaremos encantados de ayudarle a comenzar.