Referência da API axe-devtools-robot

Esta biblioteca permite que o Axe DevTools teste acessibilidade usando o Robot Framework.

axe_devtools_robot.AxeRobot

Estende SeleniumLibrary, de modo que todas as palavras-chave disponíveis para SeleniumLibrary também estejam disponíveis para AxeRobot.

Importe a biblioteca na seção de configurações da sua suíte de testes:

*** Settings ***
Library  axe_devtools_robot.AxeRobot

Analyze

Execute o axe-core na página e falhe o teste se houver quaisquer violações.

Audit For Accessibility

Execute o axe-core na página e salve os resultados no diretório axe-reports . Tanto um arquivo .log (relatório de violações) quanto um arquivo .json (resultados completos) são gravados. Nunca falha.

Within

Especifique parte da página para o axe-core analisar.

selectors: Um ou mais seletores CSS para elementos a serem incluídos.

Excluding

Especifique parte da página para o axe-core ignorar durante a análise.

selectors: Um ou mais seletores CSS para elementos a serem excluídos.

According To

Especifique regras (por tag) para o axe-core executar.

tags: Um ou mais nomes de tags. Veja tags do axe-core para uma lista de tags válidas.

According To Ruleset

Use um conjunto de regras específico para a execução do axe-core.

ruleset: ID do conjunto de regras a ser usado. Conjuntos de regras disponíveis: wcag2, wcag2.1, wcag2.2, wcag2aaa, wcag2.1aaa, wcag2.2aaa, 508, en301549, ttv5, rgaav4.

enable_best_practices: Se deve ativar regras marcadas best-practice. Padrão para False.

Checking Only

Especifique regras (por ID) para o axe-core executar. Apenas as regras especificadas são usadas.

rules: Um ou mais IDs de regras. Veja Descrições de Regras para uma lista de IDs válidos.

Skipping

Desative regras específicas da execução do axe-core.

rules: Um ou mais IDs de regras.

Sobre o uso de id seletores CSS

O Robot Framework trata o # como especial. A menos que você escape seus #s, o Robot interpretará o resto da linha como um comentário.

Na prática, isso significa que você terá que usar \# em vez de apenas #.

Veja documentação do Robot para mais detalhes.

Exemplo

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