Classe ConfigurationOverrides

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

Sovrascrivere le impostazioni di configurazione globale di test di accessibilità axe nei tuoi test Selenium in Java

Not for use with personal data

La classe ConfigurationOverrides ti consente di sovrascrivere le impostazioni globali configurazione di axe per i test di accessibilità con axe Watcher. Puoi utilizzare questa classe per personalizzare gli standard di accessibilità, abilitare le migliori pratiche e le regole sperimentali, e specificare la versione di axe-core da usare durante i test.

Queste sovrascritture hanno la precedenza sulle impostazioni di configurazione globali definite nel tuo Account di axe.

Costruttore

ConfigurationOverrides()

Crea una nuova istanza di ConfigurationOverrides con le impostazioni predefinite (tutte le proprietà impostate su null).

ConfigurationOverrides configOverrides = new ConfigurationOverrides();

Metodi

setEnableBestPractices(boolean enableBestPractices)

Abilita o disabilita regole sulle migliori pratiche durante i test di accessibilità. Le regole sulle migliori pratiche identificano problemi che non sono strettamente richiesti dagli standard di accessibilità, ma che possono migliorare l'esperienza utente.

Parametri:

  • enableBestPractices - Valore booleano che indica se abilitare le regole sulle migliori pratiche

Restituisce:

  • ConfigurationOverrides - L'istanza corrente per il concatenamento di metodi

Esempio:

ConfigurationOverrides configOverrides = new ConfigurationOverrides();
configOverrides.setEnableBestPractices(true);

setEnableExperimental(boolean enableExperimental)

Abilita o disabilita regole sperimentali durante i test di accessibilità. Le regole sperimentali sono regole nuove o instabili che sono ancora in fase di sviluppo.

Parametri:

  • enableExperimental - Valore booleano che indica se abilitare le regole sperimentali

Restituisce:

  • ConfigurationOverrides - L'istanza corrente per il concatenamento di metodi

Esempio:

ConfigurationOverrides configOverrides = new ConfigurationOverrides();
configOverrides.setEnableExperimental(false);

setAccessibilityStandard(AccessibilityStandard standard)

Imposta lo standard di accessibilità da utilizzare per il test. Questo determina quale insieme di regole di accessibilità si applichino durante i test.

Parametri:

  • standard - Un valore enum AccessibilityStandard che specifica lo standard da utilizzare

Restituisce:

  • ConfigurationOverrides - L'istanza corrente per il concatenamento di metodi

Esempio:

ConfigurationOverrides configOverrides = new ConfigurationOverrides();
configOverrides.setAccessibilityStandard(ConfigurationOverrides.AccessibilityStandard.WCAG22AA);

setAxeCoreVersion(String axeCoreVersion)

Imposta la versione di axe-core da utilizzare per i test. Questo ti consente di specificare una versione specifica o utilizzare l'ultima versione.

Parametri:

  • axeCoreVersion - La stringa di versione di axe-core da utilizzare (es., "4.6.0" o "latest")

Restituisce:

  • ConfigurationOverrides - L'istanza corrente per il concatenamento di metodi

Esempio:

ConfigurationOverrides configOverrides = new ConfigurationOverrides();
configOverrides.setAxeCoreVersion("4.7.0");

getEnableBestPractices()

Ottiene l'impostazione corrente per l'abilitazione delle regole sulle migliori pratiche.

Restituisce:

  • Boolean - L'impostazione corrente per l'abilitazione delle regole sulle migliori pratiche

Esempio:

ConfigurationOverrides configOverrides = new ConfigurationOverrides();
configOverrides.setEnableBestPractices(true);
Boolean enableBestPractices = configOverrides.getEnableBestPractices(); // Returns true

getEnableExperimental()

Ottiene l'impostazione corrente per l'abilitazione delle regole sperimentali.

Restituisce:

  • Boolean - L'impostazione corrente per l'abilitazione delle regole sperimentali

Esempio:

ConfigurationOverrides configOverrides = new ConfigurationOverrides();
configOverrides.setEnableExperimental(false);
Boolean enableExperimental = configOverrides.getEnableExperimental(); // Returns false

getAccessibilityStandard()

Ottiene la corrente impostazione dello standard di accessibilità.

Restituisce:

  • String - L'impostazione corrente dello standard di accessibilità

Esempio:

ConfigurationOverrides configOverrides = new ConfigurationOverrides();
configOverrides.setAccessibilityStandard(ConfigurationOverrides.AccessibilityStandard.WCAG21AA);
String standard = configOverrides.getAccessibilityStandard(); // Returns "WCAG 2.1 AA"

getAxeCoreVersion()

Ottiene la versione corrente di axe-core.

Restituisce:

  • String - La versione corrente di axe-core

Esempio:

ConfigurationOverrides configOverrides = new ConfigurationOverrides();
configOverrides.setAxeCoreVersion("4.7.0");
String version = configOverrides.getAxeCoreVersion(); // Returns "4.7.0"

toJson()

Converte l'istanza ConfigurationOverrides in una stringa JSON.

Ritorna:

  • String - Una rappresentazione in stringa JSON delle configurazioni sovrascritte

Esempio:

ConfigurationOverrides configOverrides = new ConfigurationOverrides()
    .setEnableBestPractices(true)
    .setAccessibilityStandard(ConfigurationOverrides.AccessibilityStandard.WCAG22AA);
String json = configOverrides.toJson();
// Returns: {"best_practices":true,"experimental_rules":null,"accessibility_standard":"WCAG 2.2 AA","axe_core_version":null}

Enum dei Standard di Accessibilità

La classe ConfigurationOverrides include un enum AccessibilityStandard che definisce gli standard di accessibilità disponibili:

Valori Enum

  • WCAG2A - WCAG 2.0 Livello A
  • WCAG2AA - WCAG 2.0 Livello AA
  • WCAG2AAA - WCAG 2.0 Livello AAA
  • WCAG21A - WCAG 2.1 Livello A
  • WCAG21AA - WCAG 2.1 Livello AA
  • WCAG21AAA - WCAG 2.1 Livello AAA
  • WCAG22A - WCAG 2.2 Livello A
  • WCAG22AA - WCAG 2.2 Livello AA
  • WCAG22AAA - WCAG 2.2 Livello AAA
  • TTV5 - Tester Affidabile v5
  • EN301549 - EN 301 549
  • RGAAV4 - RGAA versione 4 (standard di accessibilità francese; richiede axe-core 4.11.0 o successivo)
  • ALL - Tutti gli standard

Esempio:

ConfigurationOverrides configOverrides = new ConfigurationOverrides();

// Set to WCAG 2.2 Level AA
configOverrides.setAccessibilityStandard(ConfigurationOverrides.AccessibilityStandard.WCAG22AA);

// Set to Trusted Tester v5
configOverrides.setAccessibilityStandard(ConfigurationOverrides.AccessibilityStandard.TTV5);

// Set to all standards
configOverrides.setAccessibilityStandard(ConfigurationOverrides.AccessibilityStandard.ALL);

Note Importanti

  1. Impostazioni Mutuamente Esclusive: Non puoi usare contemporaneamente sia configurationOverrides.accessibilityStandard che runOptions.runOnly.

  2. Proprietà Null: Tutte le proprietà in ConfigurationOverrides predefiniscono a null. Quando una proprietà è null, viene utilizzata la configurazione globale da axe Developer Hub.

  3. Precedenza: Le sovrascritture delle configurazioni hanno la precedenza sulle impostazioni globali nel tuo account axe, permettendoti di personalizzare i test per suite o esecuzioni specifiche.

  4. Serializzazione: Il metodo toJson() include i valori null nell'output, rendendo la struttura JSON coerente indipendentemente dalle proprietà impostate.

Vedi Anche

Is this page helpful?

Help us improve this page

Still need help?