Axe Watcher vereist een ondersteunde browser: Chrome for Testing (een aparte browserinstallatie, verschillend van Google Chrome), Chromium of Microsoft Edge. Playwright en Puppeteer beheren hun eigen browserdownloads en installeren altijd een versie die Axe Watcher ondersteunt, dus er is niets dat je zelf hoeft te installeren. Zie Browsers instellen en configureren voor gebruik met Axe Watcher voor details.
Installeer in de hoofdmap van je testmap het @axe-core/watcher-pakket en al zijn afhankelijkheden met npm of je voorkeurspakketbeheerder (bijvoorbeeld yarn of pnpm).
npm install --save-dev @axe-core/watcherMaak een fixtures.ts bestand naast je bestaande Playwright Test-tests. Importeer in dit bestand de playwrightTest() functie van @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 }Zorg ervoor dat je ACCESSIBILITY_API_KEY en PROJECT_ID in je omgeving instelt op je persoonlijke API-sleutel (te vinden in je Axe-account, tabblad **API-SLEUTELS**) en je project-ID (weergegeven bovenaan deze instructies toen je je project maakte of beschikbaar van de Projecten-pagina door **Project configureren** te kiezen onder **Instellingen**). Als je organisatie een regionale, private cloud of on-premises Axe Developer Hub-instantie gebruikt, stel dan ook SERVER_URL in op de basis-URL van die instantie (bijvoorbeeld, https://axe-eu.deque.com); zo niet, laat dan SERVER_URL weg en zal de standaard https://axe.deque.com gebruikt worden.
Vervang in je testbestanden de imports voor test en expect van Playwright Test met je fixtures.ts bestand:
import { test, expect } from '@playwright/test'
// Becomes:
import { test, expect } from './fixtures';Je bent helemaal klaar.