API-referentie voor Selenium

Dit document is een referentie voor typen die worden geleverd door het selenium-pakket. De AxeSelenium-klasse moet de meeste gevallen dekken, en AxeConfiguration zou de rest moeten dekken.

com.deque.html.axedevtools.selenium.AxeSelenium

Configureert hoe axe wordt uitgevoerd en voert axe daadwerkelijk uit.

Results = new AxeSelenium()
    .include(".my-css-class")
    .skipping("aria-required-parent")
    .run(driver);

AxeSelenium()

Maak een nieuwe AxeSelenium-toegankelijkheidscontrole voor een AxeDriver.

AxeSelenium(finale AxeBuilder axeBuilder, finale AxeConfiguration axeConfiguration, finale ResultsFilter resultsFilter, finale AxeDevtoolsReporter reporter)

Maak een nieuwe AxeSelenium-toegankelijkheidscontrole voor een AxeDriver.

Resultaten run(finale AxeDriver page)

Voer axe uit op de pagina met behulp van axe.run.

page: AxeDevTools Driver die de pagina vertegenwoordigt waarop een a11y-check moet worden uitgevoerd.

Geeft een resultaatsdocument terug.

AxeSelenium include(finale String cssSelector)

Voeg een selector toe.

cssSelector: Elke geldige CSS-selector.

Geeft AxeSelenium terug voor method chaining.

AxeSelenium include(finale List<String> selector)

Voeg een iFrame-selector toe.

selector: Een lijst met geneste iFrame-selectors. Elke selector vertegenwoordigt een CSS-selector voor een niveau van nesting. De laatste vertegenwoordigt een CSS-selector voor het web-element binnen het binnenste iFrame voor controle.

Geeft AxeSelenium terug voor method chaining.

AxeSelenium exclude(finale String cssSelector)

Sluit een selector uit.

cssSelector: Elke geldige CSS-selector. Geeft AxeSelenium terug voor method chaining.

AxeSelenium exclude(finale List<String> selector)

Sluit een selector uit.

selector: Een lijst met geneste iFrame-selectors. Elke selector vertegenwoordigt een CSS-selector voor een niveau van nesting. De laatste vertegenwoordigt een CSS-selector voor het web-element binnen het binnenste iFrame voor controle.

Geeft AxeSelenium terug voor method chaining.

AxeSelenium volgens(finale String... tags)

Volgens toegankelijkheidstags. Controleer alleen de gespecificeerde toegankelijkheidstags. Deze optie is niet compatibel met AxeSelenium::checkingOnly Zie Regelbeschrijvingen.

tags: Lijst van tags voor controle.

Geeft AxeSelenium terug voor method chaining.

AxeSelenium controlesAlleen(finale String... regels)

Controleert alleen toegankelijkheidsregels. Deze optie is niet compatibel met AxeSelenium::accordingTo Zie Regelbeschrijvingen.

rules: Lijst van regels voor controle.

Geeft AxeSelenium terug voor method chaining.

AxeSelenium controle(finale String... regels)

Controleer toegankelijkheidsregels. Naast de opgegeven tags controleer ook bepaalde regels. Zie Regelbeschrijvingen.

rules: Lijst van regels voor controle.

Geeft AxeSelenium terug voor method chaining.

AxeSelenium overslaan(finale String... regels)

Slaat toegankelijkheidsregels over. Binnen de gegeven tags, sla de controle van bepaalde regels over. Zie Regelbeschrijvingen.

rules: Lijst van regels voor controle.

Geeft AxeSelenium terug voor method chaining.

AxeSelenium voorConfig(finale URL auditConfigPath)

Bied een auditsuite aan via de URL.

auditConfigPath: de URL die is gekoppeld aan de auditsuite.

Retourneert AxeSelenium voor method chaining.

AxeSelenium forConfig(final String auditConfigPath) throws MalformedURLException

Voorzie een auditsuite door de locatie op het bestandssysteem op te geven.

auditConfigPath: Het absolute bestandspad van de auditsuite.

Retourneert AxeSelenium voor method chaining.

Werpt MalformedURLException als het auditpad een ongeldig bestandspad is.

AxeSelenium forRuleset(final String rulesetId)

Specificeer een regelset voor de toegankelijkheidscontrole. Het configureren van een auditsuite zal de gespecificeerde regelset wijzigen. Zie Regelsets.

rulesetId: De id van de regelset voor configuratie.

Retourneert AxeSelenium voor method chaining.

AxeSelenium forRuleset(final String rulesetId, final boolean enableBestPractices)

Specificeer een regelset voor de toegankelijkheidscontrole. Het configureren van een auditsuite zal de gespecificeerde regelset wijzigen. Zie Regelsets.

rulesetId: De id van de regelset voor configuratie.

enableBestPractices: Of "best-practice" regels moeten worden ingeschakeld of niet.

AxeSelenium: voor method chaining.

AxeSelenium ignoring(final String selector, final String ruleId)

Negeer overtredingen voor een selector en een opgegeven regel-id.

selector: Selector geproduceerd door Axe DevTools Accessibility/Audit suite.

ruleId: Regel-ID die genegeerd moet worden voor de gegeven selector.

Retourneert AxeSelenium voor method chaining.

AxeSelenium logResults(final AxeReportingOptions reportingOptions)

Log de resultaten van de toegankelijkheidscontrole bij voltooiing.

reportingOptions: Opties die de serialisatie en opslag van de toegankelijkheidscontrole definiëren. Retourneert AxeSelenium voor method chaining.

boolean loggingConfigured()

Of loggen is geconfigureerd of niet.

Retourneert Of loggen is geconfigureerd of niet.

com.deque.html.axedevtools.selenium.AxeDriver

Interacteer met een pagina met AxeDriver.

Omvat selenium web driver om specifieke functionaliteit van axe-DevTools te bieden.

AxeDriver(final WebDriver webDriver)

Maak een AxeDriver van een Selenium WebDriver.

webDriver: Een Selenium WebDriver voor de pagina die gecontroleerd moet worden.

com.deque.html.axedevtools.selenium.AxeConfiguration

Configureer axe-script eigenschappen zoals bestandslocatie en configuratie. Singleton-klasse, gebruik AxeConfiguration.configure() om toegang te krijgen.

// Code runs once before any tests are run
public void setupOnce() {
  AxeConfiguration.configure()
    .withAxeScript(axeURL)
    .forAuditPath(auditURL)
    .forRuleset("508")
    .outputDirectory("my-axe-results");
}

static AxeConfiguration configure()

Configureer een axe toegankelijkheidscontrole. De enige manier om een AxeConfiguration exemplaar te verkrijgen.

Retourneert Een configuratie-object om de auditsuite globaal te configureren.

static void reset()

Herstelt naar standaardvoorkeuren.

AxeConfiguration forAuditSuite(final URL auditConfigPath)

Voorzie een auditsuite door de URL op te geven.

auditConfigPath: de URL die is gekoppeld aan de auditsuite.

Retourneert AxeConfiguration voor method chaining.

AxeConfiguration voorAuditSuite(final String auditConfigPath) throws MalformedURLException

Biedt een auditsuite aan door de locatie ervan op het bestandssysteem te specificeren.

auditConfigPath: Het absolute bestandspad van de auditsuite.

Geeft AxeConfiguration terug voor method chaining.

GeeftMalformedURLException als het auditpad een ongeldig bestandssysteem pad is.

AxeConfiguration metAxeScript(URL axeScript)

Biedt een axe-core script aan dat gebruikt zal worden voor het uitvoeren van de toegankelijkheidscontrole.

axeScript: De URL die hoort bij het axe-core script dat gebruikt zal worden voor de toegankelijkheidscontrole.

Geeft AxeConfiguration terug voor method chaining.

AxeConfiguration voorRuleset(final String rulesetId)

Kies welke regels die uitgevoerd moeten worden

rulesetId: Eén van:

• wcag2
• wcag2.1
• wcag2.2
• wcag2aaa
• wcag2.1aaa
• wcag2.2aaa
• 508
• ttv5
• en301549
• rgaav4

Geeft AxeConfiguration terug voor method chaining.

AxeConfiguration voorRuleset(final String rulesetId, final boolean enableBestPractices)

Kies welke regels die uitgevoerd moeten worden

rulesetId: Zieboven voor mogelijke waarden.

enableBestPractices: Of de "best-practice" regels aan- of uitgezet moeten worden.

Geeft AxeConfiguration terug voor method chaining.

String getTestSuiteName()

Haalt de naam van de testsuite op.

Geeft de naam van de testsuite terug.

AxeConfiguration testSuiteName(final String testSuiteName)

Stelt de naam van de testsuite in. Gebruikt bij het genereren van rapporten.

testSuiteName: De naam van de testsuite.

Geeft AxeConfiguration terug voor method chaining.

String getOutputDirectory()

Haalt de rapportuitvoermap op.

Geeft het pad van de uitvoermap terug.

AxeConfiguration outputDirectory(final String outputDirectory)

Stelt de map in waar rapporten in opgeslagen worden.

outputDirectory: Het pad naar de map.

Geeft AxeConfiguration terug voor method chaining.

String getUserAgent()

Haalt de waarde op die gebruikt wordt als user-agent.

Geeft de user-agent terug die gebruikt wordt bij het genereren van rapporten.

AxeConfiguration userAgent(final String userAgent)

Stelt de waarde in die wordt gebruikt als user-agent bij het genereren van een rapport. Dit beïnvloedt niet de daadwerkelijke user-agent die wordt gebruikt bij het draaien van axe.

userAgent: De waarde van de user-agent.

Geeft AxeConfiguration terug voor method chaining.

String getTestMachine()

Haalt de naam van de testmachine op.

Geeft de naam van de testmachine terug.

AxeConfiguration testMachine(final String testMachine)

Stelt de naam van de testmachine in. Gebruikt bij het genereren van rapporten.

testMachine: De naam van de testmachine.

Geeft AxeConfiguration terug voor method chaining.

com.deque.html.axedevtools.selenium.results.IgnoredViolation

IgnoredViolation(final String cssSelector, final String ruleId)

Maak een te negeren overtreding aan.

cssSelector: Selector van de node om te negeren. Vergelijkt met het doel van elke node.

ruleId: ID van de regel om te negeren

com.deque.html.axedevtools.selenium.reporter.AxeReportingOptions implements ReportingOptions

Configureert rapportageopties. Neemt standaarden uit AxeConfiguration over.

AxeReportingOptions()

Creëert een AxeReportingOptions

static AxeReportingOptions defaultAuditReportingOptions()

Haalt de standaardopties op.

Geeft een object met standaardopties terug.

String getSuiteTestName()

Haalt de geconfigureerde naam van de testsuite op.

Geeft de naam terug.

AxeReportingOptions testSuiteName(final String testSuiteName)

Beschrijft de testsuite.

testSuiteName: Naam van de testsuite.

Geeft ReportingOptions terug voor method chaining.

String getUiState()

Haalt de geconfigureerde UI-status op.

Geeft de status terug.

AxeReportingOptions uiState(final String uiState)

Beschrijft de status van de UI tijdens de toegankelijkheidscontrole.

uiState: Status van de UI.

Geeft ReportingOptions terug voor method chaining.

String getOutputDirectory()

Haalt de geconfigureerde uitvoermap op.

Geeft de map terug.

AxeReportingOptions outputDirectory(final String outputDirectory)

Stel de root uitvoermap in om het toegankelijkheidsrapport te genereren.

outputDirectory: Directory pad.

Geeft ReportingOptions terug voor method chaining.

String getFileName()

Berekende bestandsnaam van geconfigureerde waarden.

Geeft de bestandsnaam terug.

String getFilePath(final String extension)

Berekent het bestandspad van geconfigureerde waarden.

Geeft het pad terug.

String getUserAgent()

Haalt de geconfigureerde user agent op.

Geeft de user agent terug.

AxeReportingOptions userAgent(final String userAgent)

Beschrijf de user agent die gebruikt wordt om de toegankelijkheidstest uit te voeren.

userAgent: Naam van de user agent.

Geeft ReportingOptions terug voor method chaining.

String getTestMachine()

Haalt de geconfigureerde testmachine op.

Geeft de testmachine terug.

AxeReportingOptions testMachine(final String testMachine)

Beschrijf de machine die gebruikt wordt om de toegankelijkheidstest uit te voeren.

testMachine: Naam van de machine.

Geeft ReportingOptions terug voor method chaining.

AxeReportingOptions lineNum(final String lineNum)

Specificeer het regelnummer van de huidige test.

lineNum: Regelnummer van de huidige test.

Geeft ReportingOptions terug voor method chaining.

ReportingOptions lineNumIfEmpty(final String lineNum)

Specificeer het regelnummer, als het nog niet is ingesteld.

lineNum: Regelnummer van de huidige test.

Geeft ReportingOptions terug voor method chaining.

com.deque.html.axedevtools.selenium.reporter.MissingUIStateException

Uitzondering voor wanneer de UI-status ontbreekt.

com.deque.html.axedevtools.selenium.results.ResultsFilter

Stelt overtredingen in die genegeerd moeten worden.

ResultsFilter filter = new ResultsFilter()
    .ignoring(".third-party-iframe", "label");
Results results = new AxeSelenium(axe, configuration, filter, reporter)
    .run(driver);

Results filterIgnoredViolations(final Results results)

Filter resultaten om genegeerde overtredingen te verwijderen.

results: Te filteren resultaten.

Geeft binnenkomende resultaten terug, gefilterd voor genegeerde CSS Selectors + Regel-ID's.

ResultsFilter ignoring(final String cssSelector, final String ruleId)

Voeg een genegeerde overtreding toe.

cssSelector: CSS-selector geproduceerd door het uitvoeren van de Toegankelijkheid / Audit suite.

ruleId: Regel-ID geproduceerd door het uitvoeren van de Toegankelijkheid / Audit suite.

Geeft ResultsFilter terug voor method chaining.

com.deque.html.axedevtools.reporter.AxeDevtoolsReporter

Configureer rapportageopties bij gebruik van hamcrest matchers.

AxeDevtoolsReporter reporter = new AxeDevtoolsReporter();
assertThat(axeDevtoolsSelenium, isAxeClean(axeSelenium, reporter));

AxeDevtoolsReporter()

Maak een AxeDevtoolsReporter aan.

String generateReport(final Results results, final String executedCommand)

Creëer een stringrepresentatie van de toegankelijkheidscontrole.

results: Resultaten van de auditcontrole.

executedCommand: Uitgevoerde opdracht om auditresultaten te produceren.

Geeft een leesbaar rapport van gevonden toegankelijkheidsovertredingen terug.

void report(final ReportingOptions reportingOptions, final Results results, final String executedCommand)

Rapporteer over de toegankelijkheidscontrole. Voeg rapport toe aan resultaatlogbestand per datum. Bewaar volledige resultaten als JSON-bestand.

reportingOptions: Opties voor het loggen van het rapport.

results: Resultaten van de auditcontrole.

executedCommand: Uitgevoerde opdracht om auditresultaten te produceren.

com.deque.html.axedevtools.reporter.TestResultsGenerator

Genereert een TestResults van een Results en ReportingOptions. Gebruikt met de AxeDevtoolsReporter

TestResults generate(final ReportingOptions reportingOptions, final Results results)

Genereert de {@link TestResults}.

reportingOptions: Opties waarmee we onze resultaten creëren.

results: Resultaten van het uitvoeren van axe.

Retourneert De test

com.deque.html.axedevtools.reporter.ViolationsReporter

Rapporteert alleen overtredingen.

com.deque.html.axedevtools.utils.FileUtils

Bestandshulpprogramma's voor intern gebruik.