Generar informes con Python

axe-devtools-api produce resultados en un formato compatible con el Axe DevTools reporter.

Crear JSON compatible con reportes

Axe.analyze() devuelve un objeto Results. Se puede convertir a una cadena JSON compatible con el reportero mediante Results.to_json().

Aquí hay un ejemplo donde analizamos una página y guardamos los resultados en un archivo:

axe = Axe(driver)
results = axe.analyze()
with open("my_results.json", "w") as f:
    f.write(results.to_json())

Configuración del informe

Los metadatos del informe se configuran a través de la clase ReportConfiguration.

Una vez que un objeto ReportConfiguration está en el estado deseado, se puede aplicar a un análisis de dos maneras:

1. Aplíquelo a un único análisis pasándolo a Axe():

   report_config = ReportConfiguration().test_suite_name("my suite").ui_state("some state")
   axe = Axe(driver, report_configuration=report_config)
   results = axe.analyze()
   
   assert results.name == "my suite"
   assert results.id == "some state"

2. Establécelo como el predeterminado para todos los escaneos que no lo sobrescriban individualmente:

   ReportConfiguration().test_suite_name("my suite").set_as_default()
   
   axe = Axe(driver)
   results = axe.analyze()
   
   assert results.name == "my suite"

Para obtener la instancia ReportConfiguration que actualmente está establecida como predeterminada, llame a ReportConfiguration.get_default().

axe_devtools_api.Results

Devuelto por Axe.analyze(). Contiene los hallazgos de axe-core y proporciona métodos para inspeccionarlos y serializarlos.

Propiedades

name

El nombre del conjunto de pruebas. Se establece a través de ReportConfiguration.test_suite_name(). Por defecto es "axe-run".

id

El identificador del análisis — una combinación del valor del estado de la UI (establecido a través de ReportConfiguration.ui_state()) y un UUID, unidos por un guion. Por defecto es "check-<uuid>".

Métodos

to_json()

Convierte los resultados a una cadena JSON compatible con reportes.

is_axe_clean()

Devuelve True si axe-core se ejecutó sin errores y no encontró violaciones.

is_errored()

Devuelve True si axe-core encontró un error durante la ejecución.

violations_report()

Devuelve una cadena legible que resume las violaciones encontradas. Si axe-core tuvo errores, devuelve el mensaje de error en su lugar.

axe_devtools_api.ReportConfiguration

Configura metadatos del informe como el nombre del conjunto de pruebas y la información del agente de usuario.

report_config = ReportConfiguration().test_suite_name("my suite").ui_state("login page")
axe = Axe(driver, report_configuration=report_config)

ReportConfiguration()

Crea un nuevo ReportConfiguration con valores predeterminados.

get_default()

Devuelve el ReportConfiguration predeterminado actual. Tenga en cuenta que el predeterminado puede cambiarse mediante set_as_default().

set_as_default()

Establezca este objeto como la configuración predeterminada para todas las instancias de Axe que no especifiquen su propia configuración.

reset_default()

Restablece la configuración predeterminada a su estado inicial.

test_suite_name(name)

Establezca el nombre del conjunto de pruebas. Se utiliza como el campo name en el objeto Results.

name: El nombre del conjunto de pruebas.

Devuelve este objeto para encadenamiento.

ui_state(id)

Establezca el estado de la UI para este conjunto de pruebas. Se utiliza como el campo id en el objeto Results.

id: Un identificador de cadena para el estado de la UI (por ejemplo, "login-page" o "dark-mode").

Devuelve este objeto para encadenamiento.

user_agent(ua)

Establezca la cadena del agente de usuario registrada en el informe.

ua: La cadena del agente de usuario.

Devuelve este objeto para encadenamiento.

test_machine(t_machine)

Establezca el nombre de la máquina en la que se ejecutaron las pruebas.

t_machine: Un identificador para la máquina.

Devuelve este objeto para encadenamiento.

Ver También

• Cargando Resultados de Accesibilidad JSON a Axe Reports describe cómo cargar tus resultados en Axe Reports.
• Obteniendo una Clave API de Axe Reports explica cómo obtener una clave API para comenzar a usar Axe Reports.
• Crear y Filtrar Informes muestra cómo puedes crear informes de accesibilidad en CSV, XML o HTML a partir de tus resultados de accesibilidad JSON. También puedes filtrar tu salida por severidad utilizando esta herramienta.
• Cómo se Almacenan los Resultados JSON en el Disco describe las convenciones de nomenclatura de archivos para resultados de accesibilidad JSON.
• Usando la CLI para Enviar Resultados de Accesibilidad al Centro de Desarrolladores de Axe muestra cómo puedes subir tus archivos de resultados .json a Centro de Desarrolladores de Axe.