API-Referenz für hamcrest
Referenz für vom hamcrest
Paket bereitgestellte Typen.
Die Klassen IsAccessible
und IsAuditedForAccessibility
stellen die primäre Funktionalität bereit.
com.deque.html.axedevtools.matchers.AxeDevtoolsMatcher erweitert TypeSafeMatcher<AxeDriver>
Base AxeDevToolsMatcher . Unterklassen wie IsAccessible
oder IsAuditedForAccessibility
sollten häufiger verwendet werden.
AxeDevtoolsMatcher within(final String... cssSelectors)
Fügen Sie dem während eines Zugänglichkeitstests überprüften Kontext CSS-Selektoren hinzu.
cssSelectors
: CSS-Selektoren, die den Kontext darstellen.
Gibt AxeDevtoolsMatcher für die Methodenverkettung zurück.
AxeDevtoolsMatcher within(final Selector... selectors)
Fügen Sie Selektoren zum Kontext hinzu, der während eines Zugänglichkeitstests überprüft wird.
selectors
: Selektoren, die den Kontext darstellen.
Gibt AxeDevtoolsMatcher für die Methodenverkettung zurück.
AxeDevtoolsMatcher excluding(final String... cssSelectors)
Schließen Sie CSS-Selektoren aus dem Kontext aus, der während eines Zugänglichkeitstests überprüft wird.
cssSelectors
: CSS-Selektoren, die den Kontext darstellen.
Gibt AxeDevtoolsMatcher für die Methodenverkettung zurück.
AxeDevtoolsMatcher excluding(final Selector... selectors)
Schließen Sie Selektoren aus dem Kontext aus, der während eines Zugänglichkeitstests überprüft wird.
selectors
: Selektoren, die den Kontext darstellen.
Gibt AxeDevtoolsMatcher für die Methodenverkettung zurück.
AxeDevtoolsMatcher accordingTo(final String... tags)
Gemäß den Zugänglichkeits-Tags. Überprüfen Sie nur die angegebenen Zugänglichkeits-Tags. Diese Option ist nicht kompatibel mit checkingOnly
.
Siehe Regelbeschreibungen.
tags
: Liste der zu prüfenden Tags.
Gibt AxeDevtoolsMatcher für die Methodenverkettung zurück.
AxeDevtoolsMatcher checkingOnly(final String... rules)
Es werden nur die Zugänglichkeitsregeln überprüft. Diese Option ist nicht kompatibel mit accordingTo
.
Siehe Regelbeschreibungen.
rules
: Liste der zu prüfenden Regeln.
Gibt AxeDevtoolsMatcher für die Methodenverkettung zurück.
AxeDevtoolsMatcher checking(final String... rules)
Überprüfen Sie die Zugänglichkeitsregeln. Überprüfen Sie neben den vorgegebenen Tags auch bestimmte Regeln. Siehe Regelbeschreibungen.
rules
: Liste der zu prüfenden Regeln.
Gibt AxeDevtoolsMatcher für die Methodenverkettung zurück.
AxeDevtoolsMatcher skipping(final String... rules)
Barrierefreiheitsregeln werden übersprungen. Überspringe innerhalb der angegebenen Tags die Überprüfung bestimmter Regeln. Siehe Regelbeschreibungen.
rules
: Liste der zu prüfenden Regeln.
Gibt AxeDevtoolsMatcher für die Methodenverkettung zurück.
AxeDevtoolsMatcher ignoring(final String selector, final String ruleId)
Ignorieren Sie Verstöße für einen Selektor und eine bestimmte Regel-ID.
selector
: Durch die Axe-Zugänglichkeitsprüfung erstellter Selektor.
ruleId
: Zu ignorierende Regel-ID für den angegebenen Selektor.
Gibt AxeDevtoolsMatcher für die Methodenverkettung zurück.
AxeDevtoolsMatcher forConfig(final URL auditPath)
Stellen Sie eine Audit-Suite über seine URL bereit.
auditPath
: die mit der Audit-Suite verknüpfte URL.
Gibt AxeDevtoolsMatcher für die Methodenverkettung zurück.
AxeDevtoolsMatcher forConfig(final String auditPath) Löst MalformedURLException aus
Stellen Sie eine Audit-Suite anhand seiner Speicherorts im Dateisystem bereit.
auditPath
: Der absolute Dateipfad der Audit-Suite.
Gibt AxeDevtoolsMatcher für die Methodenverkettung zurück.
Wirft MalformedURLException
eine Ausnahme, wenn der Prüfpfad ein ungültiger Dateisystempfad ist.
AxeDevtoolsMatcher logResults(final AxeReportingOptions reportingOptions)
Protokollieren Sie die Ergebnisse der Barrierefreiheitsprüfung nach Abschluss.
reportingOptions
: Optionen, die die Serialisierung und Persistenz der Zugänglichkeitsprüfung definieren.
Gibt AxeDevtoolsMatcher für die Methodenverkettung zurück.
AxeDevtoolsMatcher forRuleset(final String rulesetId)
Geben Sie einen Regelsatz für die Barrierefreiheitsprüfung an. Durch die Konfiguration einer Audit-Suite wird der angegebene Regelsatz geändert. Siehe Regelsätze.
rulesetId
: Die ID des Regelsatzes für die Konfiguration.
Gibt AxeDevtoolsMatcher für die Methodenverkettung zurück.
com.deque.html.axedevtools.matchers.IsAccessible erweitert AxeDevtoolsMatcher
Führen Sie eine Prüfung auf axe-Zugänglichkeit durch.
- Führen Sie eine Barrierefreiheitsprüfung durch:
assertThat(page, isAxeClean())
- Definieren Sie den Kontext mithilfe von: (Überprüfen Sie das gesamte Dokument, indem Sie keines davon verwenden)
within(String...)
within(Selector...)
excluding(String...)
excluding(Selector...)
- Definieren Sie die Optionen mit: (Indem Sie diesen Schritt überspringen, überprüfen Sie alle durch axe standards definierten Regeln.)
accordingTo(String...)
checkingOnly(String...)
checking(String...)
skipping(String...)
- Definieren Sie die Konfiguration Ihrer Audit-Suite: (Verwenden Sie den Standardspeicherort der Audit-Konfiguration, indem Sie diesen Schritt überspringen.)
forConfig(URL)
forConfig(String)
- Definieren Sie die Protokollierungsoptionen für Ihre Konfigurationssuite: (Standardmäßig wird kein Ergebnisprotokoll erstellt)
logResults(AxeReportingOptions)
Zugänglichkeitskontext und -optionen können verkettet werden:
assertThat(axeDevtoolsSelenium, isAxeClean()
.within("#header")
.within("#footer")
.excluding(".graphics")
.accordingTo("wcag2a", "wcag2aa"));
static IsAccessible isAxeClean()
Zugänglichkeit für Webseite sicherstellen. Einzige Möglichkeit, eine IsAxeClean
Instanz zu erhalten.
Gibt einen neuen isAxeClean-Basismatcher zurück.
com.deque.html.axedevtools.matchers.IsAuditedForAccessibility erweitert AxeDevtoolsMatcher
Führen Sie ein Audit zur Barrierefreiheit Ihrer Seite durch. Bei der Prüfung werden Zugänglichkeitsprobleme in target/axe-report/accessibility-check.log protokolliert. und erstellt eine JSON-Ausgabe der Ergebnisse unter target/axe-report/accessibility-check.json.
Dieser Matcher wird niemals eine Assertionsausnahme auslösen. Die Überwachung der Prüfergebnisse auf Regressionen muss bei Verwendung dieses matcher außerhalb der Fehler-/Erfolgsberichte der Testsuite erfolgen.
- Führen Sie ein Zugänglichkeitsaudit durch:
assertThat(page, isAuditedForAccessibility())
- Definieren Sie den Kontext mithilfe von: (Überprüfen Sie das gesamte Dokument, indem Sie keines davon verwenden)
within(String...)
within(Selector...)
excluding(String...)
excluding(Selector...)
- Definieren Sie die Optionen mit: (Indem Sie diesen Schritt überspringen, überprüfen Sie alle durch axe standards definierten Regeln.)
accordingTo(String...)
checkingOnly(String...)
checking(String...)
skipping(String...)
- Definieren Sie die Konfiguration Ihrer Audit-Suite: (Verwenden Sie den Standardspeicherort der Audit-Konfiguration, indem Sie diesen Schritt überspringen.)
forConfig(URL)
forConfig(String)
- Definieren Sie die Protokollierungsoptionen für Ihre Konfigurationssuite: (Standardmäßig wird kein Ergebnisprotokoll erstellt)
logResults(AxeReportingOptions)
Zugänglichkeitskontext und -optionen können verkettet werden:
assertThat(axeDevtoolsSelenium, isAuditedForAccessibility()
.within("#header")
.within("#footer")
.excluding(".graphics")
.accordingTo("wcag2a", "wcag2aa"));
static IsAuditedForAccessibility isAuditedForAccessibility()
Stellen Sie sicher, dass die Barrierefreiheit der Webseite geprüft wird. Einzige Möglichkeit, eine IsAuditedForAccessibility
Instanz zu erhalten.
Gibt einen neuen isAuditedForAccessibility-Basismatcher zurück.
Schnittstelle com.deque.html.axedevtools.matchers.selectors.Selector
Schnittstelle, die von Selektoren implementiert wird.
com.deque.html.axedevtools.matchers.selectors.ElementSelector implementiert Selector
ElementSelector(final String cssSelector)
Erstellen Sie einen Selektor für CSS.
cssSelector
: Ein CSS-Selektor.
com.deque.html.axedevtools.matchers.selectors.IFrameSelector implementiert Selector
IFrameSelector(final String frameSelector, final String cssSelector)
iFrame-Selektor erstellen.
frameSelector
: CSS-Selektor, der die Position des Rahmens auf der Seite darstellt.
cssSelector
: CSS-Selektor, der ein Webelement darstellt, um innerhalb des Rahmens Zugänglichkeitstests durchzuführen.
IFrameSelector(final String frameSelector, final Selector selector)
iFrame-Selektor erstellen.
frameSelector
: CSS-Selektor, der die Position des Rahmens auf der Seite darstellt.
selector
: Ein Selektor, der einen anderen {@link IFrameSelector} darstellt, oder ein {@link ElementSelector}