Watcher-pakket vrijgavennotities
Vrijgavennotities die de veranderingen in het Watcher-pakket beschrijven voor versie 3.0.0 en later
4.3.0 (12 mei 2026)
- Oplossingen
- Een raceprobleem opgelost in de Java-integratie waarbij het switchen van de browsercontext naar een iframe onterecht scans zou activeren, wat leidde tot extra resultaten die werden vastgelegd.
- Axe-core bijgewerkt naar versie 4.11.4.
4.2.0 (6 april 2026)
-
Functies
- De
gitoptie uitgebreid om het leveren van expliciete Git-metadata te ondersteunen. In JavaScript/TypeScript accepteert degiteigenschap nu eenAxeConfigurationobject naast een boolean. In Java,GitConfigheeft een nieuweAxeWatcherOptionsmethode. Wanneer eensetGitInfo(AxeWatcherGitInfo)ofGitConfigobject wordt geleverd, wordt automatische Git-detectie overgeslagen. Alle velden zijn optioneel. Dit is nuttig wanneer tests worden uitgevoerd in een repository die gescheiden is van de testrepository, of in CI-omgevingen waar Git-automatische detectie onbetrouwbaar is. ZieAxeWatcherGitInfoHet leveren van Git-metadata voor meer informatie. .
- De
-
Oplossingen
- Een probleem opgelost waarbij het aanroepen van
flush()terwijl resultaten nog werden verwerkt, onvolledige resultaten kon opleveren. (JavaScript/TypeScript-integratie) - Een probleem opgelost in de Java/Selenium-integratie waarbij uitzonderingen van
findElement()niet correct werden weergegeven, waardoor expliciete wachttijden direct mislukten in plaats van te wachten tot het element verscheen. - De betrouwbaarheid verbeterd in de Java-integratie: Watcher probeert nu automatisch tot drie keer toe resultaten naar de server te sturen wanneer een tijdelijke fout wordt aangetroffen.
- Een probleem opgelost in de Java-integratie waarbij het doorgeven van
nullaan bepaalde configuratiesetmethoden een niet-opgevangen uitzondering veroorzaakte. Deze methoden geven nu eenIllegalArgumentExceptionmet een beschrijvend bericht.
- Een probleem opgelost waarbij het aanroepen van
4.1.0 (24 februari 2026)
-
Functies
- Watcher scant nu automatisch alle iframes met dezelfde oorsprong. (De Cypress-integratie had dit gedrag al.) Dit geldt voor de Playwright-, Puppeteer-, WebdriverIO-, WebDriverJS- en Java Selenium-integraties.
- Ondersteuning toegevoegd voor de RGAA v4 (Franse toegankelijkheidsstandaard). Stel in
accessibilityStandard: 'RGAAv4'(JavaScript/TypeScript) of gebruikConfigurationOverrides(Java). Vereist axe-core versie 4.11.0 of later. De globale configuratie bepaalt of deze standaard is toegestaan voor uw organisatie.ConfigurationOverrides.AccessibilityStandard.RGAAV4Een - optie toegevoegd aan
git(JavaScript/TypeScript) enAxeConfiguration(Java) om te bepalen of Git-informatie wordt verzameld. Stel inAxeWatcherOptions(JavaScript/TypeScript) of belgit: false(Java) om Watcher te laten draaien zonder Git-gegevens te verzamelen. De standaardinstelling issetGit(false)(Git-info wordt verzameld).trueAxe-core bijgewerkt naar versie 4.11.1. - Oplossingen
-
Een probleem opgelost in de Java-integratie waarbij een aangepaste Chrome-binarypad ingesteld via
- op het
setBinary()object zou worden overschreven wanneer het werd doorgegeven aanChromeOptions.configure()4.0.0 (3 december 2025)
- op het
Watcher 4.0.0 is een grote release van het Watcher-pakket.
Watcher 4.0.0 is a major release of the Watcher package.
-
**Functies**
- Proxy-ondersteuning toegevoegd. Zie Watcher gebruiken met een proxy voor meer informatie. (HTTP-proxy-implementatie vereist Node.js versie 20.18.1 of later).
- De versie van axe-core bijgewerkt naar 4.11.0.
- Ondersteuning toegevoegd voor Node.js versie 24.
-
**Bugfixes**
- Een probleem opgelost bij het rapporteren van Git-informatie wanneer een GitLab-pipeline wordt gebruikt.
- Foutafhandeling verbeterd voor alternatieven van Chrome zoals Chrome voor testen en Chromium.
- Op de juiste manier omgaan met lege Git-gegevens.
- Alle door de gebruiker verstrekte Chrome-opties voor WebdriverIO opnemen.
-
**Breaking Changes**
-
Watcher (voor TypeScript en JavaScript) gebruikt nu nieuwe paden voor het importeren van het pakket. Zie de instructies voor uw browserintegratiepakket voor bijgewerkte codevoorbeelden.
Browser Automatiseringsplatform Oud Pad Nieuw Pad Cypress @axe-core/watcher@axe-core/watcher/cypress/configCypress Commando's @axe-core/watcher/dist/cypressCommands@axe-core/watcher/cypress/supportPlaywright @axe-core/watcher@axe-core/watcher/playwrightPlaywright Test @axe-core/watcher@axe-core/watcher/playwright-testPuppeteer @axe-core/watcher@axe-core/watcher/puppeteerWebdriverIO @axe-core/watcher@axe-core/watcher/wdioWebdriverIO Testrunner @axe-core/watcher@axe-core/watcher/wdioWebDriverJS @axe-core/watcher@axe-core/watcher/webdriverJavaScript-voorbeeld voor WebDriverJS:
const { webdriverConfig, wrapWebdriver, WebdriverController } = require('@axe-core/watcher/webdriver') -
De onjuiste specificatie van
LaunchOptionsin TypeScript voor Playwright vervangen door een nieuw type genaamdLaunchPersistentContextOptions, dynamisch geëxtraheerd uitlaunchPersistentContext. Gebruikers moeten niet-ondersteunde opties die ze gebruikten metLaunchOptionsverwijderen; anders zal hun TypeScript niet compileren in strikte modus.
-
3.23.0 (1 augustus 2025)
- Verbeterde timeout- en retry-logica bij het versturen van resultaten naar de server (voor Watcher voor JavaScript en TypeScript).
- Een waarschuwing toegevoegd over de
--load-extensionsoptie met Chrome versie 139 en later (zowel voor de JavaScript/TypeScript-implementatie als Java-implementatie). - Rapporteer een mislukking als het maximum aantal herhalingen voor mislukte resultaatuploads wordt overschreden (
Flush: Failed. Maximum retries reached). - Problemen met het omgaan met Chrome voor testen en Chromium opgelost.
- Loggen of het maximum aantal herhalingen is bereikt.
- Componenttests geïmplementeerd in de Cypress-integratie.
3.22.0 (1 juli 2025)
- Zorg ervoor dat
runOptionsgeennullwaarden bevat, wat een stille fout veroorzaakte in de Java-integratie. - Zorg ervoor dat het licentiebestand voor de Java-implementatie wordt gekopieerd naar de
META-INFdirectory. - Een probleem opgelost waarbij uitgesloten URL-patronen niet correct werden gekopieerd in Java.
- De methode voor het bepalen van de standaard Git-branch verbeterd.
3.21.0 (23 mei 2025)
- Java Watcher uitgebracht.
- Een fallback-methode geïmplementeerd om de standaard Git-branchnaam vast te stellen.
- Een probleem opgelost met de Cypress-integratie waarbij lange
wait() tijden dubbele paginastatussen of testfouten veroorzaakten. - Een probleem opgelost waarbij
runOptions.runOnlyniet correct werkte met de Cypress-integratie.
3.20.2 (17 april 2025)
- Een probleem opgelost met de foutmeldingen bij time-outs die de verkeerde parameter aangaven om te wijzigen. (Bijvoorbeeld, de gebruiker werd aangemoedigd om
timeoutStartin plaats van de correctetimeout.startwaarde te wijzigen.)
3.20.1 (25 maart 2025)
-
**Functies**
- Toestaan van het selecteren van eerdere versies van axe-core.
- Het doorspoelen van resultaten naar de server robuuster gemaakt.
-
**Bugfixes**
- Een probleem opgelost bij het consolideren van globale configuraties met gebruikersconfiguratie-overschrijvingen.
- Een racecondition opgelost in de Cypress-integratie.
- Een probleem opgelost met de Cypress-integratie waarbij experimentele regels niet waren ingeschakeld.
- Een probleem opgelost waarbij het inschakelen van de EN 301 549-standaard niet werd nagekomen.
- Een probleem opgelost met
configurationOverridesals er geen waarden waren ingesteld. - Extra validatie toegevoegd voor Playwright en Playwright Test.
- Een probleem opgelost bij het proberen te selecteren van versies van axe-core zonder een patchversienummer.
- De logica voor het samenvoegen van gebruikersconfiguraties met globale configuraties verbeterd.
- Verbeterd omgaan met de axe-core versie wanneer er geen
configurationOverrideswerd geleverd. - Foutmelding verbeterd voor een niet toegestane toegangsstandaard in
configurationOverrides. - Foutmeldingen aangepast om een link naar de probleemoplossingsdocumentatie op te nemen.
- Betere foutafhandeling wanneer resultaten naar de server werden gestuurd, wat eerder ervoor zorgde dat de testsuite stopte.
3.20.0
- Niet vrijgegeven
3.19.1 (25 februari 2025)
- Een probleem opgelost waarbij een omwikkelde methode aanroepen (zoals
click()) na het wisselen van de browsercontext naar een child-frame met behulp vanswitchToFrame()(WebdriverIO of WebDriverJS) ofswitchTo().frame()(Java Selenium) een analyse-time-out veroorzaakte. Axe Watcher slaat nu de analyse over wanneer het niet in het bovenste frame is. Zie Geen paginastatussen vastgelegd na overschakelen naar een child-frame voor meer informatie. - Zorg ervoor dat testsuites die
--disable-extensionsspecificeren de Watcher niet uitschakelen.
3.19.0 (20 januari 2025)
- De foutmelding verbeterd met Playwright en Playwright Test versies 1.49.0 of hoger bij het gebruik van de
headlessparameter wanneer dechannelparameter is ingesteld opfirefox. (Alleen dechromiumofchromekanalen worden ondersteund in volledige modus of de nieuwe koploze modus.) - Verbeterde versiecontrole voor axe-core.
- Ondersteuning voor globale configuraties.
3.18.0 (18 december 2024)
- Verschillende problemen met sessiebehandeling opgelost, waardoor onjuiste of lege resultaten op de website konden verschijnen.
- Ondersteuning toegevoegd voor nieuwe Chromium headless in Playwright-versies >= 4.91. Zie Probeer nieuwe Chromium headless in de Playwright 4.91 release-opmerkingen.
- Aangepaste timeout-waarden toegevoegd om gebruikers controle over sessiebehandeling te geven.
3.17.2 (12 december 2024)
-
Kenmerken
- Handmatige modus toegevoegd aan Watcher.
- Een analyse uitvoeren op een niet-ondersteund protocol (elk protocol behalve https, http, of file) of op de about:blank pagina zal resulteren in een fout.
- Nu geeft Watcher een foutmelding als het niet geconfigureerd is voordat het wordt gebruikt.
-
Bugfixes
- Een probleem opgelost in Playwright Test waarbij sessies werden hergebruikt, waardoor resultaten werden overschreven.
- Verschillende andere problemen met het maken en beheren van sessies opgelost.
- In handmatige modus markeert het aanroepen van de controller's
start()methode nu de DOM van de huidige pagina als schoon, zodat geen pagina-informatie wordt vastgelegd. - In handmatige modus een probleem opgelost waarbij soms een extra pagina-informatie werd vastgelegd wanneer
flush()werd aangeroepen. - Een probleem opgelost waardoor een ontbrekende pagina-informatie ontstond wanneer
cy.axeWatcherAnalyze()werd aangeroepen nacy.click()werd aangeroepen zonder eency.wait()oproep. - Nu een bijgewerkte LICENSES-3RD-PARTY.md-bestand opnemen bij het @axe-core/watcher pakket.
- De controller-methode
stop()analyseert nu de pagina als de DOM is gewijzigd voordat de automatische modus wordt uitgeschakeld. - Veranderd gedrag van Watcher zodat als Watcher in handmatige modus is, de pagina niet wordt geanalyseerd als de controller-methode
stop()wordt aangeroepen. - Een probleem opgelost in de Playwright-integratie waardoor omwikkelde methoden onjuiste typen retourneerden.
- Een probleem opgelost waardoor
runOptionsniet slechts één optie kon accepteren.
3.17.1
- Niet uitgebracht
3.17.0
- Niet uitgebracht
3.16.1 (25 oktober 2024)
- Licenties van derden opgenomen.
3.16.0 (26 september 2024)
- Een transitief afhankelijkheidsprobleem opgelost met betrekking tot Cypress-opdrachten.
3.15.2 (13 september 2024)
- Ondersteuning toegevoegd voor WebdriverIO versie 9 (terwijl ondersteuning voor WebdriverIO versies 7 en 8 behouden blijft).
3.15.1
- Overgeslagen (er was geen releasekandidaat)
3.15.0
- Niet uitgebracht
3.14.3 (5 september 2024)
- Geen zichtbare veranderingen voor de gebruiker
3.14.2 (29 augustus 2024)
- Een fout opgelost bij het benaderen van de timeoutwaarde in Cypress.
- Voor Cypress wordt nu een uitzondering geworpen als de gebruiker probeert Watcher te gebruiken zonder eerst aan te roepen
cypressConfig(). - Een fout opgelost die onder bepaalde omstandigheden in Cypress verscheen bij het importeren van de
osmodule. - Toegevoegd
buildIDaanAxeConfigurationvoor parallelle testuitvoeringen. - Afgekeurd
sessionIDinAxeConfigurationten gunste vanbuildID. - Een probleem opgelost dat ervoor zorgde dat er een extra paginastatus werd vastgelegd met Puppeteer door de afhandeling van
authenticate(). - Prestatieverbeteringen in axe Watcher door wijzigingen in code-obfuscatie.
3.14.1
- Niet uitgebracht
3.14.0
- Niet uitgebracht
3.13.1 (19 juli 2024)
- URLs uitsluiten van de analysescan mogelijk maken door de
excludeUrlPatternsoptie te gebruiken. ZieexcludUrlPatterns.
3.13.0
- Niet uitgebracht
3.12.0 (16 juli 2024)
- De afhandeling van het opnieuw monteren van componenten in Cypress verbeterd.
- Zorg ervoor dat Watcher geladen kan worden in WebdriverIO versie 7.
- Puppeteer
locatorondersteuning toegevoegd. - Configuratie toegevoegd van
runContextenrunOptionsvoor axe-core. ZierunContextenrunOptions.
3.11.1 (26 juni 2024)
- Een probleem opgelost waarbij retourwaarden van externe
setupNodeEventshandlers in Cypress niet werden doorgegeven. - Gedragswijziging om het laden van de Chrome-extensie van Cypress mogelijk te maken.
3.11.0 (17 juni 2024)
- Een probleem aangepakt waarbij het ontkoppelen en opnieuw koppelen van componenten ervoor zorgde dat toegankelijkheidsscans in Cypress vastliepen.
- De browserdetectielogica versoepeld om fouten te voorkomen, zelfs bij gebruik van ondersteunde browsers.
- Verwijderde bestandssysteem schrijfacties bij het flushen van resultaten in Cypress.
3.10.0 (16 mei 2024)
- Een probleem opgelost in Cypress waar het
configobject dat werd geretourneerd vanuitsetupNodeEventsniet correct werd doorgegeven en eventuele wijzigingen eraan verloren gingen. - De implementatie van geproxiede functies (voor Playwright Test) opgelost die resulteerde in een fout met
Locatorobjecten: kan alleen worden gebruikt met een Locator-object. - Twee nieuwe Playwright-functies van de release 1.43.1 ingepakt.
3.9.0 (30 april 2024)
- Achterwaarts compatibele typen toegevoegd voor Puppeteer versie 20.
- Voor Cypress, als verouderd aangemerkt
axeAnalyze(),axeFlush(),axeStart(), enaxeStop(). Vervangen dooraxeWatcherAnalyze(),axeWatcherFlush(),axeWatcherStart(), enaxeWatcherStop(). - Een probleem opgelost
TypeErrorbij bepaalde Puppeteer versie 21 (en later) hooks.
3.8.0 (9 april 2024)
- De gegenereerde JavaScript bijgewerkt om ECMAScript 2018 (ES2018) te targeten in plaats van ECMAScript 2015 (ES2015).
3.7.0 (21 maart 2024)
- Geen voor de gebruiker zichtbare veranderingen
3.6.0 (7 maart 2024)
- In de Cypress-integratie, voorkom
after:rungebeurtenissen als er geen tests zijn uitgevoerd. - Het download-URL-formaat voor Chromedriver gewijzigd omdat het Chromedriver-team naar een nieuwe hostoplossing is overgestapt. Affecteert WebdriverIO.
3.5.0 (25 januari 2024)
- Een probleem opgelost waarbij het aanroepen van de
Page.goto()methode van Playwright onterecht twee paginastaten registreerde. - Een probleem opgelost in de Cypress-integratie dat ervoor zorgde dat bepaalde gebruikersconfiguraties van
setupNodeEventswerden genegeerd. - Toegevoegd
eventemitter3als een vereiste afhankelijkheid. - Ingepakt enkele Playwright-methoden die eerder niet waren ingepakt.
3.4.0 (12 december 2023)
- Een probleem opgelost waar paginastaten verloren gingen of fouten optraden wanneer tests paginanavigaties veroorzaakten.
- Enige overbodige code verwijderd uit de Cypress-integratie.
3.3.0 (7 december 2023)
- Geen voor de gebruiker zichtbare veranderingen
3.2.0 (9 november 2023)
- Geen voor de gebruiker zichtbare wijzigingen
3.1.1 (12 oktober 2023)
- Geen voor de gebruiker zichtbare wijzigingen
3.1.0 (14 september 2023)
- Alle integraties staan nu toe
--headless=new.
3.0.0 (8 september 2023)
Om gevallen aan te pakken waarin analyze() onverwachts niet werd aangeroepen, moesten de volgende functies worden afgeschaft en vervangen:
| Verouderde functie | Nieuwe functie |
|---|---|
wrapPlaywright(browserContext, controller) |
wrapPlaywrightPage(page, controller) |
wrapPuppeteer(context, controller) |
wrapPuppeteerPage(page, controller) |
Het gebruik van de verouderde functies zal een foutmelding geven.
