Référence API
Informations sur les classes et fonctions publiques de la bibliothèque.
AxeDevTools
Lorsque vous configurez des tests automatisés, vous définissez le registre d'instrumentation, permettant à axe DevTools pour Android de se connecter aux informations du nœud d'accessibilité. Faites référence aux classes et fonctions publiques de la bibliothèque ci-dessous lorsque vous créez vos tests.
Initialisation d'axe DevTools
Utilisez les API suivantes lors de l’initialisation de la bibliothèque AxeDevTools.
loginWithUsername(params)
Génère un jeton d'authentification pour se connecter au tableau de bord.
Obligatoire params :
| Nom | Type | Description |
|---|---|---|
| Nom d'utilisateur | String |
Nom d'utilisateur Deque |
| Mot de passe | String |
Mot de passe Deque |
Facultatif param :
| Nom | Type | Description |
|---|---|---|
| Configuration du serveur | String |
Définit l'URL du serveur auquel se connecter. |
loginWithApiKey(param)
Génère un jeton d'authentification pour se connecter au tableau de bord.
Obligatoire param :
| Nom | Type | Description |
|---|---|---|
| Clé API | String |
Clé API Deque |
Facultatif param :
| Nom | Type | Description |
|---|---|---|
| URL du serveur | String |
Définit l'URL du serveur auquel se connecter. |
setInstrumentation(param)
Permet à la bibliothèque d'obtenir la hiérarchie des vues de l'application testée.
Obligatoire param :
| Nom | Type | Description |
|---|---|---|
| instrumentation | android.app.Instrumentation |
Objet de registre d'instrumentation fournissant le contexte de l'application et l'instrumentation. |
isUserAuthenticated()
Renvoie un booléen pour indiquer si l'utilisateur est authentifié et prêt à envoyer des analyses.
Renvoie :
| Type | Description |
|---|---|
| Booléen | Indique si un utilisateur est authentifié pour axe DevTools Mobile. |
disconnect()
Efface la session réseau actuelle d'axe DevTools pour permettre l'établissement d'une nouvelle connexion.
Analyse
Une fois que vous avez importé et initialisé la bibliothèque, vous êtes prêt à analyser. AxeDevTools
scan()
Analyse les informations collectées par l'objet de registre d'instrumentation transmis à setInstrumentation(param) pour détecter les problèmes et renvoie un ScanResultHandler.
Renvoie :
| Nom | Type | Description |
|---|---|---|
| ScanResultHandler | Nullable | ScanResultHandler fournit un moyen d'obtenir des informations plus détaillées sur le résultat ou de mettre à jour davantage l'analyse en fournissant un nom ou des balises. |
getResult(param)
Demande le résultat d'une analyse à partir du tableau de bord correspondant à la clé de résultat fournie.
Obligatoire param :
| Nom | Type | Description |
|---|---|---|
| axeDevTools clé de résultat | AxeDevToolsResultKey |
L'identifiant du résultat que vous souhaitez récupérer. |
Renvoie :
| Type | Description |
|---|---|
| Résultat AxeDevTools | Nullable AxeDevToolsResult donne accès aux détails du résultat. |
Gestion des résultats
Utilisez ces API avec l'objet ScanResultHandler renvoyé par une analyse.
uploadToDashboard()
Téléchargez le résultat de l'analyse d'accessibilité sur le tableau de bord. Renvoie :
| Type | Description |
|---|---|
| Résultat AxeDevTools | Nullable AxeDevToolsResult donne accès aux détails du résultat. |
saveResultToLocalStorage(param)
Enregistrez le résultat de l’analyse d’accessibilité dans un fichier local sur votre appareil de test.
Obligatoire param :
| Nom | Type | Description |
|---|---|---|
| préfixeDuNomDeFichier | String |
Début du nom du fichier sous lequel enregistrer le résultat. |
getSerializedResult()
Récupère le résultat de votre scan pour l'utiliser dans le test.
Personnalisation de votre configuration
Nommez et étiquetez vos analyses, choisissez d'ignorer certaines règles ou créez vos propres règles personnalisées.
setScanName(param)
Donnez un nom au scan avant de le téléverser sur le tableau de bord.
Obligatoire param :
| Nom | Type | Description |
|---|---|---|
| nom | String |
Nom pour le scan. |
addCustomRule(param)
Ajoutez une règle à exécuter sur votre application pendant les analyses.
Obligatoire param :
| Nom | Type | Description |
|---|---|---|
| Règle personnalisée | Class<AxeDevToolsRule> |
Règle à ajouter |
ignoreRules(param)
Ignore complètement l'exécution des règles sur n'importe quelle vue.
Obligatoire param :
| Nom | Type | Description |
|---|---|---|
| Règles à ignorer | List<String> |
Liste des règles à ignorer. |
ignoreByViewIdResourceName(params)
Paramètres requis :
| Nom | Type | Description |
|---|---|---|
| viewIdResourceName | String |
Nom de l'ID de ressource pour la vue |
| ruleList | List<String> |
Liste des règles à ignorer |
ignoreExperimental()
Exclut les règles expérimentales. Les résultats des règles expérimentales auront le statut de AxeStatus.IGNORED.
resetIgnoredRules()
Effacer la liste des règles ignorées définie par les API de règles ignorées. Utile pour modifier la configuration des règles entre les tests automatisés.
tagScanAs(param)
Tag un scan avant de le téléverser sur le tableau de bord.
Obligatoire param :
| Nom | Type | Description |
|---|---|---|
| balises | Set<String> |
Liste des balises à ajouter à l'analyse. |
tearDown()
Réinitialise les balises et efface l'état de test des tests précédents.
deleteResult(param)
Supprime le résultat d'une analyse du tableau de bord correspondant à la clé de résultat fournie.
Obligatoire param :
| Nom | Type | Description |
|---|---|---|
| axeDevTools clé de résultat | AxeDevToolsResultKey |
L'identifiant du résultat que vous souhaitez récupérer. |