note

Axe Watcher erfordert einen unterstützten Browser: Chrome für Testing (eine separate Browser-Installation, die sich von Google Chrome unterscheidet), Chromium oder Microsoft Edge. Playwright und Puppeteer verwalten ihre eigenen Browser-Downloads und installieren stets eine Version, die von Axe Watcher unterstützt wird, sodass Sie nichts selbst installieren müssen. Details finden Sie unter Einrichten und Konfigurieren von Browsern für die Verwendung mit Axe Watcher.

  1. Im Stammverzeichnis Ihres Testordners installieren Sie das Paket @axe-core/watcher und alle seine Abhängigkeiten mit npm oder Ihrem bevorzugten Paketmanager (zum Beispiel yarn oder pnpm).

    npm install --save-dev @axe-core/watcher
  2. Erstellen Sie eine fixtures.ts-Datei neben Ihren vorhandenen Playwright-Testtests. Importieren Sie in dieser Datei die playwrightTest()-Funktion von @axe-core/watcher:

    import { playwrightTest } from '@axe-core/watcher/playwright-test'
    
    const ACCESSIBILITY_API_KEY = process.env.ACCESSIBILITY_API_KEY
    const PROJECT_ID = process.env.PROJECT_ID
    const SERVER_URL = process.env.SERVER_URL
    
    const { test, expect } = playwrightTest({
      axe: {
        apiKey: ACCESSIBILITY_API_KEY,
        projectId: PROJECT_ID,
        serverURL: SERVER_URL
      },
      headless: false
      // Any other Playwright configuration you’d pass to chromium.launchPersistentContext() here
    })
    
    export { test, expect }

    Stellen Sie sicher, dass Sie ACCESSIBILITY_API_KEY und PROJECT_ID in 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 auch SERVER_URL auf die Basis-URL dieser Instanz (zum Beispiel https://axe-eu.deque.com); andernfalls lassen Sie SERVER_URL weg und der Standard https://axe.deque.com wird verwendet.

  3. Ersetzen Sie in Ihren Testdateien die Importe für test und expect aus Playwright Test durch Ihre fixtures.ts-Datei:

    import { test, expect } from '@playwright/test'
    
    // Becomes:
    import { test, expect } from './fixtures';
  4. Sie sind fertig.