Importazione e Inizializzazione con Java

Dopo aver installato Axe DevTools per il Web, è necessario importarlo nel file di test e inizializzare lo strumento insieme al suo webdriver.

Prerequisiti

Per importare e inizializzare Axe DevTools per il Web, deve essere prima installato. Se non lo avete ancora fatto, leggete la guida su come installarlo da un pacchetto, dal tuo repository di artefatti, o da Deque's Agora. Avrete anche bisogno di un Selenium WebDriver scaricato e configurato a vostra scelta.

Importazione

Per utilizzare Axe DevTools è necessario importare diversi pacchetti. A seconda della vostra configurazione, questi pacchetti possono variare. Deque offre quattro integrazioni Java:

• Selenium (Scrivere Test con Selenium e Riferimento API Java Selenium)
• Hamcrest (Scrivere Test con Hamcrest e Riferimento API Hamcrest)
• Cucumber (Scrivere Test con Cucumber)
• Playwright (Utilizzo di Playwright e Riferimento API Playwright)

Importare le Dichiarazioni di Configurazione di Selenium

Per utilizzare Axe DevTools con Selenium seguite questa parte della guida. Usate questa configurazione se non state integrando Axe DevTools con una libreria di asserzioni esistente e invece scrivete i vostri test. Inoltre, saranno necessarie le dichiarazioni di importazione per il webdriver di vostra scelta.

L'unico pacchetto che deve essere importato esplicitamente è il pacchetto Axe DevTools Selenium. Questo è ciò che comunica tra Axe DevTools e Selenium WebDriver per eseguire le scansioni.

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

Per questa configurazione, sono raccomandati altri due pacchetti che consentono di generare e interpretare i risultati. Il pacchetto results genera un oggetto JSON contenente i risultati della scansione, e il pacchetto reporter consente la generazione di report HTML, JUnit XML o CSV dei risultati della scansione.

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

Importare le Dichiarazioni di Hamcrest

Per ambienti di test che utilizzano Hamcrest, ci sono solo due pacchetti che devono essere importati. Il primo pacchetto contiene tutto il necessario per scansioni standard.

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

Il secondo pacchetto aggiunge la capacità di delimitare le scansioni tramite selettori. Per utilizzare questa funzionalità, è richiesta l'importazione aggiuntiva di questo pacchetto.

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

Importare le Dichiarazioni di Cucumber

Per accoppiare Axe DevTools con Cucumber, è richiesto solo un pacchetto di importazione.

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

Importare le Dichiarazioni di Playwright

È necessario importare due pacchetti per utilizzare l'integrazione di Playwright.

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

Devi anche importare i pacchetti Playwright di Microsoft.

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

Inizializzazione (escluso Playwright)

Dopo aver aggiunto le dichiarazioni di importazione dei pacchetti richiesti al tuo file di test, dovrai inizializzare Axe DevTools con il suo web driver per eseguire scansioni di accessibilità. Utilizzando la configurazione standard, questo codice inizializzerà Axe DevTools. Questo esempio usa ChromeDriver, ma altri driver di browser come GeckoDriver funzionano altrettanto bene.

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

Inoltre, se hai bisogno di un oggetto risultati generato e/o di un report, deve essere importato un oggetto axe Selenium, come descritto sopra, e inizializzato

AxeSelenium axeSelenium = new AxeSelenium();

Inizializzazione di Playwright

Per inizializzare Playwright, costruisci un nuovo oggetto Playwright, usalo per creare un nuovo oggetto Browser, e infine utilizza l'oggetto Browser per creare un oggetto Pagina.

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/");

Prossimi Passi

Una volta installato, importato e inizializzato Axe DevTools, sei pronto per passare alla scansione per l'accessibilità e scrivere test di accessibilità. Per fare ciò, consulta la guida su scrivere test con Selenium, scrivere test con Hamcrest, scrivere test con Cucumber, o scrivere test con Playwright.

Risoluzione dei Problemi

Se hai problemi con l'importazione o l'inizializzazione di Axe DevTools, contatta direttamente il tuo rappresentante Deque, raggiungici tramite il nostro supporto tecnico o inviaci un'email. Saremo felici di aiutarti.