Importer et initialiser avec Java

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

Prérequis

Afin d'importer et d'initialiser axe DevTools for Web, il doit d'abord être installé. Si vous ne l'avez pas encore fait, lisez le guide expliquant comment l'installer à partir d'un bundle, à partir de votre référentiel d'artefacts ou à partir de l'Agora de Deque. Vous avez également besoin d'un Selenium WebDriver téléchargé et configuré de votre choix.

Importation

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

• Selenium (Écriture de tests avec Selenium et Référence de l'API Java Selenium)
• Hamcrest (Écriture de tests avec Hamcrest et Référence API Hamcrest)
• Cucumber (Écriture de tests avec Cucumber)
• Playwright (Utilisation de Playwright et Référence de l'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 écrivez plutôt vos propres tests. De plus, des instructions d'importation seront nécessaires pour le WebDriver de votre choix.

Le seul package qui doit explicitement être importé est le package axe DevTools Selenium. C'est ce qui communique entre axe DevTools et Selenium WebDriver pour exécuter 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 la génération de rapports 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.*;

Déclarations d'importation de Hamcrest

Pour les environnements de test qui utilisent 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 possibilité de définir la portée des analyses par sélecteurs. Pour utiliser cette fonctionnalité, l'importation supplémentaire de ce package est requise.

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

Déclarations d'importation de Cucumber

Afin de coupler axe DevTools avec Cucumber, un seul package d'importation est requis.

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

Déclarations d'importation de 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;

Initializing (non-Playwright)

Une fois les instructions d'importation de package requises ajoutées à votre fichier de test, vous devrez initialiser axe DevTools avec son pilote Web afin d'exécuter 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 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és et/ou d'un rapport, un objet axe Selenium doit être importé, comme décrit ci-dessus, et initialisé

AxeSelenium axeSelenium = new AxeSelenium();

Initialisation de Playwright

Pour initialiser Playwright, vous construisez un nouvel ** objet Playwright** , vous l'utilisez pour créer un nouvel ** objet Browser** et enfin vous utilisez l' objet Browser 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/");

Prochaines étapes

Une fois que vous avez installé, importé et initialisé axe DevTools, vous êtes prêt à passer à la recherche d'accessibilité et à la rédaction de tests d'accessibilité. Pour ce faire, consultez le guide sur l'écriture de tests avec Selenium, l'écriture de tests avec Hamcrest, l'écriture de tests avec Cucumber, ou l'écriture de 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, contactez-nous via notre support desk, ou envoyez-nous un e-mail. Nous serons heureux de vous aider.