# axe

## Was es ist

axe, als quelloffene JavaScript-Bibliothek axe-core veröffentlicht, ist eine Sammlung automatisierter Barrierefreiheitsregeln. Sie läuft innerhalb einer Webseite, untersucht die Browserdarstellung und meldet jedes Element, das eine Regel verletzt. Deque Systems, ein auf Barrierefreiheit spezialisiertes Unternehmen, pflegt sie unter der Mozilla Public License 2.0. Andere Werkzeuge bauen darauf auf: Die Barrierefreiheitskategorie von Chrome Lighthouse gewichtet Prüfungen anhand der axe-Auswirkungsstufen. Auch Playwrights eigener Testleitfaden führt axe über ein kleines Begleitpaket aus.

Die Engine ist ein einzelnes Skript. Ein Testrunner oder eine Browsererweiterung lädt es in die Testseite und ruft `axe.run` auf. Die Engine durchläuft das Dokument samt verschachtelter Frames und Shadow DOM und wendet jede passende Regel an. Weil sie nach der Layoutberechnung liest, kann sie Dinge prüfen, die der Quelltext nicht zeigt: sichtbarer Text, seine Hintergrundfarbe und verborgene Elemente. Deshalb brauchen einige Regeln einen echten Browser. Das Projekt weist darauf hin, dass die Farbkontrastregel in JSDOM, dem in vielen Unittests verwendeten Dokumentmodell, nicht funktioniert.

Jede Regel trägt Tags. Eines ordnet WCAG-Version und Stufe zu, etwa `wcag2a`, `wcag2aa`, `wcag21aa` oder `wcag22aa`. `best-practice` kennzeichnet Regeln ohne verpflichtendes Erfolgskriterium. Andere Tags beziehen sich auf EN 301 549, Section 508 oder die W3C-Konformitätsprüfregeln. Über diese Tags entscheidet ein Team, was ein Lauf prüft.

Das Ergebnis ist nicht einfach bestanden oder durchgefallen, sondern besteht aus vier Listen:

- `violations`: fehlgeschlagene Elemente mit den Auswirkungsstufen minor, moderate, serious oder critical, einer kurzen Reparaturanleitung und einem Link zur längeren Erklärung.
- `passes`: bestandene Elemente, an denen sich erkennen lässt, dass die Regel wirklich lief.
- `incomplete`, in der Dokumentation auch „needs review“: Elemente ohne sichere Entscheidung, die ein Mensch ansehen muss.
- `inapplicable`: Regeln ohne Prüfgegenstand, etwa Videoregeln auf einer Seite ohne Video.

## Warum es wichtig ist

axe unterstützt die Entscheidung, welche Teile der Barrierefreiheitsprüfung eine Maschine übernimmt und ob ein Fehler die Veröffentlichung stoppen soll. Dafür eignen sich zwei Eigenschaften. Die Ausführung ist günstig und kann jeden Build statt nur ein jährliches Audit prüfen. Außerdem lautet das erklärte Ziel der Hersteller: null Fehlalarme, abgesehen von Programmfehlern. Unsichere Ergebnisse landen in der Prüfliste statt unter Verstößen. Eine ständig falsche Alarmierung wird ausgeschaltet. Eine Prüfung, die nur nachweisbare Fehler meldet, darf einen Build stoppen, ohne Widerstand zu erzeugen.

Die Grenze liegt in der Abdeckung. Deque sagt, axe-core finde durchschnittlich 57 Prozent der WCAG-Probleme automatisch und gebe unklare Ergebnisse zur manuellen Prüfung aus. Die Zahl beschreibt gefundene Probleme, nicht den Anteil der Erfolgskriterien, den eine Maschine beurteilen kann.

Außer Reichweite liegt vor allem das Urteil. axe kann feststellen, ob ein Bild Alternativtext, eine Schaltfläche einen Namen und ein Formularfeld eine Beschriftung besitzt. Es erkennt nicht, ob der Text das Bild erklärt, der Name die Handlung beschreibt oder die Seite beim Vorlesen in Reihenfolge Sinn ergibt. Dafür braucht es einen Menschen mit Screenreader und Tastatur. Die Zeitersparnis bei mechanischen Prüfungen schafft dafür Raum.

Auch die Tagwahl hat einen Preis. Nur WCAG-Tags liefern ein sauber einer Konformitätsaussage zuordenbares Ergebnis und sonst nichts. Best-Practice-Regeln finden zusätzliche Nutzungsprobleme, etwa Inhalte außerhalb jedes Landmarks oder eine fehlende oberste Überschrift. Dafür entstehen einige Befunde, die kein Konformitätsaudit zitieren würde.

## Wie es in der Praxis aussieht

Zwei Seiten zeigen, was der Engine anvertraut wird.

In der Testsuite einer Plattform steht sie neben vier Testschichten. [Ein axe-core-Gate verlangt null Verstöße gegen WCAG 2.0 und 2.1 A und AA](/de/portfolio/built-a-test-suite-across-go-sql-and-browser/). Barrierefreiheit wird damit zum Buildfehler statt zum Auditbefund Monate später. Entscheidend ist der Zeitpunkt: Solange die Änderung noch offen ist, repariert die Person den Fehler, die ihn gerade geschrieben hat.

Die [Credits dieser Website](/de/credits/) beschreiben repräsentative Seiten, je eine pro Vorlage in jeder Sprache, geprüft gegen WCAG 2.2 A und AA in beiden Farbschemata. Das geschieht im verbindlichen Gate, nicht in einem Bericht daneben. Beide Schemata erlauben, auch einen nur im dunklen Modus auftretenden Kontrastfehler als Buildfehler zu behandeln. Die Stichprobe setzt gemeinsame Strukturen derselben Vorlage voraus. So konnten im Oktober 2026 insgesamt 38 Seiten für eine Website mit 2.268 Seiten stehen. Automatisierte Regeln decken nicht jede von WCAG verlangte Beurteilung ab. Deshalb führt die Website Aufzeichnungen pro Erfolgskriterium statt eines einzigen Häkchens.

## Wo es schiefgeht

Meist scheitert Vertrauen: Ein Lauf prüft weniger als gedacht oder ein Ergebnis wird weiter ausgelegt, als es reicht.

**Eine Tagliste lässt Regeln aus.** Tags sind nicht kumulativ. `wcag2aa` umfasst nur Regeln für AA-Kriterien aus WCAG 2.0. Ein darauf beschränkter Lauf überspringt daher sämtliche Regeln der Stufe A. Die API-Dokumentation verlangt ausdrücklich sowohl `wcag2a` als auch `wcag2aa`. Ebenso umfasst `wcag21aa` nur in 2.1 ergänzte Kriterien. Ein auf WCAG-Tags begrenzter Lauf führt nie eine `best-practice`-Regel aus. Die Regelbeschreibungen nennen WCAG-2.2-Regeln als standardmäßig deaktiviert. Auch ein Lauf ohne Tags lässt sie aus; ihre ausdrückliche Nennung aktiviert sie. Benennen Sie alle benötigten Tags und halten Sie die Liste neben der von ihr getragenen Aussage:

```js
const results = await axe.run(document, {
    runOnly: {
        type: "tag",
        values: ["wcag2a", "wcag2aa", "wcag21a", "wcag21aa", "wcag22aa"],
    },
});
```

Eine Regel in keiner der vier Listen ist überhaupt nicht gelaufen. Lesen Sie die Listen deshalb bei jeder Konfigurationsänderung einmal durch.

**Ein sauberer Lauf gilt als barrierefreie Seite.** Null Verstöße heißt, dass die ausgeführten Regeln keinen Fehler nachweisen konnten. Über richtigen Alternativtext, sinnvolle Fokusreihenfolge oder den Abschluss einer Aufgabe per Screenreader sagt das nichts. Behandeln Sie den Lauf als Grundlage und planen Sie die Prüfungen, die er nicht kann.

**Die Prüfliste wird verworfen.** Ein Gate, das nur Verstöße ablehnt, lässt `incomplete` ohne Sichtung durch. Gerade diese untersuchten, unentschiedenen Elemente brauchen am dringendsten einen Menschen. Leiten Sie sie an jemanden weiter, der sie liest, oder lassen Sie auch daran den Build scheitern.

**Es wird nur ein Zustand geprüft.** Die Engine prüft die Darstellung zum Zeitpunkt ihres Laufs. Ein geschlossenes Menü, ein ungeöffneter Dialog, eine erst nach fehlerhafter Eingabe sichtbare Meldung und das andere Farbschema liegen außerhalb des ersten Seitenzustands. Führen Sie die Seite in jeden wichtigen Zustand und prüfen Sie jeden erneut.

**Die Engine läuft dort, wo nichts gezeichnet wird.** Ein simuliertes Dokument besitzt weder Layout noch berechnete Farben. Die Farbkontrastregel funktioniert laut Projekt dort nicht. Unittests mit axe finden weiterhin Strukturfehler; Kontrast und alles andere Visuelle gehören in einen echten Browser.

**Eine Regel wird für die Veröffentlichung abgeschaltet.** Die globale Abschaltung wegen einer einzigen Komponente versteckt dieselben Fehler anderswo, auch auf später geschriebenen Seiten. Nehmen Sie stattdessen nur dieses Element aus und notieren Sie Grund und Aufhebungszeitpunkt.

## Weiterführende Lektüre

- [axe-core](https://github.com/dequelabs/axe-core) — Quellcode, erklärte Prinzipien und unterstützte Browser.
- [Regelbeschreibungen](https://github.com/dequelabs/axe-core/blob/develop/doc/rule-descriptions.md) — Auswirkungen und Tags aller Regeln, gruppiert nach WCAG-Version, Best Practice, AAA, experimentell und abgekündigt.
- [axe-core API](https://github.com/dequelabs/axe-core/blob/develop/doc/API.md) — Tags, `runOnly`, Ein- und Ausschluss von Seitenteilen sowie die vier Ergebnislisten.
- [Barrierefreiheit testen](https://playwright.dev/docs/accessibility-testing) — Playwrights Anleitung für axe in Browsertests, einschließlich Prüfungen nach Interaktionen.

<https://engineer.company/de/glossary/axe/>
