Installazione

Axe Watcher integra i test di accessibilità nei tuoi attuali pacchetti di test end-to-end. Questa guida copre l'installazione per entrambe le versioni del pacchetto: JavaScript/TypeScript e Java.

Requisiti di sistema

Prima di installare Axe Watcher, assicurati che il tuo ambiente soddisfi questi requisiti:

• Supporto linguistico: I tuoi test devono essere scritti in JavaScript, TypeScript o Java.

• Node.js (solo JavaScript/TypeScript): Utilizza una versione attualmente mantenuta con supporto a lungo termine (LTS) di Node.js.

• Java (solo Java): Utilizza una versione attualmente mantenuta con supporto a lungo termine (LTS) di Java.

• Versioni delle piattaforme di automazione browser: Axe Watcher supporta l'ultima versione o la versione principale precedente di ciascuna piattaforma supportata (eccetto per Playwright e Playwright Test, che è la versione minore e successive).

• Browser: Watcher utilizza l'ultima versione stabile di Chrome per Test o Chromium (con JavaScript/TypeScript o Java con Playwright, puoi anche usare Microsoft Edge). Nota che il browser Electron integrato di Cypress non è compatibile con Watcher, e dovrai avviare Cypress con cypress run --browser chrome-for-testing --headless, cypress run --browser chromium --headless o cypress run --browser edge --headless.

• Accesso al registro npm (solo JavaScript/TypeScript): Il tuo ambiente deve avere il permesso di scaricare e installare pacchetti da Il registro npm.

• Accesso al repository Maven Central (solo Java): Il tuo ambiente deve avere il permesso di scaricare e installare pacchetti da Maven Central.

• Repository Git (opzionale ma consigliato): Usare Git ti consente di associare i risultati di accessibilità a commit specifici e monitorare nel tempo i progressi di accessibilità del tuo progetto.

Installazione JavaScript e TypeScript

Il pacchetto @axe-core/watcher è disponibile su npm. Installalo nella directory principale della tua cartella dei test utilizzando il tuo gestore di pacchetti preferito:

npm install --save-dev @axe-core/watcher

Oppure con yarn:

yarn add --dev @axe-core/watcher

Oppure con pnpm:

pnpm add --save-dev @axe-core/watcher

Piattaforme supportate

Il pacchetto JavaScript/TypeScript supporta queste piattaforme di automazione browser (versione attuale e una versione principale indietro):

• Cypress (incluso il testing dei componenti)
• Playwright (versione minore precedente e successive sono supportate)
• Playwright Test (versione minore precedente e successive sono supportate)
• Puppeteer
• WebdriverIO
• WebdriverIO Testrunner
• WebDriverJS (Selenium)

Dopo l'installazione, segui le istruzioni specifiche del framework JavaScript o TypeScript nella documentazione di Axe Watcher per configurare il tuo pacchetto di test.

Installazione Java

Il pacchetto Java Watcher è disponibile su Maven Central. Aggiungi la dipendenza al tuo pom.xml:

<dependencies>
  <dependency>
    <groupId>com.deque.axe_core</groupId>
    <artifactId>watcher</artifactId>
    <version>4.0.0</version>
  </dependency>
</dependencies>

Aggiorna il numero di versione secondo necessità per utilizzare l'ultima release. Ulteriori informazioni sulle versioni disponibili del pacchetto possono essere trovate su Maven Central.

Piattaforme supportate

Il pacchetto Java supporta Selenium WebDriver (la versione attuale e la versione principale precedente).

Prossimi passaggi

Una volta installato il pacchetto, dovrai:

1. Crea un progetto in Axe Developer Hub per ottenere l'ID del tuo progetto
2. Modifica il tuo pacchetto di test secondo le istruzioni per il tuo framework di test specifico
3. Imposta i tuoi ACCESSIBILITY_API_KEY e PROJECT_ID come variabili d'ambiente
4. Esegui i tuoi test e visualizza i risultati in Axe Developer Hub

Per istruzioni dettagliate sull'impostazione specifiche del tuo framework di test, consulta le pagine di documentazione specifiche per il framework.