Watcher-Paket Versionshinweise

4.5.1 (16. Juli 2026)

• Funktionen

  • Unterstützung für Node.js 20, das das Lebensende erreicht hat, wurde eingestellt. Axe Watcher erfordert jetzt Node.js 22.11.0 oder höher. (JavaScript/TypeScript-Integrationen)
  • Microsoft Edge (Chromium) wird jetzt in der Java Selenium-Integration unterstützt. Zuvor war Edge mit allen Integrationen außer Java Selenium verfügbar. (Java Selenium-Integration)

• Fehlerbehebungen

  • Ein Problem in der Cypress-Integration wurde behoben, bei dem aufgenommene Screenshots nicht in Axe Developer Hub hochgeladen werden konnten. (Cypress-Integration)
  • Ein Problem wurde behoben, bei dem das gleichzeitige Ausführen mehrerer Tests mit unterschiedlichen Projekt-IDs dazu führen konnte, dass die Konfiguration eines Durchlaufs die eines anderen überschreibt. (JavaScript/TypeScript-Integrationen)

4.5.0 (6. Juli 2026)

• Funktionen
  • Axe Watcher unterstützt jetzt offiziell Microsoft Edge (Chromium) als Testbrowser, neben Chrome for Testing, Chrome und Chromium. Edge ist verfügbar mit den JavaScript/TypeScript-Integrationen und mit Java Playwright; es wird nicht mit Java Selenium unterstützt.

4.4.0 (12. Juni 2026)

• Funktionen

  • Scans enthalten jetzt automatisch den Dateipfad und den Namen des ursprünglichen Tests im Axe Developer Hub. (Playwright Test, Cypress und WebdriverIO Integrationen)
  • Das Java-SDK unterstützt jetzt Playwright zusätzlich zu Selenium. Das com.deque.axe_core:watcher-Artefakt wird mit Playwright-Unterstützung geliefert. Siehe die Java mit Playwright-Dokumentation für Integrationsanweisungen.
  • Die Java/Playwright-Integration erfasst Screenshots bei Verstößen. Screenshots werden auf den Server hochgeladen und lokal gespeichert, wenn eine screenshotDir konfiguriert ist.
  • setScreenshotDir() hinzugefügt zu AxeWatcherOptions (Java). Verwenden Sie es, um ein lokales Verzeichnis zum Speichern von Screenshots anzugeben. Screenshots werden lokal gespeichert, auch wenn der Server nicht erreichbar ist.
  • setTestContext() wurde sowohl zu AxeWatcherController (Selenium) als auch zu AxeWatcherPlaywrightController (Playwright) im Java-SDK hinzugefügt. Verwenden Sie es, um Verstöße spezifischen Tests im Axe Developer Hub zuzuordnen.
  • Lokal gespeicherte Screenshots verwenden nun einen mit einem Zeitstempel versehenen Dateinamen (YYYYMMDDTHHmmssSSS-{id}.png), sodass Dateien deterministisch nach Aufnahmezeit sortiert werden.
  • elementInternals-Konfigurationsoption hinzugefügt. Stellen Sie elementInternals: true in AxeConfiguration (JavaScript/TypeScript) ein oder rufen Sie setElementInternals(true) auf AxeWatcherOptions (Java) an, um ElementInternals-Zugänglichkeitsdaten in Scans einzuschließen. Dies reduziert falsch-positive Ergebnisse auf Seiten, die benutzerdefinierte Elemente mit attachInternals() verwenden. Erforderlich ist axe-core Version 4.12.0 oder höher.
  • Axe-core auf Version 4.12.1 aktualisiert.

• Fehlerbehebungen

  • Ein Problem behoben, bei dem der Aufruf von analyze() (oder axeWatcherAnalyze() in Cypress) dazu führen konnte, dass ein doppeltes Scan-Ergebnis am Ende des Tests hochgeladen wurde.
  • Ein Problem behoben, bei dem zwei gleichzeitig eintreffende Flushing-Anfragen dazu führen konnten, dass Scan-Ergebnisse mehrmals hochgeladen wurden.
  • Ein Problem behoben, bei dem Watcher in jedem untergeordneten Frame lief, wodurch doppelte Seitenzustände hochgeladen wurden. Watcher läuft jetzt nur im obersten Frame. Die Barrierefreiheit von iframe-Inhalten bleibt unverändert; axe-core läuft weiterhin in allen Frames und der oberste Frame fügt deren Ergebnisse zusammen.
  • Die Leistung für Tests, die viele Seitenzustände erfassen, wurde verbessert. Die Ergebnis-Speicherung erfolgt jetzt konstant pro Scan, statt mit der Gesamtzahl der kumulierten Ergebnisse zu wachsen.
  • Verbesserte Validierung für setHeadless() und setChannel() in der Java/Playwright-Integration. Falsch konfigurierte Kombinationen werfen jetzt IllegalArgumentException mit einer umsetzbaren Nachricht anstelle von stillem Fehlschlag oder unerwartetem Verhalten.
  • Ein Problem behoben, bei dem ausgeschlossene URL-Muster nicht immer respektiert wurden, wenn eine Flushing-Anfrage eintraf, bevor Watcher das Laden seiner Konfiguration abgeschlossen hatte.

4.3.0 (12. Mai 2026)

• Fehlerbehebungen
  • Ein Wettlaufproblem in der Java-Integration wurde behoben, bei dem der Wechsel des Browserkontextes zu einem iframe fälschlicherweise Scans auslöste, was zu zusätzlichen Ergebnissen führte.
  • axe-core auf Version 4.11.4 aktualisiert.

4.2.0 (6. April 2026)

• Funktionen

  • Die git-Option erweitert, um die Angabe expliziter Git-Metadaten zu unterstützen. In JavaScript/TypeScript akzeptiert die git-Eigenschaft in AxeConfiguration nun ein GitConfig-Objekt zusätzlich zu einem Booleschen Wert. In Java gibt es in AxeWatcherOptions eine neue setGitInfo(AxeWatcherGitInfo)-Methode. Wenn ein GitConfig- oder AxeWatcherGitInfo-Objekt angegeben wird, wird die automatische Git-Erkennung übersprungen. Alle Felder sind optional. Dies ist nützlich, wenn Tests in einem Repository ausgeführt werden, das von dem zu testenden Repository getrennt ist, oder in CI-Umgebungen, in denen die automatische Git-Erkennung unzuverlässig ist. Siehe Bereitstellung von Git-Metadaten für weitere Informationen.

• Fehlerbehebungen

  • Ein Problem behoben, bei dem der Aufruf von flush(), während Ergebnisse noch verarbeitet wurden, zu unvollständigen Ergebnissen führen konnte. (JavaScript/TypeScript-Integration)
  • Ein Problem in der Java/Selenium-Integration behoben, bei dem Ausnahmen von findElement() nicht korrekt angezeigt wurden, wodurch explizite Wartezeiten sofort fehlschlugen, anstatt auf das Erscheinen des Elements zu warten.
  • Die Zuverlässigkeit in der Java-Integration wurde verbessert: Watcher versucht jetzt automatisch, die Ergebnisse bis zu dreimal an den Server zu senden, wenn ein vorübergehender Fehler auftritt.
  • Ein Problem in der Java-Integration behoben, bei dem das Übergeben von null an bestimmte Konfigurations-Setter-Methoden eine unbehandelte Ausnahme verursachte. Diese Methoden werfen jetzt eine IllegalArgumentException mit einer beschreibenden Nachricht.

4.1.0 (24. Februar 2026)

• Funktionen

  • Watcher scannt jetzt automatisch alle iframes mit gleicher Herkunft. (Die Cypress-Integration hatte dieses Verhalten bereits.) Dies gilt für die Playwright-, Puppeteer-, WebdriverIO-, WebDriverJS- und Java Selenium-Integrationen.
  • Unterstützung für den RGAA v4 (französischer Barrierefreiheitsstandard) hinzugefügt. Stellen Sie accessibilityStandard: 'RGAAv4' in ConfigurationOverrides ein (JavaScript/TypeScript) oder verwenden Sie ConfigurationOverrides.AccessibilityStandard.RGAAV4 (Java). Erfordert axe-core Version 4.11.0 oder höher. Die globale Konfiguration bestimmt, ob dieser Standard für Ihre Organisation zulässig ist.
  • Eine git-Option in AxeConfiguration (JavaScript/TypeScript) und AxeWatcherOptions (Java) hinzugefügt, um zu steuern, ob Git-Informationen gesammelt werden. Stellen Sie git: false ein (JavaScript/TypeScript) oder rufen Sie setGit(false) auf (Java), um Watcher ohne das Sammeln von Git-Daten auszuführen. Die Standardeinstellung ist true (Git-Informationen werden gesammelt).
  • axe-core auf Version 4.11.1 aktualisiert.

• Fehlerbehebungen

  • Ein Problem in der Java-Integration behoben, bei dem ein angepasster Chrome-Binärpfad, der über setBinary() auf dem ChromeOptions-Objekt eingestellt wurde, überschrieben wurde, wenn er an configure() übergeben wurde.

4.0.0 (3. Dezember 2025)

Watcher 4.0.0 ist eine Hauptversion des Watcher-Pakets.

• Funktionen

  • Proxy-Unterstützung hinzugefügt. Siehe Verwendung von Watcher mit einem Proxy für weitere Informationen. (HTTP-Proxy-Implementierung erfordert Node.js Version 20.18.1 oder höher).
  • Die Version von axe-core auf 4.11.0 aktualisiert.
  • Unterstützung für Node.js Version 24 hinzugefügt.

• Fehlerbehebungen

  • Ein Problem beim Reporting von Git-Informationen bei der Verwendung einer GitLab-Pipeline behoben.
  • Verbesserte Fehlermanagement für Chrome-Alternativen wie Chrome für Tests und Chromium.
  • Leere Git-Daten korrekt behandelt.
  • Alle vom Benutzer bereitgestellten Chrome-Optionen für WebdriverIO einbeziehen.

• Breaking Changes

  • Watcher (für TypeScript und JavaScript) verwendet jetzt neue Pfade für den Import des Pakets. Siehe die Anweisungen für Ihr Browser-Integrationspaket, um aktualisierte Codebeispiele zu sehen.

    Browser-Automatisierungsplattform	Alter Pfad	Neuer Pfad
    Cypress	@axe-core/watcher	@axe-core/watcher/cypress/config
    Cypress-Befehle	@axe-core/watcher/dist/cypressCommands	@axe-core/watcher/cypress/support
    Playwright	@axe-core/watcher	@axe-core/watcher/playwright
    Playwright-Test	@axe-core/watcher	@axe-core/watcher/playwright-test
    Puppeteer	@axe-core/watcher	@axe-core/watcher/puppeteer
    WebdriverIO	@axe-core/watcher	@axe-core/watcher/wdio
    WebdriverIO Testrunner	@axe-core/watcher	@axe-core/watcher/wdio
    WebDriverJS	@axe-core/watcher	@axe-core/watcher/webdriver

    JavaScript-Beispiel für WebDriverJS:

    const { webdriverConfig, wrapWebdriver, WebdriverController } = require('@axe-core/watcher/webdriver')

  • Die falsche Spezifikation von LaunchOptions in TypeScript für Playwright wurde durch einen neuen Typ namens LaunchPersistentContextOptions ersetzt, der dynamisch aus launchPersistentContext extrahiert wird. Benutzer müssen alle nicht unterstützten Optionen entfernen, die sie mit LaunchOptions verwendet haben; andernfalls wird ihr TypeScript im strengen Modus nicht kompiliert.

3.23.0 (1. August 2025)

• Verbessertes Timeout und Retry-Logik beim Senden von Ergebnissen an den Server (für Watcher für JavaScript und TypeScript).
• Eine Warnung über die --load-extensions-Option mit Chrome Version 139 und höher hinzugefügt (sowohl für die JavaScript/TypeScript-Implementierung als auch für die Java-Implementierung).
• Fehlerbericht, wenn die maximale Anzahl an Wiederholungen für den fehlerhaften Ergebnishochladevorgang überschritten wird (Flush: Failed. Maximum retries reached).
• Probleme mit der Handhabung von Chrome für Tests und Chromium behoben.
• Protokollieren, ob die maximalen Wiederholungsversuche erreicht wurden.
• Komponententest in die Cypress-Integration implementiert.

3.22.0 (1. Juli 2025)

• Stellen Sie sicher, dass runOptions keine null-Werte enthält, was ein stilles Versagen in der Java-Integration verursachte.
• Stellen Sie sicher, dass die Lizenzdatei für die Java-Implementierung in das META-INF-Verzeichnis kopiert wird.
• Ein Problem behoben, bei dem die ausgeschlossenen URL-Muster in Java nicht korrekt kopiert wurden.
• Die Methode zur Bestimmung des Standard-Git-Branches verbessert.

3.21.0 (23. Mai 2025)

• Java Watcher veröffentlicht.
• Ein Fallback-Mechanismus zur Bestimmung des standardmäßigen Git-Branch-Namens implementiert.
• Ein Problem mit der Cypress-Integration behoben, bei dem lange wait()-Zeiten doppelte Seitenzustände oder einen Testfehler verursachten.
• Ein Problem behoben, bei dem runOptions.runOnly nicht ordnungsgemäß mit der Cypress-Integration funktionierte.

3.20.2 (17. April 2025)

• Ein Problem mit den Timeout-Fehlermeldungen behoben, die den falschen Parameter zum Ändern angaben. (Zum Beispiel wurde der Benutzer aufgefordert, timeoutStart statt dem korrekten timeout.start-Wert zu ändern.)

3.20.1 (25. März 2025)

• Funktionen

  • Erlaubt, frühere Versionen von axe-core auszuwählen.
  • Das Zwischenspeichern von Ergebnissen auf dem Server robuster gemacht.

• Fehlerbehebungen

  • Ein Problem beim Konsolidieren globaler Konfigurationen mit Benutzereinstellungen behoben.
  • Ein Race-Condition-Problem in der Cypress-Integration behoben.
  • Ein Problem mit der Cypress-Integration behoben, bei dem experimentelle Regeln nicht aktiviert wurden.
  • Ein Problem behoben, bei dem das Aktivieren des EN 301 549-Standards nicht beachtet wurde.
  • Ein Problem mit configurationOverrides behoben, wenn keine Werte gesetzt wurden.
  • Zusätzliche Validierung für Playwright und Playwright Test hinzugefügt.
  • Ein Problem behoben, das beim Versuch auftrat, Versionen von axe-core ohne Patch-Versionsnummer auszuwählen.
  • Die Logik zur Zusammenführung von Benutzereinstellungen mit globalen Konfigurationen verbessert.
  • Verbesserte Handhabung der axe-core-Version, wenn kein configurationOverrides bereitgestellt wird.
  • Verbesserte Fehlermeldung für einen nicht zugelassenen Barrierefreiheitsstandard in configurationOverrides.
  • Fehlermeldungen verbessert, um einen Link zur Problembehandlungsdokumentation hinzuzufügen.
  • Die Fehlerbehandlung beim Senden von Ergebnissen an den Server verbessert, die zuvor dazu führte, dass die Testsuite stoppte.

3.20.0

• Nicht veröffentlicht

3.19.1 (25. Februar 2025)

• Ein Problem behoben, bei dem der Aufruf einer umschlossenen Methode (wie click()) nach dem Wechseln des Browser-Kontexts zu einem untergeordneten Frame mit switchToFrame() (WebdriverIO oder WebDriverJS) oder switchTo().frame() (Java Selenium) zu einem Analyse-Timeout führte. Axe Watcher überspringt jetzt die Analyse, wenn nicht im obersten Frame. Siehe Keine Seitenzustände erfasst nach dem Wechsel zu einem untergeordneten Frame für weitere Informationen.
• Stellen Sie sicher, dass Testsuiten, die --disable-extensions angeben, Watcher nicht deaktivieren.

3.19.0 (20. Januar 2025)

• Verbesserte Fehlermeldung mit Playwright und Playwright Test Versionen 1.49.0 oder höher bei Verwendung des headless-Parameters, wenn der channel-Parameter auf firefox gesetzt ist. (Nur die chromium- oder chrome-Kanäle werden im vollwertigen Modus oder im neuen Headless-Modus unterstützt.)
• Die Versionserkennung für axe-core verbessert.
• Unterstützung für globale Konfigurationen.

3.18.0 (18. Dezember 2024)

• Mehrere Probleme bei der Sitzungsverarbeitung behoben, die dazu führen konnten, dass fehlerhafte oder leere Ergebnisse auf der Website angezeigt wurden.
• Unterstützung für neuen Chromium-Headless-Modus in Playwright-Versionen >= 4.91 hinzugefügt. Siehe Neuen Chromium Headless ausprobieren in den Playwright 4.91-Release-Notes.
• Benutzerdefinierte Timeout-Werte hinzugefügt, um Benutzern die Kontrolle über die Sitzungsverarbeitung zu ermöglichen.

3.17.2 (12. Dezember 2024)

• Funktionen

  • Manuellen Modus zum Watcher hinzugefügt.
  • Eine Analyse auf einem nicht unterstützten Protokoll (jedes Protokoll außer *https*, *http* oder *file*) oder auf der *about:blank*-Seite wird zu einem Fehler führen.
  • Jetzt wirft Watcher einen Fehler, wenn er nicht vor der Verwendung konfiguriert wird.

• Fehlerbehebungen

  • Ein Problem im Playwright-Test behoben, bei dem Sitzungen wiederverwendet wurden und dadurch Ergebnisse überschrieben wurden.
  • Mehrere andere Probleme beim Erstellen und Verwalten von Sitzungen behoben.
  • Im manuellen Modus markiert der Aufruf der start()-Methode des Controllers nun das DOM der aktuellen Seite als sauber, sodass kein Seitenzustand erfasst wird.
  • Im manuellen Modus wurde ein Problem behoben, bei dem manchmal ein zusätzlicher Seitenzustand erfasst wurde, wenn flush() aufgerufen wurde.
  • Ein Problem behoben, das einen fehlenden Seitenzustand verursachte, wenn cy.axeWatcherAnalyze() nach cy.click() aufgerufen wurde, ohne einen cy.wait()-Aufruf.
  • Enthält jetzt eine aktualisierte LICENSES-3RD-PARTY.md-Datei mit dem @axe-core/watcher-Paket.
  • Die stop()-Methode des Controllers analysiert nun die Seite, wenn sich das DOM vor dem Ausschalten des automatischen Modus geändert hat.
  • Das Verhalten von Watcher geändert, sodass im manuellen Modus keine Seitenanalyse erfolgt, wenn die stop()-Methode des Controllers aufgerufen wird.
  • Ein Problem in der Playwright-Integration behoben, das dazu führte, dass umschlossene Methoden falsche Typen zurückgaben.
  • Ein Problem behoben, das verhinderte, dass runOptions nur eine Option akzeptierte.

3.17.1

• Nicht veröffentlicht

3.17.0

• Nicht veröffentlicht

3.16.1 (25. Oktober 2024)

• Lizenzen von Drittanbietern enthalten.

3.16.0 (26. September 2024)

• Ein Problem mit einer transitiven Abhängigkeit bei Cypress-Befehlen behoben.

3.15.2 (13. September 2024)

• Unterstützung für WebdriverIO Version 9 hinzugefügt (wobei die Unterstützung für WebdriverIO Versionen 7 und 8 beibehalten wird).

3.15.1

• Übersprungen (es gab keinen Release Candidate)

3.15.0

• Nicht veröffentlicht

3.14.3 (5. September 2024)

• Keine für Benutzer sichtbaren Änderungen

3.14.2 (29. August 2024)

• Ein Fehler beim Zugriff auf den Timeout-Wert in Cypress wurde behoben.
• Für Cypress wird jetzt eine Ausnahme ausgelöst, wenn der Benutzer versucht, Watcher zu verwenden, ohne zuvor cypressConfig() aufzurufen.
• Ein Fehler behoben, der unter bestimmten Bedingungen in Cypress beim Importieren des os Moduls auftrat.
• buildID zu AxeConfiguration für parallele Testläufe hinzugefügt.
• sessionID in AxeConfiguration zugunsten von buildID als veraltet markiert.
• Ein Problem behoben, das dazu führte, dass ein zusätzlicher Seitenzustand mit Puppeteer erfasst wurde, aufgrund der Handhabung von authenticate().
• Leistungsverbesserungen in Axe Watcher aufgrund von Änderungen in der Code-Verschleierung.

3.14.1

• Nicht veröffentlicht

3.14.0

• Nicht veröffentlicht

3.13.1 (19. Juli 2024)

• Ermöglicht das Ausschließen von URLs aus dem Analysescan durch die Verwendung der excludeUrlPatterns Option. Siehe excludUrlPatterns.

3.13.0

• Nicht veröffentlicht

3.12.0 (16. Juli 2024)

• Die Handhabung des Remountens von Komponenten in Cypress verbessert.
• Sicherstellen, dass Watcher in WebdriverIO Version 7 geladen werden kann.
• Unterstützung für Puppeteer locator hinzugefügt.
• Konfiguration von runContext und runOptions für axe-core hinzugefügt. Siehe runContext und runOptions.

3.11.1 (26. Juni 2024)

• Ein Problem behoben, bei dem Rückgabewerte von externen setupNodeEvents Handlern in Cypress nicht weiterverarbeitet wurden.
• Verhalten geändert, um das Laden der Chrome-Erweiterung von Cypress zu ermöglichen.

3.11.0 (17. Juni 2024)

• Ein Problem behoben, bei dem das Unmounten und Remounten von Komponenten dazu führte, dass Barrierefreiheitsscans in Cypress abbrachen.
• Die Browsererkennung wurde gelockert, um Fehler zu vermeiden, selbst beim Einsatz unterstützter Browser.
• Dateischreibvorgänge beim Flushing von Ergebnissen in Cypress entfernt.

3.10.0 (16. Mai 2024)

• Ein Problem in Cypress behoben, bei dem das von setupNodeEvents zurückgegebene config Objekt nicht korrekt verarbeitet wurde und alle daran vorgenommenen Änderungen verloren gingen.
• Die Implementierung von proxy-basierten Funktionen (für Playwright Test) korrigiert, die zu einem Fehler bei Locator Objekten führten: kann nur mit Locator-Objekt verwendet werden.
• Zwei neue Playwright-Funktionen aus der Version 1.43.1 eingebunden.

3.9.0 (30. April 2024)

• Rückwärtskompatible Typen für Puppeteer Version 20 hinzugefügt.
• Für Cypress wurden axeAnalyze(), axeFlush(), axeStart() und axeStop() als veraltet markiert. Ersetzt durch axeWatcherAnalyze(), axeWatcherFlush(), axeWatcherStart() und axeWatcherStop().
• Ein TypeError auf bestimmten Puppeteer Version 21 (und später) Hooks behoben.

3.8.0 (9. April 2024)

• Aktualisieren des ausgegebenen JavaScripts, um ECMAScript 2018 (ES2018) anstelle von ECMAScript 2015 (ES2015) anzustreben.

3.7.0 (21. März 2024)

• Keine für Benutzer sichtbaren Änderungen

3.6.0 (7. März 2024)

• In die Cypress-Integration aufgenommen, dass after:run Ereignisse verhindert werden, wenn keine Tests ausgeführt wurden.
• Das Format der Download-URL für Chromedriver geändert, da das Chromedriver-Team zu einer neuen Hosting-Lösung gewechselt ist. Betrifft WebdriverIO.

3.5.0 (25. Januar 2024)

• Ein Problem behoben, bei dem das Aufrufen der Page.goto() Methode von Playwright fälschlicherweise zwei Seitenzustände aufzeichnete.
• Ein Problem in der Cypress-Integration behoben, das dazu führte, dass bestimmte Benutzerkonfigurationen von setupNodeEvents ignoriert wurden.
• eventemitter3 als erforderliche Abhängigkeit hinzugefügt.
• Eingebundene einige Playwright-Methoden, die zuvor nicht umschlossen waren.

3.4.0 (12. Dezember 2023)

• Ein Problem behoben, bei dem Seitenzustände verloren gingen oder Fehler auftraten, wenn Tests zu Seitennavigationen führten.
• Einige redundante Codezeilen aus der Cypress-Integration entfernt.

3.3.0 (7. Dezember 2023)

• Keine für Benutzer sichtbaren Änderungen

3.2.0 (9. November 2023)

• Keine für Benutzer sichtbaren Änderungen

3.1.1 (12. Oktober 2023)

• Keine für Benutzer sichtbaren Änderungen

3.1.0 (14. September 2023)

• Alle Integrationen erlauben jetzt --headless=new.

3.0.0 (8. September 2023)

Um Fälle zu adressieren, in denen analyze() unerwartet nicht aufgerufen wurde, mussten die folgenden Funktionen als veraltet markiert und ersetzt werden:

Die Verwendung der veralteten Funktionen wird einen Fehler verursachen.