Istruzioni per Java e Playwright

This page is not available in the language you requested. You have been redirected to the English version of the page.

Link to this page copied to clipboard

Configurare i test con Java e Playwright

Not for use with personal data

Aggiungi una nuova dipendenza per il pacchetto Java Watcher alla tua sezione delle dipendenze pom.xml (per Maven) (il pacchetto Java Watcher è disponibile su Maven Central):

<dependencies>

<!-- Add this dependency: -->
  <dependency>
     <groupId>com.deque.axe_core</groupId>
     <artifactId>watcher</artifactId>
     <version>4.4.0</version> <!-- Update this as needed -->
  </dependency>

</dependencies>

Aggiungi gli import per Java Watcher al codice di test:

import com.deque.axe_core.commons.AxeWatcherOptions;
import com.deque.axe_core.playwright.AxeWatcherPlaywright;
import com.deque.axe_core.playwright.AxeWatcherPage;

Aggiungi il codice di configurazione per Java Watcher, inclusi il tuo API key personale e l'ID del progetto (entrambi memorizzati nell'ambiente per sicurezza e flessibilità):
```
AxeWatcherOptions options =
    new AxeWatcherOptions()
        .setApiKey(System.getenv("ACCESSIBILITY_API_KEY"))
        .setProjectId(System.getenv("PROJECT_ID"));
// Optional: uncomment and set SERVER_URL if using a regional, private cloud, or on-premises instance:
// options.setServerUrl(System.getenv("SERVER_URL"));
AxeWatcherPlaywright watcher = new AxeWatcherPlaywright(options);
BrowserType.LaunchPersistentContextOptions launchOptions =
    watcher.configure(new BrowserType.LaunchPersistentContextOptions());
// Watcher requires a persistent context. You must set headless explicitly on Playwright 1.49+:
launchOptions.setHeadless(false);
BrowserContext context = browserType.launchPersistentContext(userDataDir, launchOptions);
AxeWatcherPage page = watcher.wrapPage(context.newPage());
```
important

Watcher richiede un contesto persistente di Playwright. Non è compatibile con i lanci Browser non persistenti. Su Playwright Java 1.49 o versioni successive, devi anche chiamare esplicitamente setHeadless(false) (o setHeadless(true) con setChannel("chrome") o setChannel("chromium")). La modalità di default chromium-headless-shell non è supportata.

Questo frammento di codice crea un'istanza AxeWatcherPage che avvolge il tuo Page di Playwright con il test di accessibilità abilitato.

Per acquisire una schermata ogni volta che vengono trovate violazioni, aggiungi .setTakeScreenshots(true) al tuo AxeWatcherOptions. Per salvare anche le schermate localmente, concatena .setScreenshotDir("./axe-screenshots"). Vedi Acquisire schermate di violazione per ulteriori informazioni.

Assicurati di impostare ACCESSIBILITY_API_KEY e PROJECT_ID nel tuo ambiente con la tua chiave API personale (che si trova nel tuo account Axe, scheda **API KEYS**) e l'ID del tuo progetto (mostrato nella parte superiore di queste istruzioni quando hai creato il tuo progetto o disponibile nella pagina Progetti scegliendo **Configura progetto** sotto **Impostazioni**). Se la tua organizzazione utilizza un'istanza regionale, cloud privato o on-premise di Axe Developer Hub, imposta anche SERVER_URL sull'URL di base di tale istanza (per esempio, https://axe-eu.deque.com); altrimenti, ometti SERVER_URL e verrà utilizzato il https://axe.deque.com predefinito.
Alla fine della tua sessione di test, chiama flush():
```
page.axeWatcher().flush();
```
Chiamare flush() indica che l'esecuzione del test è terminata e i risultati possono essere elaborati e presentati all'utente.

Per attribuire le violazioni a test specifici, chiama setTestContext() prima della logica del tuo test:
```
page.axeWatcher().setTestContext(
    "src/test/java/com/acme/LoginTest.java",
    java.util.Arrays.asList("LoginTest", "rejects bad password")
);
```
Vedi Attribuire le violazioni ai test per ulteriori informazioni.

Istruzioni per Java e Playwright

Is this page helpful?

Help us improve this page

Still need help?