important

Axe Watcher vereist een ondersteunde browser die al op uw systeem is geïnstalleerd: Chrome for Testing (een aparte browserinstallatie, anders dan Google Chrome), Chromium of Microsoft Edge. Google Chrome, versie 139 of later, wordt niet ondersteund. Zie Browsers instellen en configureren voor gebruik met Axe Watcher voor installatie- en configuratie-instructies.

  1. Voeg een nieuwe afhankelijkheid toe voor het Java Watcher-pakket aan uw pom.xml (voor Maven) afhankelijkhedensectie (het Java Watcher-pakket is beschikbaar op Maven Central):

    <dependencies>
    
    <!-- Add this dependency: -->
      <dependency>
         <groupId>com.deque.axe_core</groupId>
         <artifactId>watcher</artifactId>
         <version>4.5.1</version> <!-- Update this as needed -->
      </dependency>
    
    </dependencies>
  2. Voeg imports voor Java Watcher toe aan uw testcode:

    import com.deque.axe_core.commons.AxeWatcherOptions;
    import com.deque.axe_core.selenium.AxeWatcher;
    import com.deque.axe_core.selenium.AxeWatcherDriver;
  3. Voeg setup-code toe voor Java Watcher, inclusief uw persoonlijke API-sleutel en project-ID (beide opgeslagen in de omgeving voor veiligheid en flexibiliteit):

    AxeWatcherOptions options =
        new AxeWatcherOptions()
            .setApiKey(System.getenv("ACCESSIBILITY_API_KEY"))
            .setProjectId(System.getenv("PROJECT_ID"));
    // Optional: uncomment and set SERVER_URL if using a regional, private cloud, or on-premises instance:
    // options.setServerUrl(System.getenv("SERVER_URL"));
    AxeWatcher watcher = new AxeWatcher(options);
    ChromeOptions chromeOptions = new ChromeOptions();
    chromeOptions = watcher.configure(chromeOptions);
    WebDriver wrappedDriver = watcher.wrapDriver(new ChromeDriver(chromeOptions));

    Deze codefragment maakt een nieuwe WebDriver-instantie aan, genaamd wrappedDriver, die u dient te casten om de axe-controller-methoden te gebruiken.

    Om je tests in Microsoft Edge uit te voeren, geef je een EdgeOptions-instantie door aan configure() en een EdgeDriver-instantie aan wrapDriver() (beide worden geïmporteerd uit org.openqa.selenium.edge). Alles, inclusief de controller-methoden en flush(), werkt verder op dezelfde manier:

    AxeWatcherOptions options =
        new AxeWatcherOptions()
            .setApiKey(System.getenv("ACCESSIBILITY_API_KEY"))
            .setProjectId(System.getenv("PROJECT_ID"));
    AxeWatcher watcher = new AxeWatcher(options);
    EdgeOptions edgeOptions = new EdgeOptions();
    edgeOptions = watcher.configure(edgeOptions);
    WebDriver wrappedDriver = watcher.wrapDriver(new EdgeDriver(edgeOptions));
    important

    Ondersteuning voor Microsoft Edge vereist Watcher 4.5.1 of later en Selenium 4 of later. Selenium 3's EdgeOptions richt zich op de verouderde EdgeHTML-browser, die door Axe Watcher niet wordt ondersteund, dus het aanroepen van configure() met EdgeOptions op Selenium 3 resulteert in een IllegalStateException. Chrome voor Testing en Chromium blijven ondersteund op Selenium 3.141.59 en later.

    Zorg ervoor dat je ACCESSIBILITY_API_KEY en PROJECT_ID in je omgeving instelt op je persoonlijke API-sleutel (te vinden in je Axe-account, tabblad **API-SLEUTELS**) en je project-ID (weergegeven bovenaan deze instructies toen je je project maakte of beschikbaar van de Projecten-pagina door **Project configureren** te kiezen onder **Instellingen**). Als je organisatie een regionale, private cloud of on-premises Axe Developer Hub-instantie gebruikt, stel dan ook SERVER_URL in op de basis-URL van die instantie (bijvoorbeeld, https://axe-eu.deque.com); zo niet, laat dan SERVER_URL weg en zal de standaard https://axe.deque.com gebruikt worden.

  4. Roep flush() aan het einde van uw testsessie aan:

    ((AxeWatcherDriver) wrappedDriver).axeWatcher().flush();

    Het aanroepen van flush() geeft aan dat de testrun is voltooid en dat de resultaten kunnen worden verwerkt en aan de gebruiker gepresenteerd.