Instructies voor Java en Selenium
Configuratie van uw tests met Java en Selenium
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.
-
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> -
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; -
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, genaamdwrappedDriver, 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 aanconfigure()en eenEdgeDriver-instantie aanwrapDriver()(beide worden geïmporteerd uitorg.openqa.selenium.edge). Alles, inclusief de controller-methoden enflush(), 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));importantOndersteuning voor Microsoft Edge vereist Watcher 4.5.1 of later en Selenium 4 of later. Selenium 3's
EdgeOptionsricht zich op de verouderde EdgeHTML-browser, die door Axe Watcher niet wordt ondersteund, dus het aanroepen vanconfigure()metEdgeOptionsop Selenium 3 resulteert in eenIllegalStateException. Chrome voor Testing en Chromium blijven ondersteund op Selenium 3.141.59 en later.Zorg ervoor dat je
ACCESSIBILITY_API_KEYenPROJECT_IDin 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 ookSERVER_URLin op de basis-URL van die instantie (bijvoorbeeld,https://axe-eu.deque.com); zo niet, laat danSERVER_URLweg en zal de standaardhttps://axe.deque.comgebruikt worden. -
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.
