Vos tests restent sous Playwright, Selenium et pytest. Nous ne les remplaçons pas. Nous les adaptons aux exigences des entreprises, et vous restez propriétaire de votre code, de vos preuves et de votre historique.

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ètrePar défautFonctionnalités
NEXUS_A11Y_ENABLEDfalseExécute l’audit axe-core sur la page où se termine le test.
NEXUS_A11Y_STANDARDwcag21aaLe référentiel de règles : wcag2a, wcag2aa, wcag21a, wcag21aa ou wcag22aa.
NEXUS_A11Y_FAIL_LEVELseriousLe niveau d’impact minimal considéré comme une violation : minor, moderate, serious ou critical.
NEXUS_A11Y_STRICTfalseLorsque 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.

ImpactPoids dans le score
Critique25 points par règle enfreinte
Grave10 points par règle enfreinte
Modéré4 points par règle enfreinte
Mineur1 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 --a11y pour 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.