Retour au Centre de connaissances
Démarrage

Tests d’accessibilité de l’automatisation du navigateur

Créez des tests qui vérifient le clavier, les noms sémantiques, le focus, les annonces et les erreurs inclusives.

BotBrowser Team

Documentation

Vous voulez la documentation structurée pour Démarrage ?

Cet article fait partie de la bibliothèque éditoriale. Pour les étapes de configuration, la référence et les mises à jour continues, passez directement à la section docs.

Un test d’accessibilité de l’automatisation passe de la fixture aux contrôles clavier et d’assistance avec des preuves limitées

Les tests d'accessibilité de l'automatisation du navigateur sont plus utiles lorsqu'ils vérifient le même parcours qu'une personne doit effectuer : trouver un contrôle, l'atteindre sans pointeur, comprendre son nom et son état, terminer une tâche et récupérer d'une erreur. Une exécution automatisée ne peut pas certifier tous les aspects de l’accessibilité, mais elle peut protéger les contrats reproductibles qui autrement seraient faciles à régresser. L'objectif pratique est un petit test observable qui explique ce qui a été vérifié et ce qui nécessite encore un examen humain. BotBrowser peut fournir un profil et un contexte isolés et reproductibles pour exécuter ces vérifications ; il ne peut pas certifier l’accessibilité ni remplacer l’examen manuel avec des technologies d’assistance.

Le guide Popover API : focus, fermeture et accessibilité donne un exemple précis pour vérifier Escape, le clic extérieur, le retour du focus et le repli de l’API.

Commencez avec une page synthétique autorisée ou un compte de test. Le navigateur peut observer la sémantique rendue, le mouvement du focus, le comportement du clavier et l'état visible. Il ne peut pas établir qu'une personne réelle disposant d'une technologie d'assistance particulière vivra correctement chaque interaction, ni prouver qu'un service a traité une mutation à distance. Conservez ces limites dans le résultat afin qu'une assertion verte du navigateur ne soit pas présentée comme une déclaration de conformité complète. Les Directives pour l'accessibilité du contenu Web fournissent des critères de réussite ; la spécification ARIA explique les rôles, les états et les propriétés.

Les tests d'accessibilité doivent également inclure les états que les clients rencontrent le plus souvent : un utilisateur récurrent, une fenêtre d'affichage étroite, une langue modifiée, une autorisation bloquée et une réponse réseau qui arrive en retard. Pour chaque état, définissez le focus, le nom, le statut et l'action de récupération attendus. Cela maintient le test proche de la promesse du produit tout en laissant la place à un examen manuel de la parole, du grossissement et de la charge cognitive.

Une exécution d'accessibilité est plus forte lorsque sa portée est visible avant de démarrer. Nommez l'itinéraire, les données synthétiques, la fenêtre d'affichage, le mode de saisie, le point de repère attendu et le propriétaire du nettoyage. Décidez si l'exécution est une vérification de composant, une tâche complète ou un échantillon de compatibilité. Cela évite qu'une assertion clavier étroite soit signalée comme un audit de l'ensemble du produit et donne aux évaluateurs une raison claire d'ajouter des vérifications manuelles.

TL;DR

  • L'automatisation montre qu'un contrôle nommé est atteignable avec Tab, que Escape ferme une boîte de dialogue et que le focus revient au déclencheur, mais elle ne montre pas ce qu'un lecteur d'écran annonce réellement.
  • Ciblez par rôle et nom accessible, par exemple getByRole('button', { name: 'Apply filters' }), plutôt que par classe générée ou chemin CSS profond.
  • Après un envoi refusé, affirmez aria-invalid="true" et le lien avec le texte d'erreur ; sur la région qui rend compte du résultat, role="status" avec aria-live="polite".
  • Fixez la fixture avec page.setViewportSize({ width: 1280, height: 800 }), une langue, un compte synthétique et reducedMotion: 'reduce' lorsque cette préférence fait partie du parcours.
  • Nommez le contrat en échec dans test.step() et ne gardez qu'un page.screenshot() autorisé pour ne pas élargir la limite de preuve.

Sommaire de la guide

Transformez une exigence d'accessibilité en un contrat observable

Écrivez le résultat utilisateur avant de choisir un localisateur. « Un utilisateur du clavier peut ouvrir les filtres, choisir une valeur et comprendre que la liste a changé » est un contrat. « Cliquez sur le bouton de filtre et attendez deux secondes » est un détail d'implémentation. Un test utile nomme l'état de départ, la séquence d'action, le propriétaire du focus attendu, le résultat visible ou annoncé et les preuves limitées conservées en cas d'échec d'une étape.

Par exemple, getByRole('button', { name: 'Apply filters' }) repère le contrôle par son nom destiné à l'utilisateur, et non par sa position.

Séparez les observations du navigateur de la signification de l'application. Un bouton peut exposer un nom accessible alors que sa demande au serveur est rejetée. Une région d'état peut recevoir du texte tandis qu'une file d'attente de lecteur d'écran le présente plus tard ou pas du tout. Affirmez les faits du navigateur que vous contrôlez, puis faites une assertion distincte sur le résultat visible par l'utilisateur. Cette séparation permet au propriétaire de la page de corriger la sémantique sans laisser entendre que le test a inspecté des données de service privé.

Préférez un trajet par épreuve. Un test de connexion ne doit pas également vérifier une boîte de dialogue de paramètres et une exportation de fichier, car un échec de focus lors de la première étape masquerait les contrats ultérieurs. Donnez à chaque parcours une entrée synthétique, un propriétaire et un chemin de nettoyage. Gardez le résultat court : étiquette du scénario, versions du navigateur et du framework, nom du contrat ayant échoué et une capture d'écran ou une référence de trace autorisée. Ne sérialisez jamais de jetons, de texte d'une page complète ou d'une session privée simplement parce que le pilote le peut.

Vérifiez les noms, les rôles et les états sans surapprentissage

Les localisateurs accessibles décrivent ce qu'une personne peut identifier. Un rôle avec un nom accessible, une étiquette associée à un contrôle de formulaire ou un identifiant de test stable rend le test lisible. Une classe générée ou un chemin CSS profond en dit peu sur l'interaction et tend à se rompre lors d'un travail de mise en page inoffensif. Lorsqu'un contrôle n'a intentionnellement aucun texte visible, documentez son nom accessible et testez-le dans le cadre du contrat du composant. Si le bouton semble identique après un changement de nom, comparez son arbre ARIA à sa capture d’écran avant de valider le nouveau nom.

Les noms et les descriptions ne sont pas interchangeables. Une boîte de dialogue a besoin d'un nom qui identifie son objectif ; une description peut ajouter du contexte. Un champ obligatoire doit exposer son état requis, et un champ non valide doit exposer une relation d'erreur qui pointe vers un texte utile. Testez la transition d'état, pas seulement le balisage initial. Un formulaire peut afficher aria-invalid="true" tout en laissant l'ancien message d'erreur dans le DOM, ce qui est un résultat déroutant à la fois pour l'automatisation et la technologie d'assistance.

Évitez d'affirmer des attributs ARIA accidentels lorsque le HTML natif fournit déjà le comportement. Un bouton, une étiquette, un titre, une liste et un lien natifs comportent une sémantique et un comportement du clavier bien défini. ARIA peut décrire un widget personnalisé, mais le propriétaire du widget doit implémenter son modèle d'interaction. Une vérification automatisée qui ne voit qu'un role="button" ne peut pas confirmer que Space et Enter l'activent tous les deux, que le focus reste visible ou qu'un état désactivé empêche une activation accidentelle.

Tester le parcours du focus clavier comme une fonctionnalité à part entière

Les tests au clavier doivent suivre la tâche, plutôt qu'une séquence aléatoire de pressions sur la touche Tab. Commencez avec le focus sur un élément connu, parcourez les contrôles pertinents, déclenchez une action et notez quel élément reçoit ensuite le focus. Une boîte de dialogue modale doit déplacer le focus vers son contenu, l'y maintenir tant qu'elle est ouverte et le rendre à un contrôle déclencheur approprié lorsqu'elle se ferme. Un lien d'évitement doit devenir visible lorsqu'il reçoit le focus et permettre d'atteindre le repère prévu.

Parcourez le chemin avec Tab et vérifiez le chemin d'annulation prévu avec Escape.

Vérifiez qu'un indicateur de focus est visible, sans imposer une couleur ou une valeur de pixel précise. Le contrat exige que l'utilisateur puisse identifier le contrôle qui a le focus dans le thème approuvé. Une capture d'écran peut étayer une revue, mais ne prouve pas que le contraste est suffisant sur tous les écrans. Limitez les assertions CSS et de styles calculés aux propriétés gérées par le composant ; confiez les appréciations visuelles nuancées à une revue humaine incluant le contraste élevé et le zoom.

Testez les alternatives de clavier pour les widgets personnalisés. Un menu, une zone de liste déroulante, une liste de tabulations, une arborescence ou une boîte de dialogue possède un ensemble documenté de clés et de changements d'état. Testez les clés prises en charge, l’état sélectionné ou développé et la cible de focus suivante. Incluez Escape ou le chemin d’annulation documenté. N'appuyez pas sur des touches arbitraires jusqu'à ce que quelque chose change ; cela transforme un contrat déterministe en enquête et peut rendre un échec difficile à classer.

Un test du clavier devrait également couvrir le chemin bloqué. Si un champ obligatoire est vide, soumettez avec le clavier et vérifiez que l'erreur est visible, associée au champ et accessible dans un ordre logique. Si une boîte de dialogue d'autorisation est refusée, vérifiez que la page propose une alternative utilisable. Un test qui ne couvre que le chemin heureux peut laisser les utilisateurs de clavier bloqués exactement là où l'application doit expliquer un problème.

Vérifier les annonces et le contenu dynamique

Les interfaces dynamiques nécessitent une stratégie d'annonce. Un message de statut poli peut utiliser une région en direct ; une interruption urgente peut nécessiter une politique différente. Le test peut affirmer que la région existe, possède le rôle ou le niveau de politesse prévu et reçoit le court texte attendu après l'action. Il ne faut pas prétendre que chaque lecteur d'écran, paramètre vocal ou file d'attente du système d'exploitation présente le message de la même manière.

Pour une mise à jour courante, vérifiez role="status" et aria-live="polite" sur la région prévue.

Maintenez la stabilité des assertions de région active. Attendez le changement d'état nommé, puis lisez une fois le texte accessible de la région. N'interrogez pas en déclenchant l'action à plusieurs reprises et n'acceptez aucune chaîne non vide comme succès. Si l'application met intentionnellement à jour la même région plusieurs fois, affirmez le message final pertinent pour l'utilisateur et enregistrez la transition qui y a conduit. Un délai d'attente doit identifier l'annonce manquante et ne pas simplement indiquer que la page était lente.

Les états de chargement et d'erreur méritent la même attention. Un indicateur de chargement animé ne suffit pas toujours à expliquer la progression à une personne qui ne voit pas l'écran ; un bouton désactivé sans explication peut sembler défectueux. Testez la relation entre l'état occupé, le texte de statut et le contenu finalement affiché. Lorsqu'une requête échoue, vérifiez que l'erreur est annoncée ou placée là où l'utilisateur la rencontrera, et que les nouvelles tentatives ou les actions alternatives sont accessibles au clavier.

N'utilisez pas l'automatisation pour collecter des arbres d'accessibilité sur des sites sans rapport avec le test ou dans des sessions d'utilisateurs réels. Dans une configuration de test contrôlée, un instantané d'accessibilité peut aider à comparer un composant avant et après une modification. Conservez uniquement les nœuds nécessaires pour expliquer l'assertion, masquez le contenu utilisateur et appliquez la même politique de conservation que pour les captures d'écran et les traces. L'instantané prouve une observation dans un navigateur ; il ne constitue ni le dossier d'une personne ni une note universelle d'accessibilité.

Rendre les fixtures de test et les exécutions parallèles inclusives

Une fixture de test d'accessibilité possède plus qu'un contexte de navigateur. Elle possède la fenêtre d'affichage initiale, le zoom ou la taille du texte, la préférence de mouvement réduit si nécessaire, la langue, le compte synthétique et le répertoire d'artefacts. Indiquez les valeurs fixes du scénario et celles qui varient dans une matrice séparée. Un exécuteur ne doit jamais hériter du focus, du stockage, du chemin de téléchargement ou du nom de capture d'écran d'un autre exécuteur.

Fixez la fenêtre avec page.setViewportSize({ width: 1280, height: 800 }) et consignez reducedMotion: 'reduce' lorsque cette préférence est testée.

Utilisez un contexte propre pour chaque parcours indépendant lorsque les cookies, les autorisations ou les préférences enregistrées influencent le résultat. Un contexte isole l'état géré par le navigateur, mais n'est pas un bac à sable du système d'exploitation et ne supprime pas un enregistrement serveur. Si une application stocke une préférence à distance, demandez au propriétaire de l'application l'opération de réinitialisation prise en charge. La fixture peut rapporter ce que le navigateur a observé avant et après cette opération. Pour les structurer, voir Fixtures et isolation pour l'automatisation du navigateur.

Les exécuteurs parallèles doivent utiliser des enregistrements synthétiques et des chemins de sortie privés. Si deux exécuteurs modifient le même enregistrement, un contexte propre ne peut pas empêcher une condition de concurrence dans le service. Préférez des enregistrements indépendants ou sérialisez la mutation précise. Une nouvelle tentative est une nouvelle tentative : fermez l'ancien contexte lorsque son état est incertain, créez un nouveau contexte dont le test est propriétaire et signalez que la première action a peut-être atteint l'application. Ne masquez jamais une possible soumission en double derrière une attente plus longue. Les fichiers de sortie de ces exécutions sont traités dans Fiabiliser les tests de transfert de fichiers dans le navigateur.

Incluez un cas d'échec intentionnel dans la suite de fixtures. Retenez un point de repère, retardez une mise à jour de statut ou renvoyez depuis la page synthétique une erreur de validation documentée. Le résultat attendu est un échec limité qui nomme le contrat manquant, suivi d'un nettoyage déterministe. Cela vérifie le harnais de test, et non un service de production, et maintient des preuves d'accessibilité proportionnées à la question posée.

Distinguer la prise en charge des outils des affirmations de conformité

Playwright et Selenium peuvent piloter la saisie au clavier, inspecter les noms accessibles et attendre un état visible ou sémantique. Leurs API différentes et la prise en charge par le navigateur des fonctionnalités liées à l'accessibilité peuvent varier selon la version. Enregistrez le framework, le pilote, le navigateur, le système d'exploitation et les préférences pertinentes avec le résultat. Une exécution passée sur un tuple est une preuve de ce tuple ; ce n’est pas une promesse que chaque navigateur et technologie d’assistance se comporte de manière identique. Le côté Selenium est décrit dans Intégrer un profil de navigateur avec Selenium.

Les moteurs de règles automatisés peuvent détecter les noms manquants, les identifiants en double, les risques de contraste et certains problèmes structurels. Utilisez-les comme une aide à la révision, et non comme un substitut à l'exploration du clavier, au zoom, à la redistribution, aux vérifications du lecteur d'écran ou à la recherche d'utilisateurs spécifiques à un domaine. Un rapport de règle doit identifier le nœud et la règle, tandis que le test de parcours doit expliquer si l'utilisateur peut terminer la tâche. Séparez les échecs des deux outils afin qu’un avertissement de règle ne soit pas interprété à tort comme un échec commercial.

Lorsqu'un navigateur expose un instant d'accessibilité ou un rôle calculé, comparez uniquement les champs stables et pertinents pour l'utilisateur. Les formats instantanés peuvent changer entre les versions du framework. Préférez une assertion telle que « le bouton Enregistrer est nommé Enregistrer le profil et est activé après une entrée valide » plutôt qu'une comparaison d'arborescence octet par octet. Stockez une petite différence ou une référence d'élément et examinez intentionnellement les modifications plus importantes lorsque la sémantique d'un composant est repensée.

La spécification W3C WebDriver définit les limites de l'automatisation, tandis que les WCAG traitent les résultats qui impliquent des personnes et du contenu. Aucune des deux sources n'indique qu'un produit, un profil ou un pilote d'automatisation particulier peut certifier la conformité. Formulez votre rapport en conséquence : répertoriez les parcours testés, les environnements, les pannes référencées et les vérifications manuelles encore nécessaires.

Capacité et limitations de BotBrowser

BotBrowser fournit des BrowserContexts isolés avec des cookies, un stockage et un état de session séparés, ce qui aide les équipes à répéter les parcours d'accessibilité autorisés à partir de points de départ connus côté navigateur. BotBrowser ne remplace pas les assertions d'accessibilité de Playwright ou Selenium, la politique du lecteur d'écran ou du clavier, la sémantique de l'application, la révision WCAG ou le nettoyage côté serveur. Il ne peut pas garantir qu'une application cible expose un nom accessible correct, qu'une technologie d'assistance prononce une mise à jour de région en direct ou qu'une session et un enregistrement à distance sont invalidés. La personne responsable de la configuration de test choisit toujours le framework, crée et ferme les contextes, contrôle les données synthétiques et obtient, auprès du responsable de l'application, les preuves qui dépassent les limites du navigateur.

Conservez la capacité et les limitations ensemble dans les rapports. Enregistrez l'objectif du contexte, la version du navigateur, les entrées de préférences, le contrat de parcours de test, le résultat observé et les vérifications manuelles restantes. Ne décrivez pas un profil isolé comme une preuve d'accessibilité ou comme un moyen de contourner les contrôles d'une application. Un état local propre rend un test reproductible ; cela ne change pas les responsabilités de la page, du service ou de la technologie d'assistance.

Examiner les échecs et maintenir la suite de tests

Classez un échec avant de modifier un localisateur ou un délai d'attente. Un nom accessible manquant est un défaut de composant. Un piège de focus qui ne se libère jamais peut être un défaut du cycle de vie du widget. Une annonce manquante peut être un problème d’état de page ou d’intégration de technologie d’assistance. Une déconnexion du conducteur est une preuve d’infrastructure. Un rejet du serveur est un résultat d’application. Le test du navigateur doit conserver le premier contrat manquant et acheminer l'action suivante vers le propriétaire qui peut le modifier.

Nommez le contrat en échec dans test.step() et ne conservez qu'un page.screenshot() autorisé si une preuve visuelle est nécessaire.

Passez en revue les chemins négatifs après chaque changement de composant. Testez un formulaire vide, une valeur rejetée, une autorisation refusée, une réponse lente, une boîte de dialogue fermée et une navigation interrompue où ces états font partie du parcours. Vérifiez que chaque erreur a une explication lisible et une action suivante accessible. Conservez la même limite de preuve pour la réussite et l'échec afin qu'un échec ne collecte pas souvent davantage de contenu de page privée.

Avant la fusion, exécutez un parcours clavier dans un contexte propre, un parcours sensible aux préférences le cas échéant et un échec de démontage forcé. Confirmez que le focus revient à un propriétaire intentionnel, que les artefacts sont spécifiques au travailleur et que le nettoyage s'exécute après des erreurs d'assertion et de configuration. Revérifiez le navigateur et le tuple du framework lorsque les versions changent. Un test stable n'est pas un test qui n'échoue jamais ; son échec identifie un contrat destiné à l'utilisateur et ne laisse aucun état susceptible de fausser l'exécution suivante.

L'automatisation de l'accessibilité fonctionne mieux en tant que pratique à plusieurs niveaux : les localisateurs sémantiques protègent la signification des composants, les parcours au clavier protègent l'achèvement des tâches, les annonces et les états d'erreur protègent la communication et l'examen humain protège les expériences que le code ne peut pas modéliser. Gardez chaque couche explicite, délimitée et honnête sur ce qu'elle observe. Cette discipline fournit aux équipes produit des preuves de régression utiles sans transformer une fonctionnalité de navigateur en une garantie de conformité non prise en charge.

Les contrôles d'accessibilité deviennent plus faciles à maintenir lorsque chaque résultat mentionne le parcours testé, l'environnement, le propriétaire et l'incertitude restante. Conservez un bref historique des versions testées du navigateur et du framework, notez si un examen humain a couvert le zoom ou un lecteur d'écran, et revisitez le contrat lorsqu'un composant change. Cet enregistrement aide les clients à comparer les versions, à hiérarchiser les correctifs et à éviter de considérer une seule passe automatisée comme une promesse universelle.

Sources

Voir aussi le cycle de vie de BrowserContext et la validation des interactions du navigateur.

Un rapport d'accessibilité doit indiquer ce qui a été observé, ce qui ne l'a pas été et quel responsable reçoit l'action suivante. Cette pratique garde une communication précise avec les clients lorsque le navigateur, le framework ou la technologie d'assistance change.

Conclusion pratique

Rejouez le parcours clavier dans un contexte propre, affirmez le nom accessible et le statut annoncé, puis consignez le navigateur, le framework et la fenêtre d'affichage à côté du résultat. Une assertion getByRole ne couvre que la combinaison testée : le zoom, le contraste élevé et la lecture par un lecteur d'écran restent dans la liste d'examen manuel, et l'incertitude restante figure dans le même enregistrement.

#Browser Automation#Accessibility Testing#Keyboard Testing#Playwright#Selenium

Cet article fait partie du guide : Débuter avec l'automatisation du navigateur : carte initiale

Exécutez la même vérification dans BotBrowser

Chargez un profil, gardez dans le navigateur les signaux que vous venez de lire, puis confirmez le résultat sur votre propre machine avant le déploiement.