Installer Axe DevTools pour le Web pour Node.js depuis l'Agora de Deque

Pour les clients qui n'ont pas de dépôt d'artefacts interne et 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'artefacts pour certains clients. Ce guide couvre l'installation de n'importe lequel des packages Node.js d'Axe DevTools depuis le dépôt d'artefacts Agora de Deque. Pour des informations sur d'autres méthodes d'installation d'Axe DevTools, consultez le guide sur Installation depuis votre dépôt d'artefacts.

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 Node.js dans lequel installer Axe DevTools. Selon la configuration de votre environnement de test, votre bibliothèque de test (par exemple, Cypress, Playwright, Puppeteer, WebdriverIO ou WebDriverJS) peut être requise comme 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'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. À partir de là, vous pouvez créer et copier votre jeton d'identité.

Ajouter une authentification

Pour accéder aux packages d'Axe DevTools via NPM ou Yarn, vous devrez ajouter vos informations d'authentification Agora à un fichier ~/.npmrc. L'outil Configurer l'accès aux packages Agora peut générer ce contenu .npmrc pour vous à partir de votre email Agora et de votre jeton d'identité. Sinon, la manière la plus simple de le faire manuellement 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 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 le modifier. 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

Configurer votre fichier .yarnrc.yml (yarn moderne)

Ouvrez votre fichier ~/.yarnrc.yml pour le modifier. 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 de 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 avait été généré avec la commande curl.

Installation

Une fois l'authentification configurée, installez le package pour votre bibliothèque de test.

JavaScript navigateur (@axe-devtools/browser)

npm install @axe-devtools/browser

Une fois installé, lisez le guide sur importation et initialisation.

Cypress (@axe-devtools/cypress)

npm install @axe-devtools/cypress

Si vous n'avez pas encore installé Cypress lui-même, vous pouvez l'installer avec la commande

npm install cypress

Playwright (@axe-devtools/playwright)

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

Une fois installé, lisez le guide sur importation et initialisation.

Puppeteer (@axe-devtools/puppeteer)

npm install @axe-devtools/puppeteer

Si vous n'avez pas encore installé Puppeteer lui-même, vous pouvez l'installer avec la commande

npm install puppeteer

Une fois installé, lisez le guide sur importation et initialisation.

WebdriverIO (@axe-devtools/webdriverio)

npm install @axe-devtools/webdriverio

Une fois installé, lisez le guide sur importation et initialisation.

WebDriverJS (@axe-devtools/webdriverjs)

npm install @axe-devtools/webdriverjs

Une fois installé, lisez le guide sur importation et initialisation.

Prochaines étapes

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