Axe DevTools pour le Web pour Node.js et tests basés sur le navigateur
Aperçu des intégrations Node.js et JavaScript disponibles avec Axe DevTools pour le Web
Cette page vous présente des options pour le développement Node.js et JavaScript avec Axe DevTools pour le Web. Chaque entrée ci-dessous nomme le package npm qu'elle documente, afin que vous puissiez associer un package que vous avez vu référencé à son guide.
Chaque package listé ci-dessous inclut ses propres déclarations de types TypeScript, donc il n'y a pas de package @types/ séparé à installer et l'API Axe DevTools est la même dans les deux langues. Les guides d'importation et d'écriture de tests pour chaque intégration étiquettent leurs exemples par langue et fournissent un fichier d'exemple complet en JavaScript et TypeScript.
Tous ces packages s'installent depuis le même registre. Consultez Installez Axe DevTools pour le Web pour Node.js depuis l'Agora de Deque pour les instructions d'authentification et d'installation.
Quel que soit le forfait que vous choisissez, les analyses sont effectuées par défaut selon le WCAG 2.1 Niveau AA, avec les règles de bonnes pratiques et expérimentales désactivées. Consultez Personnalisation des règles pour modifier l'ensemble de règles ou activer les bonnes pratiques.
Intégrations avec les frameworks de test
Choisissez le package qui correspond à l'outil que vos tests utilisent déjà. Chaque guide couvre l'installation, l'importation et l'initialisation, l'écriture de tests, et la référence complète de l'API.
- JavaScript pour navigateurs (
@axe-devtools/browser) - Cypress (
@axe-devtools/cypress) - Playwright JavaScript (
@axe-devtools/playwright) - Puppeteer (
@axe-devtools/puppeteer) - WebdriverIO (
@axe-devtools/webdriverio) - WebDriverJS (
@axe-devtools/webdriverjs)
Rapports et journalisation
Ces packages fonctionnent avec n'importe laquelle des intégrations de framework de test mentionnées ci-dessus.
- Node Reporter (
@axe-devtools/reporter) : génère des rapports à partir de vos résultats d'accessibilité. - Node Logger (
@axe-devtools/logger) : enregistre les résultats d'accessibilité pendant l'exécution de vos tests.
Autres intégrations
Éléments personnalisés et ElementInternals
À partir de Axe DevTools for Web 4.13.0, les analyses lisent les sémantiques ARIA que les composants web déclarent en JavaScript via ElementInternals, plutôt qu'uniquement les attributs role et aria-* présents dans le balisage. Aucune configuration n'est requise, et cela s'applique à chaque intégration sur cette page. Les sémantiques dans le DOM prennent toujours le pas : un attribut role ou aria-* explicite sur l'élément annule la valeur de ElementInternals.
Vos composants doivent publier leurs internes pour que cela ait un effet, et un composant qui les stocke dans un champ de classe privée ne peut pas être lu. Voir Tester les éléments personnalisés qui utilisent ElementInternals.