Installer Axe DevTools pour Web pour WebDriverJS depuis l'Agora de Deque

Pour les clients qui n'ont pas de dépôt d'artifacts interne et qui souhaitent une solution d'installation plus durable et évolutive que le téléchargement direct de Axe DevTools, Deque met son propre dépôt d'artifacts à disposition de certains clients. Pour des informations sur d'autres façons d'installer Axe DevTools, consultez le guide sur installation depuis votre dépôt d'artifacts ou téléchargement d'un projet de démonstration.

Prérequis

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

Création d'un jeton d'identité

La façon la plus simple de créer un jeton d'identité est de se connecter à l'application web Agora. Une fois connecté, vous pouvez générer un jeton d'identité en cliquant sur le bouton intitulé Bienvenue votre-adresse-email dans la barre supérieure à côté du bouton d'aide, en cliquant sur Générer un jeton d'identité, en suivant les étapes pour créer un jeton d'identité, et en copiant votre jeton d'identité.

Ajout de l'authentification

Pour accéder aux packages Axe DevTools via NPM ou Yarn, vous devrez ajouter vos informations d'authentification Agora à un fichier ~/.npmrc. La façon 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"

Lorsque vous exécutez 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>

Configuration de votre fichier .npmrc (yarn/npm)

Ouvrez votre fichier ~/.npmrc pour l'éditer. Ajoutez d'abord les informations de registre, puis ajoutez le résultat 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

Configuration de votre fichier .yarnrc.yml (yarn moderne)

Ouvrez votre fichier ~/.yarnrc.yml pour l'éditer. Ajoutez d'abord les informations de registre, puis ajoutez le résultat 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 les commandes curl, vous pouvez générer votre chaîne d'authentification en encodant <your-email>:<your-identity-token> en base-64 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 WebDriverJS dans votre projet, exécutez cette commande :

npm install @axe-devtools/webdriverjs

Étapes suivantes

Une fois Axe DevTools installé avec succès dans votre environnement, lisez le guide sur importation et initialisation.

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