Référence API Axe DevTools Node Reporter
Référence API pour le package @axe-devtools/reporter
Ce document décrit les méthodes fournies par la classe AxeDevToolsReporter.
La classe AxeDevToolsReporter étend la classe AxeDevToolsLogger (du package @axe-devtools/logger), vous pouvez donc créer une instance de AxeDevToolsReporter et appeler les méthodes offertes par la classe AxeDevToolsLogger. Consultez le Référence du journal Axe DevTools pour plus d'informations sur les méthodes fournies par la classe AxeDevToolsLogger.
Les signatures de méthode sur cette page sont écrites en notation TypeScript, correspondant aux déclarations de type incluses avec le package. Les exemples d'utilisation sont en JavaScript, et ils se compilent sans modification en TypeScript. Pour des versions côte à côte de JavaScript et TypeScript d'un fichier complet, voir Génération de rapports.
Constructeur
constructor(reportName: string, directory?: string)Exemple d'utilisation :
const axeReporter = new AxeDevToolsReporter("AxeDevTools-Results", "./test-results/");Paramètres
| Nom | Type | Description |
|---|---|---|
reportName |
string |
Le titre du rapport. La valeur reportName deviendra le premier segment du nom de fichier des résultats JSON. |
directory |
string (optionnel) |
Répertoire où le rapport sera écrit. Les répertoires seront créés de manière récursive s'ils n'existent pas déjà. |
Méthodes
Chacune de ces méthodes crée le rapport spécifié à partir du fichier JSON de résultats produit par la méthode logTestResult.
| Nom | Description |
|---|---|
buildCSV |
Créer un rapport CSV |
buildEARL |
Créer un rapport W3C EARL JSON-LD |
buildHTML |
Créer un rapport HTML |
buildJUnitXML |
Créer un rapport XML |
buildCSV
Crée un fichier CSV à partir du fichier JSON de résultats créé par la méthode logTestResult.
buildCSV(directory: string, userAgent?: string, filterOpts?: string[]): Promise<void>;Paramètres
| Nom | Type | Description |
|---|---|---|
directory |
string |
Le répertoire pour créer le fichier .csv de sortie. Tous les répertoires seront créés de manière récursive s'ils n'existent pas déjà. |
userAgent |
string (optionnel) |
Seuls les résultats avec l'agent utilisateur spécifié apparaîtront dans le fichier .csv |
filterOpts |
string[] (optionnel) |
Un tableau d'options de filtrage pour sélectionner les résultats. |
Retourne
Promise<void>buildEARL
Crée un fichier JSON-LD en W3C EARL (Evaluation and Report Language) nommé axe-devtools-results.earl.json dans le répertoire spécifié.
La sortie EARL ne prend pas en charge les résultats de Axe DevTools Mobile. Si des résultats mobiles sont présents, buildEARL génère une erreur avant d'écrire un fichier.
buildEARL(directory: string, userAgent?: string): Promise<void>;Paramètres
| Nom | Type | Description |
|---|---|---|
directory |
string |
Le répertoire pour créer le fichier .earl.json de sortie. Tous les répertoires seront créés de manière récursive s'ils n'existent pas déjà. |
userAgent |
string (optionnel) |
Seuls les résultats avec l'agent utilisateur spécifié apparaîtront dans le rapport EARL |
Retourne
Promise<void>buildHTML
Crée un fichier HTML dans le répertoire spécifié à partir du fichier JSON des résultats d'accessibilité.
buildHTML(directory: string, userAgent?: string, renderOptions?: RenderOptions): Promise<void>;Paramètres
| Nom | Type | Description |
|---|---|---|
directory |
string |
Le répertoire pour créer le fichier .html de sortie. Tous les répertoires seront créés de manière récursive s'ils n'existent pas déjà. |
userAgent |
string (optionnel) |
Seuls les résultats avec l'agent utilisateur spécifié apparaîtront dans le fichier rapport .html |
renderOptions |
RenderOptions (optionnel) |
Contrôle la façon dont le rapport est pré-rendu en balisage statique. Voir Pré-rendu des rapports HTML. |
Retourne
Promise<void>Options de rendu
Transmis à buildHTML pour contrôler comment le rapport est pré-rendu en balisage statique. Chaque option est optionnelle, et chacune a une variable d'environnement qui s'applique lorsque l'option n'est pas définie. Le moteur de rendu est sélectionné une fois par appel, donc ces options s'appliquent à chaque rapport que cet appel génère.
| Nom | Type | Par défaut | Description |
|---|---|---|---|
browserPath |
string |
aucun | Chemin vers un exécutable de navigateur utilisé pour pré-rendre le rapport. Variable d'environnement : AXE_DEVTOOLS_REPORTER_BROWSER_PATH. |
autoDetectBrowser |
boolean |
true |
Détermine s'il faut rechercher un navigateur basé sur Chromium déjà installé sur cette machine lorsqu'aucun chemin de navigateur n'est donné et que jsdom n'est pas installé. Réglez-le sur false pour ignorer le pré-rendu plutôt que d'exécuter un navigateur que le dispositif de rapport a découvert par lui-même. Variable d'environnement : AXE_DEVTOOLS_REPORTER_BROWSER_AUTO_DETECT. |
noSandbox |
boolean |
false |
Désactive le bac à sable du navigateur. Laissez le bac à sable activé sauf si vous êtes dans un environnement de confiance et contraint qui ne peut pas le prendre en charge. Variable d'environnement : AXE_DEVTOOLS_REPORTER_BROWSER_NO_SANDBOX. |
maxBufferBytes |
number |
67108864 (64 Mo) |
Quantité maximale de sortie rendue à mettre en mémoire tampon depuis le navigateur. Augmentez cette valeur si un grand rapport échoue à rendre avec une erreur de dépassement de mémoire tampon. |
virtualTimeBudgetMs |
number |
5000 |
Temps accordé au navigateur pour rendre le rapport avant que son contenu ne soit capturé. Augmentez cette valeur si un grand rapport est écrit sans son contenu. |
renderTimeoutMs |
number |
30000 |
Délai d'exécution pour le rendu du navigateur. Un navigateur qui ne se termine jamais est arrêté et le rendu échoue. |
distDirectory |
string |
la copie incluse avec le package | Répertoire contenant les actifs client du rapport. Définissez cela uniquement lorsque les fichiers du package ne sont pas où sa propre résolution de module les attend, comme lorsque votre application est regroupée en un seul exécutable. |
Le navigateur est utilisé uniquement lorsque le chemin résout un fichier existant. Si vous définissez browserPath (ou AXE_DEVTOOLS_REPORTER_BROWSER_PATH) sur un chemin qui n'existe pas, le dispositif de rapport passe à la méthode de rendu suivante au lieu de signaler une erreur, donc vérifiez le chemin si vous avez besoin qu'une mauvaise configuration apparaisse.
La détection automatique démarre un processus de navigateur pour chaque rapport. Sur un lot important, ou sur une machine de production où démarrer un navigateur découvert par le dispositif de rapport n'est pas souhaité, réglez autoDetectBrowser sur false et fournissez soit browserPath soit installez jsdom.
buildJUnitXML
Crée un fichier XML JUnit dans le répertoire spécifié à partir des résultats d'accessibilité JSON.
buildJUnitXML(directory: string, userAgent?: string): Promise<void>;Paramètres
| Nom | Type | Description |
|---|---|---|
directory |
string |
Le répertoire pour créer le fichier .xml de sortie. Tous les répertoires seront créés de manière récursive s'ils n'existent pas déjà. |
userAgent |
string (optionnel) |
Seuls les résultats avec l'agent utilisateur spécifié apparaîtront dans le fichier rapport .xml |
Retourne
Promise<void>