AxeWatcher Klasse
De hoofdklasse voor het integreren van Axe toegankelijkheidstesten in Selenium Java test-suites (gebruik AxeWatcherPlaywright voor Playwright)
De AxeWatcher klasse is de kerncomponent van de Axe Watcher Selenium Java integratie, waarmee je eenvoudig toegankelijkheidstesten kunt toevoegen aan je bestaande end-to-end test-suites. Deze klasse biedt methoden om browseropties te configureren en WebDriver instanties te wikkelen om toegankelijkheidsanalyses mogelijk te maken tijdens geautomatiseerde tests.
Wanneer geïntegreerd in je testframework, doet Axe Watcher het volgende:
- Analyseert automatisch webpagina's op toegankelijkheidsproblemen wanneer tests worden uitgevoerd
- Analyseert opnieuw pagina's bij detectie van DOM-wijzigingen
- Linkt Git-commits aan toegankelijkheidsresultaten
- Stuurt toegankelijkheidsresultaten naar de Axe Developer Hub voor tracking en analyse
Constructor
AxeWatcher(AxeWatcherOptions options)
Creëert een nieuwe instantie van AxeWatcher met de gespecificeerde opties.
Parameters:
options- De configuratieopties voor Axe Watcher
Voorbeeld:
AxeWatcherOptions options = new AxeWatcherOptions()
.setApiKey("your-api-key-here")
.setProjectId("your-project-ID-here")
.setServerUrl("https://axe.deque.com");
AxeWatcher watcher = new AxeWatcher(options);Methoden
configure(ChromeOptions chromeOptions)
Configureert ChromeOptions om toegankelijkheidstesten met Axe Watcher mogelijk te maken.
Deze methode moet worden aangeroepen voordat je een ChromeDriver instantie maakt.
Parameters:
chromeOptions- De bestaandeChromeOptionsinstantie om te configureren
Retourneert:
- Een nieuwe
ChromeOptionsinstantie met de Axe Watcher configuratie toegepast
Gooit:
IllegalArgumentException- Als headless of incognito modus ingeschakeld is (Axe Watcher ondersteunt deze modi niet)
Voorbeeld:
AxeWatcherOptions options = new AxeWatcherOptions();
options.setApiKey("your-api-key-here");
options.setProjectId("your-project-id-here");
AxeWatcher watcher = new AxeWatcher(options);
ChromeOptions chromeOptions = new ChromeOptions();
// Add any additional Chrome options here
ChromeOptions configuredOptions = watcher.configure(chromeOptions);
// Now create ChromeDriver with the configured options
ChromeDriver driver = new ChromeDriver(configuredOptions);wrapDriver(ChromeDriver chromeDriver)
Wikkelt een ChromeDriver instantie om toegankelijkheidstestfunctionaliteit mogelijk te maken.
Deze methode moet worden aangeroepen nadat configure() is gebruikt om de ChromeDriver op te zetten.
Parameters:
chromeDriver- DeChromeDriverinstantie om te wikkelen
Retourneert:
- Een gewikkelde
WebDriverinstantie met de toegankelijkheidstestfunctionaliteit ingeschakeld
Gooit:
RuntimeException- Alsconfigure()niet is aangeroepen voordat deze methode
Voorbeeld:
AxeWatcherOptions options = new AxeWatcherOptions();
options.setApiKey("your-api-key-here");
options.setProjectId("your-project-id-here");
AxeWatcher watcher = new AxeWatcher(options);
ChromeOptions chromeOptions = watcher.configure(new ChromeOptions());
ChromeDriver chromeDriver = new ChromeDriver(chromeOptions);
// Wrap the ChromeDriver
WebDriver driver = watcher.wrapDriver(chromeDriver);
// Now use the wrapped driver for testing
driver.get("https://example.com");enableDebugLogger()
Schakelt foutopsporingslogboeken in voor Axe Watcher operaties. Dit kan nuttig zijn voor het oplossen van problemen tijdens de ontwikkeling van tests.
Retourneert:
- De huidige
AxeWatcherinstantie voor method chaining
Voorbeeld:
AxeWatcherOptions options = new AxeWatcherOptions();
options.setApiKey("your-api-key-here");
options.setProjectId("your-project-id-here");
AxeWatcher watcher = new AxeWatcher(options).enableDebugLogger();Notities en Beperkingen
- Axe Watcher ondersteunt geen volledige headless modus. Gebruik
--headless=newin plaats van--headlessals je headless werking nodig hebt. - Axe Watcher ondersteunt geen incognito modus.
- Je moet
configure()aanroepen voordat je eenChromeDriverinstantie maakt. - Je moet
wrapDriver()aanroepen nadat je deChromeDriverinstantie hebt gemaakt. - Roep
flush()aan op deaxeWatcher()van de gewrapte driver in je testafbouw om ervoor te zorgen dat alle resultaten naar de Axe Developer Hub worden gestuurd.
