Referencia de la API de Axe DevTools Node Reporter

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard

Referencia de API para el paquete @axe-devtools/reporter

Not for use with personal data

Este documento describe los métodos proporcionados por la clase AxeDevToolsReporter.

La clase AxeDevToolsReporter extiende la clase AxeDevToolsLogger (del paquete @axe-devtools/logger), por lo que puedes crear una instancia de AxeDevToolsReporter y llamar a los métodos ofrecidos por la clase AxeDevToolsLogger. Consulta el Referencia de Axe DevTools Logger para más información sobre los métodos proporcionados por la clase AxeDevToolsLogger.

Las firmas de métodos en esta página están escritas en notación TypeScript, coincidiendo con las declaraciones de tipo incluidas en el paquete. Los ejemplos de uso son en JavaScript y se compilan sin cambios en TypeScript. Para ver versiones de JavaScript y TypeScript lado a lado de un archivo completo, vea Generación de informes.

Constructor

constructor(reportName: string, directory?: string)

Ejemplo de uso:

const axeReporter = new AxeDevToolsReporter("AxeDevTools-Results", "./test-results/");

Parámetros

Nombre Tipo Descripción
reportName string El título del informe. El valor de reportName se convertirá en el primer segmento del nombre del archivo de resultados JSON.
directory string (opcional) Directorio donde se escribirá el informe. Los directorios se crearán recursivamente si no existen.

Métodos

Cada uno de estos métodos crea el informe especificado a partir del archivo JSON de resultados que se produce mediante el método logTestResult.

Nombre Descripción
buildCSV Crea un informe CSV
buildEARL Crea un informe W3C EARL JSON-LD
buildHTML Crea un informe HTML
buildJUnitXML Crea un informe XML

buildCSV

Crea un archivo CSV a partir del archivo JSON de resultados creado por el método logTestResult.

buildCSV(directory: string, userAgent?: string, filterOpts?: string[]): Promise<void>;

Parámetros

Nombre Tipo Descripción
directory string El directorio para crear el archivo de salida .csv. Todos los directorios se crearán de forma recursiva si no existen.
userAgent string (opcional) Solo los resultados con el agente de usuario especificado aparecerán en el archivo .csv
filterOpts string[] (opcional) Una matriz de opciones de filtro para seleccionar resultados.

Devoluciones

Promise<void>

buildEARL

Crea un archivo JSON-LD W3C EARL (Evaluation and Report Language) llamado axe-devtools-results.earl.json en el directorio especificado.

note

La salida EARL no admite resultados de Axe DevTools Mobile. Si hay resultados móviles presentes, buildEARL lanzará un error antes de escribir cualquier archivo.

buildEARL(directory: string, userAgent?: string): Promise<void>;

Parámetros

Nombre Tipo Descripción
directory string El directorio para crear el archivo de salida .earl.json. Todos los directorios se crearán de forma recursiva si no existen.
userAgent string (opcional) Solo aparecerán en el informe EARL los resultados con el agente de usuario especificado

Devoluciones

Promise<void>

buildHTML

Crea un archivo HTML en el directorio especificado a partir del archivo JSON de resultados de accesibilidad.

buildHTML(directory: string, userAgent?: string, renderOptions?: RenderOptions): Promise<void>;

Parámetros

Nombre Tipo Descripción
directory string El directorio para crear el archivo de salida .html. Todos los directorios se crearán de forma recursiva si no existen.
userAgent string (opcional) Solo los resultados con el agente de usuario especificado aparecerán en el archivo de informe .html
renderOptions RenderOptions (opcional) Controla cómo se pre-renderiza el informe en un marcado estático. Ver Pre-renderización de informes HTML.

Devoluciones

Promise<void>

OpcionesDeRenderizado

Se pasa a buildHTML para controlar cómo se pre-renderiza el informe en un marcado estático. Cada opción es opcional, y cada una tiene una variable de entorno que se aplica cuando la opción no está configurada. El renderizador se selecciona una vez por llamada, por lo que estas opciones se aplican a cada informe que construye esa llamada.

Nombre Tipo Predeterminado Descripción
browserPath string ninguno Ruta a un ejecutable de navegador utilizado para pre-renderizar el informe. Variable de entorno: AXE_DEVTOOLS_REPORTER_BROWSER_PATH.
autoDetectBrowser boolean true Si se debe buscar un navegador basado en Chromium ya instalado en esta máquina cuando no se proporciona una ruta del navegador y no se instala jsdom. Establécelo en false para omitir la pre-renderización en lugar de ejecutar un navegador que el reportero descubrió por sí mismo. Variable de entorno: AXE_DEVTOOLS_REPORTER_BROWSER_AUTO_DETECT.
noSandbox boolean false Desactiva el sandbox del navegador. Deja el sandbox habilitado a menos que estés en un entorno de confianza y restringido que no pueda soportarlo. Variable de entorno: AXE_DEVTOOLS_REPORTER_BROWSER_NO_SANDBOX.
maxBufferBytes number 67108864 (64 MB) Cantidad máxima de salida renderizada para almacenar en el búfer desde el navegador. Aumenta esto si un informe grande falla al renderizarse con un error de desbordamiento del búfer.
virtualTimeBudgetMs number 5000 Cuánto tiempo se le da al navegador para renderizar el informe antes de que se capture su contenido. Aumenta esto si un informe grande se escribe sin su contenido.
renderTimeoutMs number 30000 Límite de tiempo para el renderizado del navegador. Un navegador que nunca termina es detenido y el renderizado falla.
distDirectory string la copia incluida con el paquete Directorio que contiene los activos del cliente del informe. Establece esto solo cuando los archivos del paquete no están donde su propia resolución de módulos los espera, como cuando tu aplicación se empaqueta en un solo ejecutable.
note

El navegador solo se utiliza cuando la ruta se resuelve a un archivo que existe. Si configuras browserPath (o AXE_DEVTOOLS_REPORTER_BROWSER_PATH) en una ruta que no existe, el reportero pasa al siguiente método de renderizado en lugar de informar un error, así que verifica la ruta si necesitas que aparezca una mala configuración.

La detección automática inicia un proceso de navegador para cada informe. En una ejecución de lote grande, o en una máquina de construcción donde iniciar un navegador que el reportero descubrió por sí mismo no es deseado, configura autoDetectBrowser a false y proporciona browserPath o instala jsdom.

buildJUnitXML

Crea un archivo XML de JUnit en el directorio especificado a partir de los resultados de accesibilidad JSON.

buildJUnitXML(directory: string, userAgent?: string): Promise<void>;

Parámetros

Nombre Tipo Descripción
directory string El directorio para crear el archivo de salida .xml. Todos los directorios se crearán de forma recursiva si no existen.
userAgent string (opcional) Solo los resultados con el agente de usuario especificado aparecerán en el archivo de informe .xml

Devoluciones

Promise<void>