Utiliser le CLI pour envoyer les résultats d'accessibilité à axe Developer Hub

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

Discute des différentes manières d'envoyer vos résultats d'accessibilité à axe Developer Hub en utilisant le CLI

Not for use with personal data

Le CLI vous permet d'envoyer vos résultats d'accessibilité à axe Developer Hub. Vous pouvez :

Télécharger les résultats des tests précédents vers axe Developer Hub. Cette option utilise la sous-commande devhub du CLI et vous permet de télécharger des résultats provenant de l'analyse de pages web à l'aide des APIs web ou des précédentes exécutions du CLI (où vous avez analysé des pages individuelles ou exécuté des fichiers de spécifications et sauvegardé les résultats).
Analyser des pages individuelles et envoyer directement les résultats à axe Developer Hub (sans d'abord enregistrer les fichiers de résultats).
Exécuter des fichiers de spécifications et envoyer directement les résultats à axe Developer Hub (sans d'abord enregistrer les fichiers de résultats).

Exigences

Pour utiliser le CLI avec axe Developer Hub, vous aurez besoin de :

Un compte axe et un abonnement pour axe Developer Hub. Voir Commencer avec axe Developer Hub pour plus d'informations.
Un projet axe Developer Hub où vous téléchargez les résultats. Voir Créer un nouveau projet axe Developer Hub pour des informations sur la création d'un nouveau projet. Lors de la création d'un projet, vous spécifiez que le projet utilisera le CLI comme source d'entrée ou de données. Vous aurez besoin de ces valeurs pour télécharger des résultats :
- Votre clé API personnelle (affichée dans votre compte axe sous Clés API)
- Votre ID de projet (affiché dans les instructions lors de la création d'un nouveau projet axe Developer Hub)
(Optionnel) Si vous avez des tests qui utilisent les APIs web, vous devrez modifier vos tests pour produire un ou plusieurs fichiers de résultats. Un fichier de résultats est un fichier .json contenant les résultats de votre exécution de tests, et la procédure de création de fichiers de résultats est différente en fonction de l'API que vous utilisez. Pour plus de détails, voir Création de fichiers de résultats. Vous utilisez la sous-commande devhub pour télécharger les fichiers de résultats.

Envoi des résultats à axe Developer Hub

Normalement, le CLI teste les sites web et produit des résultats uniquement lorsque vous utilisez l'option -s pour sauvegarder les résultats (qui sont des fichiers .json contenant des informations sur les erreurs d'accessibilité dans les sites web testés). Vous pouvez envoyer vos résultats à axe Developer Hub en spécifiant une clé API sur la ligne de commande avec l'option --axe-devhub-api-key (ou en définissant la variable d'environnement AXE_DEVHUB_API_KEY) et un ID de projet avec --axe-devhub-project-id (ou en définissant la variable d'environnement AXE_DEVHUB_PROJECT_ID).

Par défaut, le CLI télécharge également les informations Git si le répertoire où vous exécutez le CLI fait partie d'un dépôt Git. Voir Mode Git versus Gitless pour des informations sur le fonctionnement de l'envoi des informations Git.

Le CLI associera la branche Git actuelle et l'historique des commits à vos résultats d'accessibilité.

important

En exécutant le CLI depuis un dossier à l'intérieur d'un dépôt Git, les résultats que vous envoyez à axe Developer Hub écraseront tout résultat antérieur du même commit (déterminé par son SHA). (Un seul ensemble de résultats peut être associé à chaque commit.) Vous devez créer un nouveau commit à chaque fois que vous exécutez le CLI ou renoncer à la déclaration des résultats Git en utilisant l'option --no-git-data. Voir Mode Git versus Gitless pour plus d'informations.

Télécharger des Résultats

Si vous avez précédemment exécuté des tests et avez des fichiers de résultats (fichiers .json généralement nommés axe-result-2025-09-03T14 02 32-0700.json), vous pouvez télécharger ces résultats sur axe Developer Hub avec la sous-commande devhub. Vous pouvez sauvegarder des résultats en utilisant l'option de ligne de commande -s lors de l'analyse de pages ou de l'exécution de fichiers de spécifications :

axe https://example.com -s

tip

Lors de l'analyse d'une page ou de l'exécution d'un fichier de spécifications, vous n'avez pas besoin de sauvegarder d'abord les résultats, puis de les télécharger. En spécifiant une clé API et un ID de projet, le CLI transmettra les résultats lorsque l'analyse de votre page sera terminée ou lorsque l'exécution de votre fichier de spécifications sera terminée. Voir Analyser des pages individuelles et Exécuter des fichiers de spécifications.

L'exemple précédent crée un fichier de résultats que vous pouvez ensuite télécharger vers axe Developer Hub, comme montré ci-dessous :

axe devhub <results-dir(s)-or-file(s)> --axe-devhub-api-key <your-API-key> --axe-devhub-project-id <your-project-ID>

Vous pouvez utiliser . (point) comme le répertoires-ou-fichiers-de-résultats pour télécharger tous les fichiers de résultats .json dans le répertoire actuel. Vous pouvez également spécifier plusieurs répertoires ou fichiers à télécharger.

Création de fichiers de résultats avec les APIs web

Si vous utilisez les APIs web, vous devrez modifier vos tests API pour écrire des fichiers de résultats que vous pourrez ensuite télécharger vers axe Developer Hub en utilisant la sous-commande devhub. Le tableau suivant contient des liens vers des informations sur la création de fichiers de résultats, et ces APIs utilisent les APIs de reporting ou de logging fournies pour écrire les résultats sous forme de fichiers .json sur le disque.

API	Nom du lien
Node.js	axe DevTools Logger
C#	Créer du JSON compatible avec le reporter
Java	Générer des rapports avec Java
Python	Créer du JSON compatible avec le reporter
Ruby	Options de reporting

Analyser des pages individuelles

Vous pouvez analyser des pages web individuelles et envoyer les résultats à axe Developer Hub en spécifiant une clé API et l'identifiant du projet pour lequel recevoir les résultats :

axe https://google.com --axe-devhub-api-key <your-API-key> --axe-devhub-project-id <your-project-ID>

Dans cet exemple, la CLI exécute des tests d'accessibilité sur le site de Google puis envoie les résultats au projet axe Developer Hub référencé par l'identifiant du projet spécifié.

Vous pouvez également lister plusieurs pages sur la ligne de commande à tester :

axe https://example.com/page1.html https://example.com/page2.html --axe-devhub-api-key <your-API-key> --axe-devhub-project-id <your-project-ID>

Visitez le projet sur axe Developer Hub pour voir vos résultats. Voir Vue d'ensemble des problèmes d’accessibilité.

Exécuter des fichiers de spécification

Vous pouvez envoyer les résultats de l'exécution de vos fichiers de spécification en utilisant les options de ligne de commande --axe-devhub-api-key et --axe-devhub-project-id.

axe spec my-spec-file.yml --axe-devhub-api-key <your-API-key> --axe-devhub-project-id <your-project-ID>

Cet exemple exécute le fichier de spécification YAML my-spec-file.yml et télécharge ses résultats d'accessibilité sur axe Developer Hub. Voir Spécifications de flux de travail et Actions de flux de travail pour plus d'informations sur les fichiers de spécification.

tip

Si vous avez besoin de passer à la suite dans votre fichier de spécification en contournant les tests de pages, vous pouvez utiliser l'option de ligne de commande --resume-from <page> pour reprendre vos tests à partir d'une page spécifique dans votre fichier de spécification. Voir Reprendre à partir de pour plus d'informations.

Mode Git versus Sans Git

Par défaut, axe Developer Hub associe vos résultats d'accessibilité au dernier commit Git sur la branche actuelle lorsque vous exécutez la CLI depuis un répertoire au sein d'un dépôt Git, vous permettant de lier facilement les erreurs d'accessibilité aux commits Git. Un effet secondaire de ce comportement est que chaque fois que vous rapportez des résultats à axe Developer Hub, de nouveaux résultats remplacent toutes autres exécutions sur le même commit (basé sur son SHA). De plus, si vous passez à une branche différente, tous les résultats que vous envoyez à axe Developer Hub seront associés au dernier commit sur cette branche.

Si le comportement par défaut de axe Developer Hub ne vous convient pas :

Vous pouvez utiliser la CLI dans un répertoire en dehors d'un dépôt Git.
Vous pouvez utiliser l'option de ligne de commande --no-git-data pour éviter le rapport d'informations Git au serveur, fonctionnant dans ce qu'on appelle le mode Sans Git où chaque fois que vous rapportez des résultats au serveur, une nouvelle exécution de test est créée et identifiée par l'heure et la date de l'exécution plutôt que par la branche et le commit comme en mode Git.

Voir Les pages de votre projet et La page des exécutions de test pour des informations sur la façon dont les résultats Git et Sans Git sont organisés et présentés dans axe Developer Hub.

Options de ligne de commande

La CLI accepte ces options de ligne de commande :

--axe-devhub-api-key Vous permet de définir votre clé API personnelle, équivalent à la variable d'environnement AXE_DEVHUB_API_KEY. Requis
--axe-devhub-project-id Définit l'identifiant du projet pour votre projet axe Developer Hub, équivalent à la variable d'environnement AXE_DEVHUB_PROJECT_ID. Requis
--axe-devhub-server-url Vous permet d'utiliser un serveur autre que le serveur par défaut (https://axe.deque.com), équivalent à la variable d'environnement AXE_DEVHUB_SERVER_URL. Définissez cela si votre organisation utilise une instance régionale, un cloud privé ou un déploiement sur site de Axe Developer Hub. Optionnel
--no-git-data Évite de rapporter les informations Git au serveur. Voir Mode Git versus Sans Git pour plus d'informations. N'a pas de variable d'environnement équivalente. Optionnel

Variables d'environnement

Vous pouvez définir des variables d'environnement pour éviter de spécifier la clé API, l'identifiant du projet, ou l'URL du serveur sur la ligne de commande, ce qui est recommandé lors de l'utilisation de la clé API en intégration continue pour la garder secrète.

tip

Définir AXE_DEVHUB_API_KEY et AXE_DEVHUB_PROJECT_ID permettra toujours d'envoyer les résultats à axe Developer Hub chaque fois que vous analysez une page ou exécutez un fichier de spécification. Par exemple, si vous avez défini ces variables d'environnement et que vous analysez une page avec :

axe https://somewebsite.com

Les résultats seront envoyés à axe Developer Hub. Ce comportement s'applique lorsque vous utilisez la CLI pour analyser une page ou exécuter un fichier de spécification.

AXE_DEVHUB_API_KEY Spécifie votre clé API personnelle, équivalent à l'option de ligne de commande --axe-devhub-api-key.
AXE_DEVHUB_PROJECT_ID Spécifie l'identifiant du projet pour votre projet axe Developer Hub, équivalent à l'option de ligne de commande --axe-devhub-project-id.
AXE_DEVHUB_SERVER_URL Spécifie l'URL du serveur Axe Developer Hub (par défaut est https://axe.deque.com), équivalent à l'option de ligne de commande --axe-devhub-server-url. Définissez cela si votre organisation utilise une instance régionale, un cloud privé ou un déploiement sur site de Axe Developer Hub.