Installer Axe DevTools pour le Web pour Playwright depuis Agora de Deque

Pour les clients qui n'ont pas de dépôt d'artéfacts interne et souhaitent une solution plus durable et évolutive pour l'installation que de télécharger directement Axe DevTools, Deque met son propre dépôt d'artéfacts à la disposition de certains clients. Pour plus d'informations sur d'autres moyens d'installer Axe DevTools, consultez les guides sur l'installation à partir d'un bundle 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 avoir un projet web existant basé sur NodeJS pour y 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 via 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. À partir de là, vous pouvez créer et copier un 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 dans un fichier ~/.npmrc. Le moyen le 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 adresse 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 édition. 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 fichier .yarnrc.yml (yarn moderne)

Ouvrez votre fichier ~/.yarnrc.yml pour édition. 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 de 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 Playwright dans votre projet, exécutez cette commande :

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

Prochaines étapes

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

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.