JarCasting
JarCasting JarCasting

aXe Selenium Integration

Tools for using aXe for web accessibility testing with JUnit and Selenium.

License

License
GroupId

GroupId

com.deque
ArtifactId

ArtifactId

axe-selenium
Last Version

Last Version

3.0
Release Date

Release Date
Type

Type

jar
Description

Description

aXe Selenium Integration
Tools for using aXe for web accessibility testing with JUnit and Selenium.
Project URL

Project URL

https://github.com/dequelabs/axe-selenium-java
Source Code Management

Source Code Management

https://github.com/dequelabs/axe-selenium-java

Download axe-selenium

Filename Size
axe-selenium-3.0.pom
axe-selenium-3.0.jar 7 KB
axe-selenium-3.0-sources.jar 3 KB
axe-selenium-3.0-javadoc.jar 26 KB
Browse

How to add to project

<!-- https://jarcasting.com/artifacts/com.deque/axe-selenium/ -->
<dependency>
    <groupId>com.deque</groupId>
    <artifactId>axe-selenium</artifactId>
    <version>3.0</version>
</dependency>
// https://jarcasting.com/artifacts/com.deque/axe-selenium/
implementation 'com.deque:axe-selenium:3.0'
// https://jarcasting.com/artifacts/com.deque/axe-selenium/
implementation ("com.deque:axe-selenium:3.0")
'com.deque:axe-selenium:jar:3.0'
<dependency org="com.deque" name="axe-selenium" rev="3.0">
  <artifact name="axe-selenium" type="jar" />
</dependency>
@Grapes(
@Grab(group='com.deque', module='axe-selenium', version='3.0')
)
libraryDependencies += "com.deque" % "axe-selenium" % "3.0"
[com.deque/axe-selenium "3.0"]

Dependencies

compile (3)

Group / Artifact Type Version
org.seleniumhq.selenium : selenium-java jar 3.8.1
org.json : json jar 20160212
org.apache.commons : commons-lang3 jar 3.4

test (1)

Group / Artifact Type Version
junit : junit jar 4.12

Project Modules

There are no modules declared in this project.

[DEPRECATED] aXe Selenium (Java) Integration

No Maintenance Intended

This repository has been deprecated. The package has been moved to axe-core-maven-html.

CircleCI

This example demonstrates how to use aXe to run web accessibility tests in Java projects with the Selenium browser automation tool and Java development tools.

Selenium integration enables testing of full pages and sites.

Requirements

To run the example

  1. Move to the selenium-java directory.
  2. Ensure that axe.min.js is located in /src/test/resources.
  3. node src/test/resources/test-app.js to start the fixture server.
  4. mvn test to build and run the JUnit tests that drive Selenium against the fixture.

This should launch an automated Firefox window, load and analyze the configured web pages, and then pass/fail a JUnit test depending on whether there are any accessibility violations detected.

To modify the example

To run the example tests on your own web page, change the URL passed to driver.get in ExampleTest.setUp().

To use the AXE helper library in your own tests

Include this library as a test-scoped dependency in your POM. Ensure the version matches the one in [pom.xml](./pom.xml):

<dependency>
  <groupId>com.deque</groupId>
  <artifactId>axe-selenium</artifactId>
  <version>3.0</version>
  <scope>test</scope>
</dependency>

axe.js or axe.min.js must be available to your test fixtures as a java.net.URL. The simplest way to do this is to include it in your own src.test.resources and pass MyTest.class.getResource("/axe.min.js") to the Builder constructor as demonstrated in the ExampleTest.

The AXE helper defines three public methods and a nested Builder class for your unit tests.

  • inject will inject the required script into the page under test and any iframes. This only needs to be run against a given page once, and Builder will take care of it for you if you use that.
  • report will pretty-print a list of violations.
  • writeResults will write the JSON violations list out to a file with the specified name in the current working directory.

The Builder class allows tests to chain configuration and analyze pages. The constructor takes in a WebDriver that has already navigated to the page under test and a java.net.URL pointing to the aXe script; from there, you can set options(), include() and exclude() selectors, skipFrames(), and finally, analyze() the page.

  • options wires a JSON string to aXe, allowing rules to be toggled on or off. See the testAccessibilityWithOptions unit test for a sample single-rule execution, and the axe-core API documentation for full documentation on the options object. The runOnly option with tags may be of particular interest, allowing aXe to execute all rules with the specified tag(s).
  • include adds to the list of included selectors. If you do not call include at all, aXe will run against the entire document.
  • exclude adds to the list of excluded selectors. Exclusions allow you to focus scope exactly where you need it, ignoring child elements you don't want to test.
  • skipFrames prevents aXe to be recursively injected into all iframes.
  • analyze executes aXe with any configuration you have previously defined. If you want to test a single WebElement, you may pass it into analyze instead of using include and exclude.

The aXe documentation should be consulted for more details on customizing and analyzing calls to axe.run.

Contributing

In order to contribute, you must accept the contributor licence agreement (CLA). Acceptance of this agreement will be checked automatically and pull requests without a CLA cannot be merged.

Deployment (Maintainers Only)

This package is deployed to Maven Central via OSSRH. To deploy this package, follow these instructions on StackOverflow.

Additionally add your OSSRH credentials to your ~/.m2/settings.xml file as such:

<servers>
  <server>
    <id>ossrh</id>
    <username>YOUR_OSSRH_JIRA_USERNAME</username>
    <password>YOUR_OSSRH_JIRA_PASSWORD</password>
  </server>
</servers>
com.deque

Deque Systems Inc.

Build More Accessible Experiences Today

Versions

Version
3.0
2.1
2.0
1.1
1.0