Automatisation des tests d’accessibilité avec axe-core et les WCAG.
L’automatisation des tests d’accessibilité dans Nexus StudioQA exécute axe-core sur la page active à la fin d’un test et répertorie chaque règle WCAG enfreinte, avec son impact et les éléments concernés. Par défaut, les résultats sont purement indicatifs. En mode strict, un test réussi présentant une violation grave ou critique reçoit le verdict A11Y_VIOLATION. Les vérifications automatisées ne détectent qu’une partie des problèmes d’accessibilité et ne remplacent donc pas un examen manuel.
Par l’équipe Nexus StudioQA, Verdict System LLC.
Dernière mise à jour : .
Ce qui est vérifié et comment activer la vérification
La vérification est désactivée tant que vous ne la demandez pas : --a11y pour une exécution, ou NEXUS_A11Y_ENABLED=true pour toutes les exécutions. Elle nécessite le module complémentaire @axe-core/playwright ; sans lui, le rapport indique “non mesuré” et le test n’est pas affecté.
| Paramètre | Par défaut | Fonctionnalités |
|---|---|---|
NEXUS_A11Y_ENABLED | false | Exécute l’audit axe-core sur la page où se termine le test. |
NEXUS_A11Y_STANDARD | wcag21aa | Le référentiel de règles : wcag2a, wcag2aa, wcag21a, wcag21aa ou wcag22aa. |
NEXUS_A11Y_FAIL_LEVEL | serious | Le niveau d’impact minimal considéré comme une violation : minor, moderate, serious ou critical. |
NEXUS_A11Y_STRICT | false | Lorsque la valeur est true, une violation atteignant ou dépassant le seuil d’échec attribue le verdict A11Y_VIOLATION à un test réussi. |
Fonctionnement du score et du verdict
A11Y_VIOLATION est l’un des 15 verdicts. Il s’applique uniquement à un test réussi, renvoie le code de sortie 0 en intégration continue, et le rapport ainsi que l’historique affichent la réserve. Un test en échec ne voit jamais son verdict aggravé, et l’audit est ignoré lors des exécutions en mode chaos. Un écran tactile, émulé ou réel, est également audité selon les WCAG 2.2 AA, qui ajoutent la taille des cibles.
| Impact | Poids dans le score |
|---|---|
| Critique | 25 points par règle enfreinte |
| Grave | 10 points par règle enfreinte |
| Modéré | 4 points par règle enfreinte |
| Mineur | 1 point par règle enfreinte |
Contenu du rapport
Un score et une note
Le score correspond à 100 moins les poids ci-dessus, comptés une seule fois par règle enfreinte et non par élément. Les notes sont A à partir de 90, B à partir de 75, C à partir de 60, D à partir de 40 et F en dessous. Il s’agit de notre propre synthèse pour une page, et non d’un niveau de conformité aux WCAG.
Les règles enfreintes
Jusqu’à 15 règles, les plus graves en premier, chacune accompagnée de son impact, de ses étiquettes WCAG, d’un lien vers sa page d’aide et de 5 exemples d’éléments au maximum. La section est ajoutée à report.md.
Un décompte des vérifications nécessitant une intervention humaine
axe-core marque certaines vérifications comme incomplètes lorsqu’il ne peut pas trancher. Le rapport les dénombre et indique qu’elles nécessitent un examen humain.
Ce que les vérifications automatisées ne détectent pas
Une vérification automatisée ne détecte qu’une partie des problèmes d’accessibilité d’une page. Un résultat sans anomalie ne signifie pas que la page est accessible, et Nexus StudioQA ne certifie pas la conformité aux WCAG.
Le sens, pas seulement le balisage
Une règle peut détecter qu’une image possède un texte alternatif. Elle ne peut pas juger si ce texte décrit l’image, ni si le libellé d’un lien est compréhensible hors contexte.
Utilisation au clavier ou avec un lecteur d’écran
Pour déterminer si l’ordre de lecture est cohérent et si la page peut être utilisée uniquement au clavier ou avec un lecteur d’écran, une personne doit en faire l’essai.
Un seul état de page par test
L’audit s’exécute sur la page où se termine le test. Une page que le test n’atteint jamais, ou un état fermé avant la fin, n’est pas audité.
Questions fréquentes
Les tests automatisés remplacent-ils un audit manuel d’accessibilité ?
Non. Ils détectent les infractions aux règles qu’une machine peut évaluer et signalent les autres points comme nécessitant un examen. Utilisez-les pour empêcher les régressions entre les audits manuels, et non pour les remplacer.
Un problème d’accessibilité fera-t-il échouer ma compilation ?
Pas par défaut. Les problèmes sont répertoriés dans le rapport. Avec
NEXUS_A11Y_STRICT=true, un test réussi présentant une violation atteignant ou dépassant le seuil d’échec reçoit le verdict A11Y_VIOLATION, qui renvoie toujours le code de sortie 0 en intégration continue.Quelle version des WCAG est vérifiée ?
WCAG 2.1 AA par défaut. Les paramètres proposent les versions 2.0 et 2.1 aux niveaux A et AA, ainsi que la version 2.2 AA. Sur un écran tactile, WCAG 2.2 AA est ajouté.
Est-ce compatible avec mes tests existants ?
Oui. L’analyse s’exécute en parallèle des assertions des tests Playwright, Selenium ou pytest lancés via Nexus StudioQA, avec
--a11ypour une exécution ou le paramètre activé pour toutes. Paramètres d’accessibilité
Exécutez-le sur votre propre machine.
Essayez gratuitement toutes les fonctionnalités, sur vos propres machines. Aucune carte bancaire requise.