Riferimento API di axe-devtools-robot

Questa libreria consente ad Axe DevTools di testare l'accessibilità usando Robot Framework.

axe_devtools_robot.AxeRobot

Estende SeleniumLibrary, quindi tutte le parole chiave disponibili per SeleniumLibrary sono anche disponibili per AxeRobot.

Importa la libreria nella sezione delle impostazioni della tua suite di test:

*** Settings ***
Library  axe_devtools_robot.AxeRobot

Analyze

Esegui axe-core sulla pagina e fallisci il test se ci sono violazioni.

Audit For Accessibility

Esegui axe-core sulla pagina e salva i risultati nella directory axe-reports . Sia un file .log (rapporto delle violazioni) che un file .json (risultati completi) vengono scritti. Non fallisce mai.

Within

Specifica una parte della pagina per l'analisi di axe-core.

selectors: Uno o più selettori CSS per gli elementi da includere.

Excluding

Specifica una parte della pagina che axe-core deve saltare durante l'analisi.

selectors: Uno o più selettori CSS per gli elementi da escludere.

According To

Specifica le regole (per tag) che axe-core deve eseguire.

tags: Uno o più nomi di tag. Vedi tag di axe-core per un elenco di tag validi.

According To Ruleset

Usa uno specifico set di regole per l'esecuzione di axe-core.

ruleset: ID del set di regole da utilizzare. Set di regole disponibili: wcag2, wcag2.1, wcag2.2, wcag2aaa, wcag2.1aaa, wcag2.2aaa, 508, en301549, ttv5, rgaav4.

enable_best_practices: Se abilitare le regole etichettate best-practice. Impostazione predefinita: False.

Checking Only

Specifica le regole (per ID) che axe-core deve eseguire. Solo le regole specificate sono utilizzate.

rules: Uno o più ID di regole. Vedi Descrizioni delle regole per un elenco di ID validi.

Skipping

Disabilita regole specifiche dall'esecuzione di axe-core.

rules: Uno o più ID di regole.

Sull'uso di id selettori CSS

Robot Framework tratta il carattere # come speciale. A meno che tu non esegua l'escape dei tuoi #, Robot interpreterà il resto della linea come un commento.

In pratica, questo significa che dovrai usare \# invece di solo #.

Vedi documentazione del Robot per maggiori dettagli.

Esempio

*** 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