Importieren und Initialisieren von Puppeteer für JavaScript

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

Voraussetzungen

Um Axe DevTools für Web zu importieren und zu initialisieren, muss es zuerst installiert werden. Falls Sie dies noch nicht getan haben, lesen Sie den Leitfaden darüber, wie es aus einem Bundle, aus Ihrem Artefakt-Repository oder aus Deques Agora installiert wird. Außerdem müssen Sie Puppeteer installiert haben.

Importieren und Initialisieren

Importieren Sie sowohl Axe DevTools für Web als auch Puppeteer. Die Syntax hängt von der Sprache und dem Modul-System ab, das Ihr Projekt verwendet. Wählen Sie diejenige aus, 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 { AxeDevToolsPuppeteer } = require('@axe-devtools/puppeteer');
const puppeteer = require('puppeteer');

JavaScript mit ES-Modulen

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

import { AxeDevToolsPuppeteer } from '@axe-devtools/puppeteer';
import puppeteer from 'puppeteer';

TypeScript

TypeScript verwendet die gleiche import-Syntax wie ES-Module. @axe-devtools/puppeteer liefert seine eigenen Typdeklarationen mit, daher gibt es kein separates @types/-Paket zur Installation. Scan-Ergebnisse sind als AxeResults getypt, die von axe-core exportiert werden:

import { AxeDevToolsPuppeteer } from '@axe-devtools/puppeteer';
import puppeteer from 'puppeteer';
import type { AxeResults } from 'axe-core';

Für jeden Scan wird ein neues AxeDevToolsPuppeteer-Objekt erstellt. Um zu sehen, wie das geht, sehen Sie sich den Leitfaden zu Tests schreiben an.

Nächste Schritte

Sobald Sie Axe DevTools für Web installiert, importiert und initialisiert haben, sind Sie bereit, mit dem Scannen auf Barrierefreiheit und dem Schreiben von Barrierefreiheitstests fortzufahren. Dafür lesen Sie den Leitfaden über Tests schreiben.

Fehlerbehebung

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