Installer Axe DevTools pour le JavaScript sur navigateur depuis l'Agora de Deque

Pour les clients qui n'ont pas de dépôt d'artefacts interne et qui souhaitent une solution plus durable et évolutive pour l'installation que le téléchargement direct d'Axe DevTools, Deque met à disposition son propre dépôt d'artefacts pour certains clients. Pour en savoir plus sur d'autres manières d'installer Axe DevTools, consultez le guide sur Installation depuis votre dépôt d'artefacts.

Prérequis

Pour installer Axe DevTools depuis Agora, vous devez disposer d'identifiants de connexion à Agora. De plus, vous devez avoir un projet web basé sur NodeJS existant pour installer Axe DevTools. 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é

Le moyen le plus simple de créer un jeton d'identité est via l'l'application web Agora. Une fois connecté, vous pouvez créer 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. Ensuite, vous devrez générer un jeton d'identité et le copier.

Ajouter l'authentification

Pour accéder aux packages Axe DevTools via NPM ou Yarn, vous devrez ajouter vos informations d'authentification Agora dans un fichier ~/.npmrc. Le moyen le 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>

Configurer votre fichier .npmrc (yarn/npm)

Ouvrez votre fichier ~/.npmrc pour l'éditer. Ajoutez d'abord les informations du 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

Configurer votre fichier .yarnrc.yml (yarn modern)

Ouvrez votre fichier ~/.yarnrc.yml pour l'éditer. Ajoutez d'abord les informations du 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 n'êtes pas en mesure d'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 Browser JavaScript dans votre projet, exécutez cette commande :

npm install @axe-devtools/browser

Étapes suivantes

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

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