Riferimento API per hamcrest
Riferimento API per i tipi di matcher Java Hamcrest di Axe DevTools for Web
Riferimento per i tipi forniti dal pacchetto hamcrest.
Le classi IsAccessible e IsAuditedForAccessibility forniscono la funzionalità principale.
com.deque.html.axedevtools.matchers.AxeDevtoolsMatcher estende TypeSafeMatcher<AxeDriver>
Classe base AxeDevToolsMatcher. Dovrebbero essere comunemente usate classi figlie come IsAccessible o IsAuditedForAccessibility.
AxeDevtoolsMatcher within(final String... cssSelectors)
Aggiunge selettori CSS al contesto controllato durante un test di accessibilità.
cssSelectors: Selettori CSS che rappresentano il contesto.
Restituisce AxeDevtoolsMatcher per concatenare i metodi.
AxeDevtoolsMatcher within(final Selector... selectors)
Aggiunge selettori al contesto controllato durante un test di accessibilità.
selectors: Selettori che rappresentano il contesto.
Restituisce AxeDevtoolsMatcher per concatenare i metodi.
AxeDevtoolsMatcher excluding(final String... cssSelectors)
Esclude selettori CSS dal contesto controllato durante un test di accessibilità.
cssSelectors: Selettori CSS che rappresentano il contesto.
Restituisce AxeDevtoolsMatcher per concatenare i metodi.
AxeDevtoolsMatcher excluding(final Selector... selectors)
Esclude selettori dal contesto controllato durante un test di accessibilità.
selectors: Selettori che rappresentano il contesto.
Restituisce AxeDevtoolsMatcher per concatenare i metodi.
AxeDevtoolsMatcher accordingTo(final String... tags)
Secondo i tag di accessibilità. Controlla solo i tag di accessibilità specificati. Questa opzione è incompatibile con checkingOnly.
Vedi Descrizioni delle Regole.
tags: Elenco di tag da controllare.
Restituisce AxeDevtoolsMatcher per concatenare i metodi.
AxeDevtoolsMatcher checkingOnly(final String... rules)
Controlla solo le regole di accessibilità. Questa opzione è incompatibile con accordingTo.
Vedi Descrizioni delle Regole.
rules: Elenco di regole da controllare.
Restituisce AxeDevtoolsMatcher per concatenare i metodi.
AxeDevtoolsMatcher checking(final String... rules)
Controlla le regole di accessibilità. Oltre ai tag forniti, controlla anche alcune regole. Vedi Descrizioni delle Regole.
rules: Elenco di regole da controllare.
Restituisce AxeDevtoolsMatcher per concatenare i metodi.
AxeDevtoolsMatcher skipping(final String... rules)
Salta le regole di accessibilità. All'interno dei tag forniti, si omette il controllo di alcune regole. Vedi Descrizioni delle Regole.
rules: Elenco di regole da controllare.
Restituisce AxeDevtoolsMatcher per concatenare i metodi.
AxeDevtoolsMatcher ignoring(final String selector, final String ruleId)
Ignora violazioni per un selettore e un dato ID di regola.
selector: Selettore prodotto dal controllo di accessibilità axe.
ruleId: ID di regola da ignorare per il dato selettore.
Restituisce AxeDevtoolsMatcher per concatenare i metodi.
AxeDevtoolsMatcher forConfig(final URL auditPath)
Fornisce una suite di audit tramite il suo URL.
auditPath: l'URL associato alla suite di audit.
Restituisce AxeDevtoolsMatcher per concatenare i metodi.
AxeDevtoolsMatcher forConfig(final String auditPath) lancia MalformedURLException
Fornire una suite di audit tramite la sua posizione nel file system.
auditPath: Il percorso assoluto del file della suite di audit.
Restituisce AxeDevtoolsMatcher per concatenare i metodi.
Lancia MalformedURLException se il percorso di audit è un percorso filesystem non valido.
AxeDevtoolsMatcher logResults(final AxeReportingOptions reportingOptions)
Registra i risultati del controllo di accessibilità al termine.
reportingOptions: Opzioni che definiscono la serializzazione e la persistenza del controllo di accessibilità.
Restituisce AxeDevtoolsMatcher per concatenare i metodi.
AxeDevtoolsMatcher forRuleset(final String rulesetId)
Specificare un set di regole per il controllo di accessibilità. Configurare una suite di audit modificherà il set di regole specificato. Vedi Regole.
rulesetId: L'id del set di regole per la configurazione.
Restituisce AxeDevtoolsMatcher per concatenare i metodi.
com.deque.html.axedevtools.matchers.IsAccessible estende AxeDevtoolsMatcher
Esegui un controllo di accessibilità con axe.
- Esegui il controllo di accessibilità:
assertThat(page, isAxeClean())
- Definire il contesto utilizzando: (Controlla l'intero documento non utilizzando nessuno di questi)
within(String...)within(Selector...)excluding(String...)excluding(Selector...)
- Definire le opzioni utilizzando: (Controlla tutte le regole definite da standard di axe saltando questo passaggio)
accordingTo(String...)checkingOnly(String...)checking(String...)skipping(String...)
- Definire la configurazione della tua suite di audit: (Usa la posizione predefinita di configurazione dell'audit saltando questo passaggio)
forConfig(URL)forConfig(String)
- Definire le opzioni di registrazione per la tua suite di configurazione: (Predefinito non produce registri dei risultati)
logResults(AxeReportingOptions)
Il contesto e le opzioni di accessibilità possono essere concatenati:
assertThat(axeDevtoolsSelenium, isAxeClean()
.within("#header")
.within("#footer")
.excluding(".graphics")
.accordingTo("wcag2a", "wcag2aa"));static IsAccessible isAxeClean()
Verifica l'accessibilità della pagina web. Unico modo per ottenere un'istanza di IsAxeClean.
Restituisce un nuovo matcher base isAxeClean.
com.deque.html.axedevtools.matchers.IsAuditedForAccessibility estende AxeDevtoolsMatcher
Esegui un audit sull'accessibilità della tua pagina. L'audit registrerà i problemi di accessibilità in target/axe-report/accessibility-check.log e creerà un output JSON dei risultati in target/axe-report/accessibility-check.json.
Questo matcher non lancerà mai un'eccezione di asserzione. Monitorare i risultati dell'audit per regressioni dovrà essere gestito al di fuori dei fallimenti/successi della suite di test quando si utilizza questo matcher.
- Esegui audit di accessibilità:
assertThat(page, isAuditedForAccessibility())
- Definire il contesto utilizzando: (Controlla l'intero documento non utilizzando nessuno di questi)
within(String...)within(Selector...)excluding(String...)excluding(Selector...)
- Definire le opzioni utilizzando: (Controlla tutte le regole definite da standard di axe saltando questo passaggio)
accordingTo(String...)checkingOnly(String...)checking(String...)skipping(String...)
- Definire la configurazione della tua suite di audit: (Usa la posizione predefinita di configurazione dell'audit saltando questo passaggio)
forConfig(URL)forConfig(String)
- Definire le opzioni di registrazione per la tua suite di configurazione: (Predefinito non produce registri dei risultati)
logResults(AxeReportingOptions)
Il contesto e le opzioni di accessibilità possono essere concatenati:
assertThat(axeDevtoolsSelenium, isAuditedForAccessibility()
.within("#header")
.within("#footer")
.excluding(".graphics")
.accordingTo("wcag2a", "wcag2aa"));static IsAuditedForAccessibility isAuditedForAccessibility()
Verifica che la pagina web sia stata sottoposta ad audit per l'accessibilità. Unico modo per ottenere un'istanza di IsAuditedForAccessibility.
Restituisce un nuovo matcher base isAuditedForAccessibility.
interface com.deque.html.axedevtools.matchers.selectors.Selector
Interfaccia implementata dai selettori.
com.deque.html.axedevtools.matchers.selectors.ElementSelector implementa Selector
ElementSelector(final String cssSelector)
Crea un Selettore per un selettore CSS.
cssSelector: Un selettore CSS.
com.deque.html.axedevtools.matchers.selectors.IFrameSelector implementa Selector
IFrameSelector(final String frameSelector, final String cssSelector)
Crea un selettore iFrame.
frameSelector: Selettore CSS che rappresenta la posizione del frame sulla pagina.
cssSelector: Selettore CSS che rappresenta l'elemento web su cui eseguire i test di accessibilità all'interno del frame.
IFrameSelector(final String frameSelector, final Selector selector)
Crea un selettore iFrame.
frameSelector: Selettore CSS che rappresenta la posizione del frame sulla pagina.
selector: Un Selettore che rappresenta un altro {@link IFrameSelector}, oppure un {@link ElementSelector}
