Importare e inizializzare con Java

Dopo aver installato axe DevTools for Web, è necessario importarlo nel file di test e inizializzare lo strumento insieme al suo driver web.

Prerequisiti

Per poter importare e inizializzare axe DevTools for Web, è necessario prima installarlo. Se non l'hai ancora fatto, leggi la guida su come installarlo da un bundle, dal tuo repository di artefatti o dall'Agora di Deque. È inoltre necessario scaricare e configurare il driver web di tua scelta.

Importazione

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

• Selenium (Scrittura di test con Selenium e Riferimento API Java Selenium)
• Hamcrest (Scrittura di test utilizzando Hamcrest e Riferimento API Hamcrest)
• Cucumber (Scrittura di test con Cucumber)
• Playwright (Utilizzo di Playwright e Riferimento API di Playwright)

Istruzioni di importazione della configurazione Selenium

Per utilizzare axe DevTools con Selenium, segui questa parte della guida. Usa questa configurazione se non si desidera associare axe DevTools a una libreria di asserzioni esistente, ma scrivere invece i propri test. Inoltre, saranno necessarie istruzioni di importazione per il webdriver scelto.

L'unico pacchetto che devi importare è 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, si consigliano altri due pacchetti che consentono di generare e interpretare i risultati. Il pacchetto dei risultati genera un oggetto JSON contenente i risultati della scansione, mentre 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.*;

Istruzioni di importazione Hamcrest

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

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

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

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

Istruzioni di importazione di Cucumber

Per associare axe DevTools a Cucumber è necessario un solo pacchetto di importazione.

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

Dichiarazioni di importazione di Playwright

Per utilizzare l'integrazione Playwright è necessario importare due pacchetti.

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

È inoltre necessario 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;

Initializing (non-Playwright)

Dopo aver aggiunto al file di test le istruzioni di importazione del pacchetto richieste, sarà necessario inizializzare axe DevTools con il suo driver web per eseguire le scansioni di accessibilità. Utilizzando la configurazione standard, questo codice inizializzerà axe DevTools. In questo esempio viene utilizzato ChromeDriver, ma anche altri driver per browser, come GeckoDriver, funzionano altrettanto bene.

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

Inoltre, se hai bisogno di un oggetto di risultati generati e/o di un report, è necessario importare un oggetto Selenium axe, come descritto sopra, e inizializzarlo

AxeSelenium axeSelenium = new AxeSelenium();

Inizializzazione di Playwright

Per inizializzare Playwright, si crea un nuovo oggetto Playwright , lo si usa per creare un nuovo oggetto Browser e infine si usa l'oggetto Browser per creare un oggetto 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/");

Prossimi passi

Dopo aver installato, importato e inizializzato axe DevTools, sei pronto per passare alla scansione dell'accessibilità e alla scrittura dei test di accessibilità. Per farlo, consulta la guida su scrittura di test con Selenium, scrittura di test con Hamcrest, scrittura di test con Cucumber o scrittura di test con Playwright.

Risoluzione dei problemi

In caso di problemi con l'importazione o l'inizializzazione di axe DevTools, contatta direttamente il tuo rappresentante Deque, contattaci tramite il nostro support desk o inviaci un'e-mail. Saremo lieti di aiutarti.