Référence de l'API axe-devtools-robot

Cette bibliothèque permet à Axe DevTools de tester l'accessibilité en utilisant Robot Framework.

axe_devtools_robot.AxeRobot

Étend SeleniumLibrary, donc tous les mots-clés disponibles pour SeleniumLibrary sont aussi disponibles pour AxeRobot.

Importez la bibliothèque dans la section des paramètres de votre suite de tests :

*** Settings ***
Library  axe_devtools_robot.AxeRobot

Analyze

Exécutez axe-core sur la page et échouez au test s'il y a des violations.

Audit For Accessibility

Exécutez axe-core sur la page et enregistrez les résultats dans le répertoire axe-reports. Un fichier .log (rapport des violations) et un fichier .json (résultats complets) sont enregistrés. Cela ne rate jamais.

Within

Spécifiez une partie de la page pour qu'axe-core l'analyse.

selectors : Un ou plusieurs sélecteurs CSS pour les éléments à inclure.

Excluding

Spécifiez une partie de la page à ignorer par axe-core lors de l'analyse.

selectors : Un ou plusieurs sélecteurs CSS pour les éléments à exclure.

According To

Spécifiez les règles (par tag) qu'axe-core doit exécuter.

tags : Un ou plusieurs noms de balises. Voir tags axe-core pour une liste des balises valides.

According To Ruleset

Utilisez un ensemble de règles spécifique pour l'exécution d'axe-core.

ruleset : ID du jeu de règles à utiliser. Jeux de règles disponibles : wcag2, wcag2.1, wcag2.2, wcag2aaa, wcag2.1aaa, wcag2.2aaa, 508, en301549, ttv5, rgaav4.

enable_best_practices : S'il faut activer les règles marquées best-practice. Par défaut, cela vaut False.

Checking Only

Spécifiez les règles (par ID) qu'axe-core doit exécuter. Seules les règles spécifiées sont utilisées.

rules : Un ou plusieurs IDs de règles. Voir Descriptions des Règles pour une liste des IDs valides.

Skipping

Désactivez des règles spécifiques de l'exécution d'axe-core.

rules : Un ou plusieurs IDs de règles.

Sur l'utilisation des sélecteurs CSS id

Le cadre Robot Framework considère le caractère # comme spécial. À moins de masquer vos #s, Robot interprétera le reste de la ligne comme un commentaire.

En pratique, cela signifie que vous devrez utiliser \# au lieu de simplement #.

Voir la documentation du robot pour plus de détails.

Exemple

*** Settings ***
Library  axe_devtools_robot.AxeRobot
Suite Setup  Set Log Level  DEBUG


*** Test Cases ***
Analyzes
  Open Browser  http://localhost:8000/example-page.html  Chrome
  Analyze
Audits
  Open Browser  http://localhost:8000/example-page.html  Chrome
  Audit For Accessibility

Uses Within
  Open Browser  http://localhost:8000/example-page.html  Chrome
  Within  body
  Analyze
Close browsers
  Close All Browsers