Anweisungen für WebDriverJS und JavaScript
Konfigurieren Ihrer Tests mit WebDriverJS und JavaScript
Axe Watcher erfordert einen unterstützten Browser, der bereits auf Ihrem System installiert ist: Chrome für Tests (eine separate Browserinstallation, die sich von Google Chrome unterscheidet), Chromium oder Microsoft Edge. Google Chrome, Version 139 oder höher, wird nicht unterstützt. Siehe Einrichtung und Konfiguration von Browsern für die Verwendung mit Axe Watcher für Installations- und Konfigurationsanweisungen.
-
Im Stammverzeichnis Ihres Testordners installieren Sie das Paket
@axe-core/watcherund alle seine Abhängigkeiten mitnpmoder Ihrem bevorzugten Paketmanager (zum Beispielyarnoderpnpm).npm install --save-dev @axe-core/watcher -
Importieren Sie in Ihrer Testdatei oder Ihren Testdateien die
webdriverConfig()-Funktion, diewrapWebdriver()-Funktion und dieWebdriverController-Klasse von@axe-core/watcher/webdriver:const { webdriverConfig, wrapWebdriver, WebdriverController } = require('@axe-core/watcher/webdriver') -
Aktualisieren Sie Ihren Testeinrichtungscode (typischerweise in einem
before- oderbeforeAll-Block) und geben Sie Chrome-Optionen an, wenn Sie Ihrebrowser-Instanz instanziieren und Ihren API-Schlüssel angeben:// Original code: let browser = await new Builder() .forBrowser('chrome') .build() // Becomes: const ACCESSIBILITY_API_KEY = process.env.ACCESSIBILITY_API_KEY const PROJECT_ID = process.env.PROJECT_ID const SERVER_URL = process.env.SERVER_URL let browser = await new Builder() .forBrowser('chrome') .setChromeOptions( webdriverConfig({ axe: { apiKey: ACCESSIBILITY_API_KEY, projectId: PROJECT_ID, serverURL: SERVER_URL } } ) .build()Stellen Sie sicher, dass Sie
ACCESSIBILITY_API_KEYundPROJECT_IDin Ihrer Umgebung auf Ihren persönlichen API-Schlüssel (zu finden in Ihrem Axe-Konto, im **API-SCHLÜSSEL**-Tab) und Ihre Projekt-ID (angezeigt am oberen Rand dieser Anweisungen, als Sie Ihr Projekt erstellt haben, oder verfügbar auf der Seite „Projekte“ durch Auswahl von **Projekt konfigurieren** unter **Einstellungen**) setzen. Wenn Ihre Organisation eine regionale, private Cloud oder eine lokale Axe Developer Hub-Instanz verwendet, setzen Sie auchSERVER_URLauf die Basis-URL dieser Instanz (zum Beispielhttps://axe-eu.deque.com); andernfalls lassen SieSERVER_URLweg und der Standardhttps://axe.deque.comwird verwendet. -
Erstellen Sie eine Instanz der
WebdriverController:const controller = new WebdriverController(browser)noteWenn Sie Screenshot-Erfassung (
takeScreenshots: true) aktivieren, beachten Sie, dassWebdriverControllerdie Screenshot-Erfassung in@axe-core/watcher4.6.0 nicht implementiert. Um Screenshots aufzunehmen, unterklassen SieWebdriverController, überschreiben SiecaptureScreenshot(), um die eigenetakeScreenshot()-Methode von Selenium aufzurufen, und instanziieren Sie Ihre Unterklasse:class ScreenshotWebdriverController extends WebdriverController { async captureScreenshot() { return await this.driver.takeScreenshot() } } const controller = new ScreenshotWebdriverController(browser) -
Umschließen Sie Ihre
browser-Instanz mit derwrapWebdriver()-Funktion:browser = wrapWebdriver(browser, controller) -
Stellen Sie schließlich sicher, dass alle Testergebnisse von Axe Watcher ausgegeben werden. Fügen Sie dazu den folgenden Codeblock zu Ihrem Testabbau-Code hinzu (typischerweise in einem
afterEach-Block):afterEach(async () => { await controller.flush() })
