Migration vers axe DevTools for Web v4.x CLI
Étapes de la migration vers la version 4.x d'axe DevTools pour Web CLI
Pour migrer d'AGet vers axe DevTools for Web CLI, suivez les étapes suivantes :
-
Désinstallez AGet
-
Suivez les instructions d'installation
-
Mettre à niveau les scripts qui utilisent AGet pour utiliser axe DevTools for Web CLI à la place.
-
Si vous utilisez un ensemble de règles personnalisé, assurez-vous de le régénérer pour axe-core 4.0. De plus :
- Si vous utilisez ATTEST_PATH, remplacez-le par AXE_RULESET_PATH.
- Si vous utilisez un fichier local, renommez-le en
attest.json
.axe-ruleset.json
-
Si vous utilisez l'interface de ligne de commande Attest-Reporter, remplacez-la par axe reporter.
-
Si vous utilisez l'interface de ligne de commande attest-standards, remplacez-la par axe ruleset.
Désinstaller
Désinstaller l'exécutable AGet
La seule chose nécessaire pour désinstaller AGet est de le supprimer de votre système de fichiers. Si vous n'êtes pas sûr de l'endroit où il est installé, tapez which aget
dans la ligne de commande.
Désinstaller le package AGet
Pour désinstaller AGet d’un package local, exécutez npm remove @deque/aget
. Pour supprimer AGet globalement, ajoutez l'option -g
à cette commande. Si vous utilisez le package AGet non-scopé, tapez remove aget
au lieu de remove @deque/aget
.
Scripts de mise à niveau
Recherchez tous les scripts qui utilisent AGet, vous devrez alors remplacer la commande aget
par axe
. Gardez à l’esprit que ces scripts peuvent résider dans divers endroits, tels que :
- fichiers de script bash
- Fichiers de configuration CI
- scripts de test
- fichiers de configuration du paquetage
Dans axe DevTools pour Web 4.0, la commande « uri » est obsolète. Au lieu de cela, les URL peuvent être transmises directement à la commande « axe ». Pour migrer, supprimez « uri » de toutes les commandes axe qui l'utilisent.
aget uri deque.com
Dans axe DevTools pour Web 4.0, cela devient :
axe deque.com
Mise à niveau vers axe reporter
L'attest-reporter n'est plus disponible en tant qu'interface de ligne de commande autonome. Le reporter est désormais disponible dans le cadre d'axe DevTools pour Web CLI.
- Assurez-vous de désinstaller
attest-reporter
- Scripts de mise à niveau à utiliser
axe reporter
à la place deattest-reporter
Mise à niveau vers les règles de axe
Les normes d'attestation ne sont plus disponibles en tant qu'interface de ligne de commande autonome. La génération de normes est désormais disponible dans le cadre d'axe DevTools pour Web CLI.
- Assurez-vous de désinstaller
attest-standards
- Scripts de mise à niveau à utiliser
axe ruleset
à la place deattest-standards
Changements notables
Outre les modifications d'installation et d'utilisation des commandes décrites, voici quelques modifications notables :
- L'ensemble de règles Axe ne prend plus en charge les
matches
fonctions de règles personnaliséesevaluate
et lesafter
fonctions de vérification. Vous ne pouvez utiliser l'ID que pour les fonctions axe intégrées.