Importation et Initialisation pour WebDriverJS

Une fois que vous avez installé Axe DevTools pour Web, vous devez l'importer dans votre configuration de test et initialiser le package.

Prérequis

Pour importer et initialiser Axe DevTools pour Web, il doit d'abord être installé. Si cela n'est pas encore fait, lisez le guide sur comment l'installer à partir d'un bundle, depuis votre dépôt d'artéfacts, ou depuis l'Agora de Deque. Vous aurez également besoin d'un WebDriver Selenium téléchargé et configuré de votre choix.

Importation et Initialisation

Importez à la fois Axe DevTools for Web et WebDriverJS. La syntaxe dépend du langage et du système de modules utilisés par votre projet. Choisissez celle qui correspond à votre projet :

JavaScript avec modules CommonJS

C'est la configuration par défaut pour un projet Node.js sans "type": "module" dans son package.json.

const { AxeDevToolsBuilder } = require('@axe-devtools/webdriverjs');
const webdriver = require('selenium-webdriver');

JavaScript avec modules ES

Utilisez cette syntaxe dans un projet avec "type": "module" dans son package.json, ou dans des fichiers .mjs.

import { AxeDevToolsBuilder } from '@axe-devtools/webdriverjs';
import webdriver from 'selenium-webdriver';

TypeScript

TypeScript utilise la même syntaxe import que les modules ES. @axe-devtools/webdriverjs inclut ses propres déclarations de type, donc il n'y a pas de paquet @types/ séparé à installer. Les résultats de l'analyse sont typés comme AxeResults, que axe-core exporte :

import { AxeDevToolsBuilder } from '@axe-devtools/webdriverjs';
import { Builder } from 'selenium-webdriver';
import type { WebDriver } from 'selenium-webdriver';
import type { AxeResults } from 'axe-core';

Initialisation du pilote

Une fois que vous avez importé Axe DevTools pour Web, vous pouvez initialiser le pilote. Chaque analyse nécessite sa propre instance d'Axe DevTools pour Web, donc vous l'initialiserez au fur et à mesure que vous écrivez des tests.

En JavaScript :

const driver = new webdriver.Builder().forBrowser('chrome').build();

En TypeScript, en utilisant les types Builder et WebDriver importés ci-dessus :

const driver: WebDriver = new Builder().forBrowser('chrome').build();

Prochaines Étapes

Une fois que vous avez installé, importé et initialisé Axe DevTools pour Web, vous êtes prêt à passer à l'analyse de l'accessibilité et à l'écriture de tests d'accessibilité. Pour cela, consultez le guide sur écrire des tests.

Dépannage

Si vous avez des problèmes avec l'importation ou l'initialisation d'Axe DevTools pour Web, contactez directement votre représentant Deque, joignez-nous via notre service d'assistance, ou envoyez-nous un email. Nous serons heureux de vous aider.