Installer axe DevTools for Web pour JavaScript de navigateur depuis l'Agora de Deque

Pour les clients qui ne disposent pas d'un référentiel d'artefacts interne et souhaitent une solution d'installation plus durable et évolutive que le téléchargement direct d'axe DevTools, Deque met son propre référentiel d'artefacts à la disposition de certains clients. Pour plus d'informations sur d'autres façons d'installer axe DevTools, consultez le guide sur Installation à partir de votre référentiel d'artefacts.

Prérequis

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

Le moyen le plus simple de créer un jeton d'identité est d'utiliser l'application Web Agora. Une fois connecté, vous pouvez créer un jeton d'identité en cliquant sur le bouton intitulé Bienvenue votre-adresse-e-mail dans la barre supérieure à côté du bouton d'aide. À partir de là, vous devrez générer un jeton d’identité et le copier.

Ajout d'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 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 par votre e-mail de connexion Agora et remplacez avec 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 .npmrc fichier (yarn/npm)

Ouvrez votre fichier ~/.npmrc pour le modifier. Ajoutez d’abord les informations de 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

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

Ouvrez votre fichier ~/.yarnrc.yml pour le modifier. Ajoutez d’abord les informations de 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 les commandes curl, vous pouvez générer votre chaîne d'authentification en codant 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 était 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

Prochaines étapes

Une fois qu'axe DevTools a été installé avec succès dans votre environnement, lisez le guide sur l'importation et l'initialisation.

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