Importer et Initialiser avec Java

Une fois que vous avez installé Axe DevTools pour le Web, vous devez l'importer dans votre fichier de test et initialiser l'outil en conjonction avec son webdriver.

Prérequis

Pour importer et initialiser Axe DevTools pour le Web, il doit d'abord être installé. Si cela n'est pas encore fait, lisez le guide sur comment l'installer depuis un bundle, depuis votre dépôt d'artefacts ou depuis Agora de Deque. Vous avez également besoin d'un Selenium WebDriver téléchargé et configuré de votre choix.

Importation

Pour utiliser Axe DevTools, plusieurs packages doivent être importés. Selon votre configuration, ces packages peuvent varier. Deque propose quatre intégrations Java :

• Selenium (Écrire des tests avec Selenium et Référence API Selenium Java)
• Hamcrest (Écrire des tests avec Hamcrest et Référence API Hamcrest)
• Cucumber (Écrire des tests avec Cucumber)
• Playwright (Utiliser Playwright et Référence API Playwright)

Instructions d'importation de configuration Selenium

Pour utiliser Axe DevTools avec Selenium, suivez cette partie du guide. Utilisez cette configuration si vous ne couplez pas Axe DevTools avec une bibliothèque d'assertions existante et que vous écrivez vos propres tests. De plus, des instructions d'importation seront nécessaires pour le webdriver de votre choix.

Le seul package qui doit être explicitement importé est le package Selenium Axe DevTools. C'est ce qui communique entre Axe DevTools et le Selenium WebDriver pour effectuer les analyses.

import com.deque.html.axedevtools.selenium.*;

Pour cette configuration, deux autres packages sont recommandés pour vous permettre de générer et d'interpréter les résultats. Le package de résultats génère un objet JSON contenant les résultats de l'analyse, et le package reporter permet de générer des rapports en HTML, JUnit XML ou CSV des résultats de l'analyse.

import com.deque.html.axedevtools.selenium.results.*;
import com.deque.html.axedevtools.selenium.reporter.*;

Instructions d'importation Hamcrest

Pour les environnements de test utilisant Hamcrest, seuls deux packages doivent être importés. Le premier package contient tout ce qui est nécessaire pour les analyses standard.

import com.deque.html.axedevtools.matchers.*;

Le deuxième package ajoute la capacité de limiter les analyses par sélecteurs. Pour utiliser cette fonctionnalité, l'importation supplémentaire de ce package est requise.

import com.deque.html.axedevtools.matchers.selectors;

Instructions d'importation Cucumber

Pour associer Axe DevTools avec Cucumber, seul un package d'importation est requis.

import com.deque.html.axedevtools.cucumber.*;

Instructions d'importation Playwright

Vous devez importer deux packages pour utiliser l'intégration Playwright.

import com.deque.html.maven.axedevtools.playwright.AxePlaywrightBuilder;
import com.deque.html.maven.axedevtools.utility.axeresults.AxeResults; 

Vous devez également importer les packages Playwright de Microsoft.

import com.microsoft.playwright.Browser;
import com.microsoft.playwright.BrowserType;
import com.microsoft.playwright.Page;
import com.microsoft.playwright.Playwright;

Initialisation (hors Playwright)

Après avoir ajouté les instructions d'importation de packages nécessaires à votre fichier de test, vous devrez initialiser Axe DevTools avec son navigateur Web afin de réaliser des analyses d'accessibilité. En utilisant la configuration standard, ce code initialisera Axe DevTools. Cet exemple utilise ChromeDriver, mais d'autres pilotes de navigateur comme GeckoDriver fonctionnent tout aussi bien.

WebDriver webdriver = new ChromeDriver();
AxeDriver axedriver = new AxeDriver(webdriver);

De plus, si vous avez besoin d'un objet de résultats généré et/ou d'un rapport, un objet Selenium axe doit être importé, comme décrit ci-dessus, et initialisé

AxeSelenium axeSelenium = new AxeSelenium();

Initialisation Playwright

Pour initialiser Playwright, vous construisez un nouvel objet Playwright, l'utilisez pour créer un nouvel objet Navigateur, et enfin, utilisez l'objet Navigateur pour créer un objet Page.

Playwright playwright = Playwright.create();
Browser browser = playwright.chromium()
    .launch(new BrowserType.LaunchOptions().setHeadless(true));
Page page = browser.newPage();
page.navigate("https://dequeuniversity.com/demo/mars/");

Étapes suivantes

Une fois que vous avez installé, importé et initialisé Axe DevTools, vous êtes prêt à passer à l'analyse de l'accessibilité et à l'écriture de tests d'accessibilité. Pour ce faire, consultez le guide sur écrire des tests avec Selenium, écrire des tests avec Hamcrest, écrire des tests avec Cucumber ou écrire des tests avec Playwright.

Dépannage

Si vous rencontrez des problèmes avec l'importation ou l'initialisation d'Axe DevTools, contactez directement votre représentant Deque, joignez-nous via notre service d'assistance, ou envoyez-nous un e-mail. Nous serons heureux de vous aider.