axe DevTools Reporter CLI
Générez des rapports autonomes à partir d'axe DevTools Mobile à partager avec votre équipe - utilisateur sous licence ou non.
L'interface de ligne de commande (CLI) axe DevTools Reporter a repris la puissance de création de rapports disponible dans axe DevTools CLI et l'a intégrée dans un outil de création de rapports léger et autonome.
Le Reporter CLI nécessite des fichiers JSON axe DevTools Mobile pour créer un rapport. Les fichiers JSON peuvent être obtenus à partir de deux sources :
- Recommandé pour un usage personnel : Exportation de scans depuis le tableau de bord d'axe DevTools Mobile
- Recommandé pour le pipeline CI/CD : enregistrement des résultats localement dans votre exécution de test automatisée
Avez-vous déjà installé le Reporter CLI ? Découvrez notre prochain guide sur Générer des rapports avec CI/CD.
Vous utilisez déjà le axe DevTools CLI ?
Axe DevTools CLI prend en charge la génération de rapports HTML à partir des analyses axe DevTools Mobile. Fournissez à la CLI un répertoire contenant vos analyses mobiles sous forme de fichiers JSON.
Remarque : pour plus d’informations sur l’outil, consultez la documentation axe DevTools CLI.
Première configuration
Télécharger via npm
Axe DevTools Reporter CLI est disponible via l'Artifactory Deque sous forme de package npm. Suivez notre guide pour configurer votre registre npm pour accéder à axe DevTools Mobile.
Téléchargement direct
Trouvez votre système d'exploitation dans les sous-sections ci-dessous. Une fois l'axe DevTools Reporter CLI téléchargé depuis l'Artifactory de Deque, ouvrez la ligne de commande et accédez à l'emplacement de l'exécutable. Utilisez la commande sous le lien de téléchargement pour tester l'installation.
Mode administrateur
Selon la configuration de votre machine, vous devrez peut-être utiliser le mode administrateur.
Activer l'installation globale
Rendez axe DevTools Reporter CLI disponible globalement à partir de n'importe quel répertoire en le plaçant dans un répertoire du $PATH de votre système. Vous pouvez voir quels répertoires se trouvent dans le $PATH de votre système en exécutant `echo $PATH`.
Votre téléchargement doit être un exécutable, vous devrez peut-être l'exécuter chmod +x <name>
dans le terminal pour le rendre ainsi sur les machines Mac ou Linux.
Sous Windows
Tester l'installation avec :
./reporter-cli-win.exe --help
Sous Linux
Tester l'installation avec :
./reporter-cli-linux --help
Sur macOS
Tester l'installation avec :
./reporter-cli-macos --help
Génération de rapports
Une fois que vous avez collecté les analyses axe DevTools Mobile sous forme de fichiers JSON, vous êtes prêt à créer un rapport. Assurez-vous que toutes les analyses se trouvent dans un répertoire, puis exécutez la commande suivante pour générer les rapports HTML :
axe-devtools-reporter <devtools-results-directory> <output-directory> --format=html
Le répertoire de sortie est facultatif et, s'il n'est pas fourni, les rapports seront stockés ./axe-devtools-reporter
.
Les noms de fichiers sont dérivés du nom du scan et de l'horodatage du scan. ${scanName}-axe-result-${timestamp}.html
Assurez-vous de consulter executive-report.html
pour voir les résultats combinés de toutes les analyses de la suite.
Format de sortie
En plus du rapport HTML, vous pouvez également exporter les données au format CSV ou XML/JUnit.
HTML :
axe-devtools-reporter <devtools-results-directory> <output-directory> --format=html
XML/JUnit :
axe-devtools-reporter <devtools-results-directory> <output-directory> --format=junit
CSV :
axe-devtools-reporter <devtools-results-directory> <output-directory> --format=csv