Axe DevTools Node Reporter API-referentie
API-referentie voor het @axe-devtools/reporter-pakket
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.
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. |
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>