Installation de Axe DevTools pour Web CLI

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard

Installez le CLI en tant qu'exécutable autonome ou comme package Node.js.

Not for use with personal data

Axe DevTools CLI est disponible sous deux formes. Choisissez celle qui convient à votre environnement :

Exigences

Axe DevTools CLI nécessite un pilote de navigateur pour chaque navigateur que vous souhaitez utiliser. Le pilote doit être sur votre PATH. Gardez à jour aussi bien votre navigateur que son pilote.

Navigateur Pilote
Chrome ChromeDriver
Firefox geckodriver
Safari safaridriver est intégré à macOS. Vous pourriez avoir besoin d'exécuter safaridriver --enable avant de l'utiliser.
Microsoft Edge Microsoft Edge WebDriver
Internet Explorer IE Driver Server

Installer l'exécutable

Les exécutables n'ont aucun prérequis ; Node.js n'est pas requis.

important

Vous avez besoin d'un compte Deque Agora pour accéder à la page de téléchargements. Si vous n'en avez pas, contactez votre représentant Deque, utilisez notre service d'assistance, ou envoyez-nous un email.

Téléchargez l'exécutable approprié pour votre plateforme depuis la section CLI de la page de téléchargements:

  • axe-linux (Linux)
  • axe-macos (macOS)
  • axe-win.exe (Windows)

Configuration sur Linux

Rendez le fichier exécutable :

chmod +x axe-linux

Configuration sur macOS

Rendez le fichier exécutable, puis supprimez l'attribut de quarantaine que macOS ajoute aux fichiers téléchargés :

chmod +x axe-macos
xattr -d com.apple.quarantine axe-macos

Testez votre installation

Exécutez la commande d'aide depuis le répertoire où vous avez placé l'exécutable :

  • Linux : ./axe-linux --help
  • macOS : ./axe-macos --help
  • Windows : axe-win --help

Selon la configuration de votre compte, vous pourriez avoir besoin de privilèges administrateur.

Rendez le CLI disponible globalement

Pour exécuter axe depuis n'importe quel répertoire, placez l'exécutable dans un répertoire sur votre PATH.

note

Le reste de cette documentation suppose que vous avez renommé l'exécutable en axe (ou axe.exe sur Windows) et qu'il est disponible globalement.

Installation via Node.js

Vous avez besoin de Node.js installé. Pour vérifier, exécutez node -v dans votre terminal.

note

Vous avez besoin d'un accès au registre privé de Deque Systems. Si vous n'avez pas encore accès, contactez le service d'assistance de Deque Systems.

Étape 1 : Obtenir un jeton d'identité Agora

Agora est le registre npm privé de Deque qui héberge des @axe-devtools paquets. Pour y accéder, vous avez besoin d'un jeton d'identité.

  1. Visitez votre page de profil Agora. (Si vous êtes redirigé après la connexion, cliquez une deuxième fois sur le lien ou cliquez sur Modifier le profil dans le coin supérieur droit.)
  2. Cliquez sur Générer un jeton d'identité.
  3. Ajoutez éventuellement une description pour identifier le jeton plus tard.
  4. Copiez le jeton dans votre presse-papiers. Enregistrez-le dans un endroit sécurisé car vous ne pourrez plus le récupérer depuis Agora.
important

N'oubliez pas de copier la valeur de votre jeton d'identité lors de sa création, car ce sera votre seule opportunité. Sinon, vous devrez créer un nouveau jeton.

Les jetons d'identité expirent (généralement après un an), vous devrez donc recréer votre jeton périodiquement.

Étape 2 : Configurez votre .npmrc

  1. Visitez l'outil Configuration de l'accès aux paquets Agora . Aucune information que vous entrez n'est stockée ou transmise.
  2. Entrez votre adresse e-mail Agora et votre jeton d'identité.
  3. Cliquez sur Générer la configuration et copiez la sortie.
  4. Collez les lignes copiées dans votre ~/.npmrc fichier (%USERPROFILE%/.npmrc sous Windows).

Votre .npmrc 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@example.com>
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:always-auth=true

La _auth valeur est l'encodage base64 de <your-email>:<your-identity-token>.

Étape 3 : Installez le paquet

Installez globalement avec npm :

npm install -g @axe-devtools/cli

Ou avec Yarn :

yarn global add @axe-devtools/cli

Testez votre installation

axe --help

Si le texte d'aide apparaît, le CLI est installé et prêt à l'emploi.

Is this page helpful?

Help us improve this page

Still need help?