Importieren und Initialisieren für WebDriverJS

Nachdem Sie Axe DevTools for Web installiert haben, müssen Sie es in Ihr Test-Setup importieren und das Paket initialisieren.

Voraussetzungen

Um Axe DevTools for Web zu importieren und zu initialisieren, muss es zuerst installiert werden. Wenn Sie dies noch nicht getan haben, lesen Sie die Anleitung zum Installieren von aus einem Bundle, aus Ihrem Artefakt-Repository oder von Deques Agora. Sie benötigen auch einen heruntergeladenen und konfigurierten Selenium WebDriver Ihrer Wahl.

Importieren und Initialisieren

Importieren Sie sowohl Axe DevTools für Web als auch WebDriverJS. Die Syntax hängt von der Sprache und dem Modulsystem ab, das Ihr Projekt verwendet. Wählen Sie diejenige, die zu Ihrem Projekt passt:

JavaScript mit CommonJS-Modulen

Dies ist der Standard für ein Node.js-Projekt ohne "type": "module" in seiner package.json.

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

JavaScript mit ES-Modulen

Verwenden Sie diese Syntax in einem Projekt mit "type": "module" in seiner package.json oder in .mjs Dateien.

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

TypeScript

TypeScript verwendet die gleiche import-Syntax wie ES-Module. @axe-devtools/webdriverjs liefert seine eigenen Typdeklarationen, sodass es kein separates @types/-Paket zu installieren gibt. Scan-Ergebnisse sind als AxeResults typisiert, die axe-core exportiert:

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

Initialisierung des Treibers

Sobald Sie Axe DevTools for Web importiert haben, können Sie den Treiber initialisieren. Jeder Scan erfordert eine eigene Instanz von Axe DevTools for Web, sodass Sie diese beim Schreiben von Tests initialisieren.

In JavaScript:

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

In TypeScript, unter Verwendung der oben importierten Builder und WebDriver Typen:

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

Nächste Schritte

Sobald Sie Axe DevTools for Web installiert, importiert und initialisiert haben, können Sie mit dem Scannen auf Barrierefreiheit und dem Schreiben von Barrierefreiheitstests fortfahren. Um dies zu tun, lesen Sie den Leitfaden zu Test schreiben.

Fehlerbehebung

Wenn Sie Probleme beim Importieren oder Initialisieren von Axe DevTools for Web haben, kontaktieren Sie direkt Ihren Deque-Vertreter, erreichen Sie uns über unseren Supportdesk oder senden Sie uns eine E-Mail. Wir helfen Ihnen gerne weiter.