Visão Geral da API Python
Visão geral do Axe DevTools para Web para Python, incluindo pacotes disponíveis e integrações com frameworks de teste
O Axe DevTools Python inclui:
- versão 4 do axe-core
- Suporte para Python 3 (não suporta Python 2)
- configurações de teste baseadas em unittest, robot framework, behave, bem como qualquer outro framework que use
asserts
As verificações são executadas contra o nível AA do WCAG 2.1 por padrão, com as regras de melhores práticas e experimentais desativadas. Veja Personalizando Regras para alterar o conjunto de regras ou ativar as melhores práticas.
Pré-requisitos
O Axe DevTools requer uma vinculação do Selenium WebDriver para um navegador de sua escolha. Para usar o Axe DevTools, você deve primeiro instalar e configurar o Selenium WebDriver.
Descrição
O Axe DevTools é composto por várias partes. O pacote principal é axe-devtools-api, que fornece a lógica para configurar e executar o axe. axe-devtools-selenium é usado para permitir que axe-devtools-api se comunique efetivamente com os navegadores.
Existem três integrações com frameworks de teste.
axe-devtools-unittest é uma biblioteca de asserção leve para unittest que opera sobre axe-devtools-api. Ao usar essa integração, você deve declarar axe-devtools-api como uma dependência e usá-la diretamente.
axe-devtools-robot integra o Axe DevTools com o Robot Framework. axe-devtools-api e axe-devtools-selenium são trazidos automaticamente como dependências. No entanto, você não interagirá com nenhum deles. Em vez disso, a integração fará uso do seu arquivo .robot para operar o axe.
axe-devtools-behave integra o Axe DevTools com o behave, um framework de teste semelhante ao cucumber. axe-devtools-api e axe-devtools-selenium são trazidos automaticamente como dependências. No entanto, você não interagirá com nenhum deles. Em vez disso, a integração fará uso do seu arquivo .feature para operar o axe.
Elementos Personalizados e ElementInternals
A partir do Axe DevTools Python 4.13.0, as varreduras leem as semânticas ARIA que os componentes web declaram em JavaScript através de ElementInternals, em vez de apenas os atributos role e aria-* presentes na marcação. Nenhuma configuração é necessária. As semânticas no DOM ainda têm precedência: um atributo explícito role ou aria-* no elemento substitui o valor de ElementInternals.
Seus componentes devem publicar seus internos para que qualquer uma dessas ações tenha efeito, e um componente que os armazena em um campo de classe privado não pode ser lido. Veja Testando Elementos Personalizados que Usam ElementInternals.