Installer Axe DevTools pour le Web pour Node.js depuis l'Agora de Deque

Pour les clients qui n'ont pas de dépôt d'artefacts interne et souhaitent une solution d'installation plus durable et évolutive que le téléchargement direct d'Axe DevTools, Deque met à disposition son propre dépôt d'artefacts pour certains clients. Ce guide couvre l'installation de n'importe lequel des packages Node.js d'Axe DevTools depuis le dépôt d'artefacts Agora de Deque. Pour des informations sur d'autres méthodes d'installation d'Axe DevTools, consultez le guide sur Installation depuis votre dépôt d'artefacts.

Prérequis

Pour installer Axe DevTools depuis Agora, vous devez avoir des identifiants de connexion Agora. De plus, vous devez avoir un projet web existant basé sur Node.js dans lequel installer Axe DevTools. Selon la configuration de votre environnement de test, votre bibliothèque de test (par exemple, Cypress, Playwright, Puppeteer, WebdriverIO ou WebDriverJS) peut être requise comme dépendance supplémentaire.

Créer un jeton d'identité

Le moyen le plus simple de créer un jeton d'identité est via l'application-web Agora. Une fois connecté, vous pouvez créer un jeton d'identité en cliquant sur le bouton étiqueté Bienvenue votre-adresse-email dans la barre supérieure à côté du bouton d'aide. À partir de là, vous pouvez créer et copier votre jeton d'identité.

Ajouter une authentification

Pour accéder aux packages Axe DevTools via npm ou Yarn, vous devrez ajouter vos informations d'authentification Agora dans un fichier ~/.npmrc. L'outil Configurer l'accès aux packages Agora peut générer ce contenu .npmrc pour vous à partir de votre email Agora et de votre Jeton d'Identité. Sinon, la façon la plus simple de le faire manuellement est d'utiliser une commande curl.

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

Lors de l'exécution de cette commande, remplacez your-email par votre adresse email de connexion Agora, et remplacez your-identity-token par le Jeton d'Identité que vous avez copié à l'étape précédente. Conservez les guillemets et n'ajoutez pas de chevrons autour des valeurs remplacées : dans la plupart des shells, < et > sont des opérateurs de redirection, donc les laisser peut entraîner l'échec de la commande avec une erreur trompeuse. Le retour de la commande devrait ressembler à ceci :

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

Configurer votre fichier .npmrc (yarn/npm)

Ouvrez votre fichier ~/.npmrc pour l'éditer. Ajoutez d'abord les informations du registre, puis ajoutez la sortie de la commande curl. Le résultat final devrait ressembler à ceci :

@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

Configurer votre fichier .yarnrc.yml (yarn moderne)

Ouvrez votre fichier ~/.yarnrc.yml pour l'éditer. Ajoutez d'abord les informations du registre, puis ajoutez la sortie de la commande curl. Le résultat final devrait ressembler à ceci :

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

Si vous ne pouvez pas exécuter les commandes curl, vous pouvez générer votre chaîne d'authentification en encodant en base-64 votre email Agora et votre Jeton d'Identité sous la forme your-email:your-identity-token, puis ajoutez le résultat au fichier ~/.npmrc de la même manière que s'il avait été généré avec la commande curl.

Installation

Une fois l'authentification configurée, installez le package pour votre bibliothèque de test.

JavaScript navigateur (@axe-devtools/browser)

npm install @axe-devtools/browser

Une fois installé, lisez le guide sur importation et initialisation.

Cypress (@axe-devtools/cypress)

npm install @axe-devtools/cypress

Si vous n'avez pas encore installé Cypress lui-même, vous pouvez l'installer avec la commande

npm install cypress

Playwright (@axe-devtools/playwright)

npm install @axe-devtools/playwright

Si vous n'avez pas encore installé Playwright lui-même, vous pouvez l'installer avec la commande

npm install playwright

Une fois installé, lisez le guide sur importation et initialisation.

Puppeteer (@axe-devtools/puppeteer)

npm install @axe-devtools/puppeteer

Si vous n'avez pas encore installé Puppeteer lui-même, vous pouvez l'installer avec la commande

npm install puppeteer

Une fois installé, lisez le guide sur importation et initialisation.

WebdriverIO (@axe-devtools/webdriverio)

npm install @axe-devtools/webdriverio

Une fois installé, lisez le guide sur importation et initialisation.

WebDriverJS (@axe-devtools/webdriverjs)

npm install @axe-devtools/webdriverjs

Une fois installé, lisez le guide sur importation et initialisation.

Prochaines étapes

Si vous rencontrez des problèmes lors de l'installation d'Axe DevTools, contactez directement votre représentant Deque, posez-nous une question via notre support technique, ou envoyez-nous un email. Nous serons heureux de vous aider à démarrer.