Referencia de la API de Axe DevTools Node Reporter
Referencia de API para el paquete @axe-devtools/reporter
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.
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. |
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>