Anleitungen für Puppeteer und JavaScript

Installieren Sie auf der Stammebene Ihres Testordners das Paket @axe-core/watcher und alle seine Abhängigkeiten mit npm oder Ihrem bevorzugten Paketmanager (z. B. Yarn oder pnpm).

npm install --save-dev @axe-core/watcher

Importieren Sie in Ihre Testdatei(en) die Funktion puppeteerConfig(), die Funktion wrapPuppeteer() und die Klasse PuppeteerController aus @axe-core/watcher:

const {
  puppeteerConfig,
  wrapPuppeteerPage,
  PuppeteerController
} = require('@axe-core/watcher')

Aktualisieren Sie Ihren Test-Setup-Code (normalerweise in einem before - oder beforeAll -Block), umschließen Sie vorhandenen Code zum Erstellen einer Browser Instanz mit einem Aufruf von puppeteerConfig() und geben Sie dabei Ihren API-Schlüssel an:

const browser = await puppeteer.launch({
  // Your existing launch options...
})

// Becomes:

const browser = await puppeteer.launch(
  puppeteerConfig({
    axe: {
      apiKey: process.env.API_KEY
    },
    // Your existing launch options...
  })
)

Erstellen Sie eine Instanz von PuppeteerController und verknüpfen Sie Ihren Puppeteer- browserContext:

// Create a page instance, using your browser instance.
let page = await browser.newPage()

// Initialize the PuppeteerController by passing in the Puppeteer page.
const controller = new PuppeteerController(page)

// Use the new wrapped Puppeteer page instance.
page = wrapPuppeteerPage(page, controller)

Stellen Sie abschließend sicher, dass alle Testergebnisse aus Axe Watcher vollständig verarbeitet sind. Fügen Sie dazu den folgenden Codeblock zu Ihrem Test-Teardown-Code hinzu (normalerweise in einem afterEach -Block):

afterEach(async () => {
  await controller.flush()
})