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 également 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 de violations) et un fichier .json (résultats complets) sont écrits. Ne jamais échouer.

Within

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

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

Excluding

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

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

According To

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

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

According To Ruleset

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

ruleset: ID de l'ensemble de règles à utiliser. Ensembles de règles disponibles : wcag2, wcag2.1, wcag2.2, wcag2aaa, wcag2.1aaa, wcag2.2aaa, 508, en301549, ttv5, rgaav4.

enable_best_practices: Si vous souhaitez activer les règles étiquetées best-practice. Par défaut, 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 d'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 id sélecteurs CSS

Robot Framework traite le caractère # comme spécial. À moins que vous n'échappiez vos #, 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