AxeWatcher Klasse

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard

De hoofdklasse voor het integreren van Axe toegankelijkheidstesten in Selenium Java test-suites (gebruik AxeWatcherPlaywright voor Playwright)

Not for use with personal data

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 testsuites. Deze klasse biedt methoden om browseropties te configureren en WebDriver-instanties te omhullen om toegankelijkheidsanalyse tijdens geautomatiseerd testen mogelijk te maken.

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 in te schakelen.

important

Deze methode moet worden aangeroepen voordat je een ChromeDriver instantie maakt.

Parameters:

  • chromeOptions - De bestaande ChromeOptions instantie om te configureren

Retourneert:

  • Een nieuwe ChromeOptions-instantie met toegepaste Axe Watcher-configuratie

Gooit:

  • IllegalArgumentException - Als de modus 'headless' of 'incognito' is ingeschakeld (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.

important

Deze methode moet worden aangeroepen nadat configure() is gebruikt om de ChromeDriver op te zetten.

Parameters:

  • chromeDriver - De ChromeDriver instantie om te wikkelen

Retourneert:

  • Een gewikkelde WebDriver instantie met de toegankelijkheidstestfunctionaliteit ingeschakeld

Gooit:

  • RuntimeException - Als configure() 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 foutopsporingslogboekregistratie in voor Axe Watcher-operaties. Dit kan nuttig zijn voor het oplossen van problemen tijdens testontwikkeling.

Retourneert:

  • De huidige AxeWatcher instantie 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=new in plaats van --headless als je 'headless'-werking nodig hebt.
  • Axe Watcher ondersteunt de incognitomodus niet.
  • Je moet configure() aanroepen voordat je een ChromeDriver instantie maakt.
  • Je moet wrapDriver() aanroepen nadat je de ChromeDriver instantie hebt gemaakt.
  • Roep flush() aan op de omhuldede driver van de axeWatcher() in je test-teardown om ervoor te zorgen dat alle resultaten naar de Axe Developer Hub worden verzonden.

Zie Ook