Referência da API Python do axe-devtools-api
Referência da API para o pacote Python axe-devtools-api para injetar e executar o axe-core
Fornece uma API com a qual é possível injetar e executar o axe-core em uma página web.
axe_devtools_api.Axe
Configura como o axe-core é executado e o executa na página.
report = Axe(page).with_rules("document-title", "label").analyze()Axe(page, report_configuration=None, axe_source=None)
Inicialize uma instância de Axe com um adaptador de navegador e configuração opcional.
page: Um adaptador de navegador, como uma AxeDriver instância de axe-devtools-selenium.
report_configuration: Opcional. Um objeto de configuração de relatório.
axe_source: Opcional. Uma string de código-fonte do axe-core para usar em vez da versão incluída.
analyze()
Injete o axe-core na página e execute a análise de acessibilidade.
Retorna um Results objeto. Veja Gerando Relatórios com Python para a Results API completa e como configurar metadados de relatório.
report = Axe(page).analyze()including(*selector)
Especifique parte da página para o axe-core analisar.
selector: Um ou mais seletores CSS para incluir elementos.
Retorna este objeto para encadeamento.
report = Axe(page).including(".sidebar-frame", ".some-class").analyze()excluding(*selector)
Especifique parte da página para o axe-core pular durante a análise.
selector: Um ou mais seletores CSS para excluir elementos.
Retorna este objeto para encadeamento.
report = Axe(page).excluding(".iframe1", ".third-party-ad").analyze()with_rules(*rules)
Especifique regras (por ID) para o axe-core executar. Apenas as regras especificadas são usadas. Esta opção é incompatível com with_tags.
rules: Um ou mais IDs de regra. Veja Descrições de Regras para uma lista de IDs válidos.
Retorna este objeto para encadeamento.
Lança RuntimeError se chamado junto com with_tags na mesma instância.
report = Axe(page).with_rules("document-title", "label").analyze()with_tags(*tags)
Especifique regras (por etiqueta) para o axe-core executar. Apenas as regras especificadas são usadas. Esta opção é incompatível com with_rules.
tags: Um ou mais nomes de etiqueta. Veja etiquetas do axe-core para uma lista de etiquetas válidas.
Retorna este objeto para encadeamento.
Lança RuntimeError se chamado junto com with_rules na mesma instância.
report = Axe(page).with_tags("best-practice", "wcag2a").analyze()disabling_rules(*rules)
Desative regras específicas da execução do axe-core.
rules: Um ou mais IDs de regra.
Retorna este objeto para encadeamento.
report = Axe(page).disabling_rules("html-has-lang", "label").analyze()run_options(options)
Especifique opções de execução para passar para o axe-core ao chamar axe.run.
options: Objeto de opções para passar para o axe-core.
Retorna este objeto para encadeamento.
options = {"iframes": False}
report = Axe(page).run_options(options).analyze()configure(spec)
Configure o axe-core através de axe.configure.
spec: Objeto Spec para passar para axe.configure.
Retorna este objeto para encadeamento.
report = Axe(page).configure(spec).analyze()without_iframe_sandboxes()
Remove o sandbox atributo de iframes para que o axe-core possa ser executado dentro deles.
Retorna este objeto para encadeamento.
report = Axe(page).without_iframe_sandboxes().analyze()with_config_file(config_path)
Defina o caminho para um arquivo de configuração do conjunto de regras. O caminho padrão é config/axe-ruleset.json, ou o valor da variável de ambiente $AXE_RULESET_PATH se definida.
config_path: Caminho para o arquivo de configuração.
Retorna este objeto para encadeamento.
report = Axe(page).with_config_file("path/to/file.json").analyze()with_ruleset(ruleset_id, enable_best_practices=False)
Use um conjunto de regras específico para a execução do axe-core.
ruleset_id: 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 habilitar regras marcadas best-practice. Padrão para False.
Retorna este objeto para encadeamento.
report = Axe(page).with_ruleset("508").analyze()set_legacy_mode(state=True)
Use axe.run em vez de axe.runPartial. Tem implicações de origem cruzada.
state: Se deve habilitar o modo legado. Padrão para True.
Retorna este objeto para encadeamento.
report = Axe(page).set_legacy_mode().analyze()Serviço de Uso
Obtenha insights sobre as tendências de uso do Axe DevTools dentro da sua organização. Por padrão, o serviço de uso está desabilitado. A URL padrão é https://usage.deque.com.
Variáveis de ambiente do serviço de uso
As seguintes variáveis de ambiente configuram o serviço de uso.
| Variável de Ambiente | Tipo |
|---|---|
| AXE_IS_LOGGED_IN | Booleano |
| AXE_KEYCLOAK_ID | String |
| AXE_USER_ID | String |
| AXE_SESSION_ID | String |
| AXE_USER_STATUS | String |
| AXE_USER_JOB_ROLE | String |
| AXE_DISTINCT_ID | String |
| AXE_IS_DEV_INSTANCE | Booleano |
| AXE_ORGANIZATION | String |
| AXE_APPLICATION | String |
| AXE_METRICS_URL | String |
| AXE_TRACK_USAGE | Booleano |
enable_tracking(state)
Optar por enviar ou não dados ao serviço de uso.
state: Se o rastreamento está habilitado.
Retorna este objeto para encadeamento.
report = Axe(page).enable_tracking(True).analyze()set_tracking_url(url)
Definir para onde os dados das métricas de uso são enviados.
url: URL para onde os dados serão enviados.
Retorna este objeto para encadeamento.
report = Axe(page).set_tracking_url("https://usage.deque.com").analyze()set_distinct_id(id)
Definir o ID distinto usado ao enviar métricas de uso.
id: ID distinto a ser enviado.
Retorna este objeto para encadeamento.
report = Axe(page).set_distinct_id("SOMEUUID").analyze()