Axe DevTools Node Reporter API-referentie

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

API-referentie voor het @axe-devtools/reporter-pakket

Not for use with personal data

Dit document beschrijft de methoden die worden geleverd door de AxeDevToolsReporter-klasse.

De AxeDevToolsReporter klasse breidt de AxeDevToolsLogger klasse uit (uit het @axe-devtools/logger pakket), zodat je een instantie van AxeDevToolsReporter kunt maken en methoden aangeboden door de AxeDevToolsLogger klasse kunt aanroepen. Zie de Axe DevTools Logger Referentie voor meer informatie over de methoden die door de AxeDevToolsLogger klasse worden geboden.

Methodehandtekeningen op deze pagina zijn geschreven in TypeScript-notatie, overeenkomstig met de typedefinities die bij het pakket zijn meegeleverd. De gebruiksvoorbeelden zijn in JavaScript, en ze worden ongewijzigd gecompileerd in TypeScript. Voor JavaScript- en TypeScript-versies van een compleet bestand naast elkaar, zie Rapporten genereren.

Constructor

constructor(reportName: string, directory?: string)

Voorbeeld van gebruik:

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

Parameters

Naam Type Beschrijving
reportName string De titel van het rapport. De waarde reportName wordt het eerste segment van de bestandsnaam van het JSON-resultatenbestand.
directory string (optioneel) Directory waar het rapport zal worden geschreven. Directories worden recursief aangemaakt als ze nog niet bestaan.

Methoden

Elk van deze methoden creëert het gespecificeerde rapport uit de JSON-resultatenbestanden die worden geproduceerd door de logTestResult-methode.

Naam Beschrijving
buildCSV Maak een CSV-rapport
buildEARL Maak een W3C EARL JSON-LD-rapport
buildHTML Maak een HTML-rapport
buildJUnitXML Maak een XML-rapport

buildCSV

Creëert een CSV-bestand van het JSON-resultatenbestand dat is aangemaakt door de logTestResult-methode.

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

Parameters

Naam Type Beschrijving
directory string De directory om het .csv-uitvoerbestand aan te maken. Alle directories worden recursief aangemaakt als ze nog niet bestaan.
userAgent string (optioneel) Alleen resultaten met de gespecificeerde user agent zullen verschijnen in het .csv bestand
filterOpts string[] (optioneel) Een reeks filteropties voor het selecteren van resultaten.

Retourneert

Promise<void>

buildEARL

Creëert een W3C EARL (Evaluation and Report Language) JSON-LD bestand met de naam axe-devtools-results.earl.json in de opgegeven map.

note

EARL-uitvoer ondersteunt geen resultaten van Axe DevTools Mobile. Als er mobiele resultaten aanwezig zijn, geeft buildEARL een foutmelding voordat er een bestand wordt geschreven.

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

Parameters

Naam Type Beschrijving
directory string De directory om het .earl.json-uitvoerbestand aan te maken. Alle directories worden recursief aangemaakt als ze nog niet bestaan.
userAgent string (optioneel) Alleen resultaten met de gespecificeerde user agent verschijnen in het EARL-rapport.

Retourneert

Promise<void>

buildHTML

Maakt een HTML-bestand in de gespecificeerde directory van het toegankelijkheidsresultaten-JSON-bestand.

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

Parameters

Naam Type Beschrijving
directory string De directory om het .html-uitvoerbestand aan te maken. Alle directories worden recursief aangemaakt als ze nog niet bestaan.
userAgent string (optioneel) Alleen resultaten met de gespecificeerde user agent zullen verschijnen in het .html rapportbestand
renderOptions RenderOptions (optioneel) Bepaalt hoe het rapport wordt pre-rendered naar statische markup. Zie Pre-rendering HTML-rapporten.

Retourneert

Promise<void>

RenderOpties

Overgedragen aan buildHTML om te bepalen hoe het rapport wordt voorgerenderd naar statische markup. Elke optie is optioneel en heeft een omgevingsvariabele die van toepassing is wanneer de optie niet is ingesteld. De renderer wordt eenmaal per oproep geselecteerd, dus deze opties gelden voor elk rapport dat die oproep opbouwt.

Naam Type Standaard Beschrijving
browserPath string geen Pad naar een browser uitvoerbaar bestand dat wordt gebruikt om het rapport te pre-renderen. Omgevingsvariabele: AXE_DEVTOOLS_REPORTER_BROWSER_PATH.
autoDetectBrowser boolean true Of er moet worden gezocht naar een al op deze machine geïnstalleerde Chromium-gebaseerde browser als er geen browserpad is opgegeven en jsdom niet is geïnstalleerd. Stel het in op false om pre-rendering over te slaan in plaats van een browser te draaien die de rapporteur zelf heeft ontdekt. Omgevingsvariabele: AXE_DEVTOOLS_REPORTER_BROWSER_AUTO_DETECT.
noSandbox boolean false Schakelt de browser sandbox uit. Laat de sandbox ingeschakeld tenzij je je bevindt in een vertrouwde, beperkte omgeving die het niet kan ondersteunen. Omgevingsvariabele: AXE_DEVTOOLS_REPORTER_BROWSER_NO_SANDBOX.
maxBufferBytes number 67108864 (64 MB) Maximale hoeveelheid gerenderde output om vanuit de browser in de buffer te plaatsen. Verhoog dit als een groot rapport niet kan worden gerenderd met een buffer-overloopfout.
virtualTimeBudgetMs number 5000 Hoelang de browser de tijd krijgt om het rapport te renderen voordat de inhoud wordt vastgelegd. Verhoog dit als een groot rapport wordt geschreven zonder inhoud.
renderTimeoutMs number 30000 Tijdslimiet voor het browserrenderen. Een browser die nooit afsluit, wordt gestopt en het renderen mislukt.
distDirectory string de kopie die bij het pakket is inbegrepen Map met de client-assets van het rapport. Stel dit alleen in wanneer de bestanden van het pakket zich niet bevinden waar de eigen module-resolutie dat verwacht, zoals wanneer je toepassing in één uitvoerbaar bestand is gebundeld.
note

De browser wordt alleen gebruikt wanneer het pad naar een bestaand bestand verwijst. Als je browserPath (of AXE_DEVTOOLS_REPORTER_BROWSER_PATH) instelt op een pad dat niet bestaat, gaat de rapporteur verder met de volgende renderingsmethode in plaats van een fout te melden. Controleer dus het pad als je een misconfiguratie wilt vastleggen.

Autodetectie start een browserproces voor elk rapport. Bij een grote batchverwerking, of op een buildmachine waar het ongewenst is om een browser te starten die de rapporteur zelf heeft ontdekt, stel autoDetectBrowser in op false en geef ofwel browserPath op of installeer jsdom.

buildJUnitXML

Maakt een JUnit XML-bestand in de gespecificeerde directory van de JSON-toegankelijkheidsresultaten.

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

Parameters

Naam Type Beschrijving
directory string De directory om het .xml-uitvoerbestand aan te maken. Alle directories worden recursief aangemaakt als ze nog niet bestaan.
userAgent string (optioneel) Alleen resultaten met de gespecificeerde user agent zullen verschijnen in het .xml rapportbestand

Retourneert

Promise<void>