Installer Axe DevTools pour le Web pour WebdriverIO depuis l'Agora de Deque

Pour les clients qui n'ont pas de dépôt d'artéfacts interne et qui 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'artéfacts pour certains clients. Pour des informations sur d'autres moyens d'installer Axe DevTools, voir les guides sur Installation à partir d'un package ou Installation depuis votre dépôt d'artéfacts.

Prérequis

Pour installer Axe DevTools depuis Agora, vous devez avoir des identifiants de connexion Agora. De plus, vous devez disposer d'un projet Web existant basé sur NodeJS pour y installer Axe DevTools, ainsi que WebdriverIO. Selon la configuration de votre environnement de test, votre bibliothèque de test peut être requise en tant que dépendance supplémentaire.

Créer un jeton d'identité

La manière la plus simple de créer un jeton d'identité est de se connecter à 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. De là, vous pouvez cliquer sur Générer un jeton d'identité et suivre les étapes pour 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 à un fichier ~/.npmrc. La manière la plus simple de le faire est avec 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 par votre email de connexion Agora, et remplacez par le jeton d'identité que vous avez copié à l'étape précédente. 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 produit 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 produit final devrait ressembler à ceci :

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 vous ne pouvez pas exécuter des commandes curl, vous pouvez générer votre chaîne d'authentification en encodant en base-64 <your-email>:<your-identity-token> et en ajoutant le produit au fichier ~/.npmrc de la même manière que s'il avait été généré avec la commande curl.

Installation

Pour installer Axe DevTools Puppeteer dans votre projet, exécutez cette commande :

npm install @axe-devtools/webdriverio

Prochaines étapes

Une fois qu'Axe DevTools a été installé avec succès dans votre environnement, consultez le guide sur importer et initialiser.

Si vous rencontrez des problèmes pour installer Axe DevTools, contactez directement votre représentant Deque, demandez-nous via notre service d'assistance, ou envoyez-nous un email. Nous serons ravis de vous aider à démarrer.