Skip to main content

pytest plugin for axe-selenium-python

Project description

pytest-axe provides a variety of features to simplify accessibility testing using axe-selenium-python.

License PyPI Issues


You will need the following prerequisites in order to use pytest-axe:


  • pytest-selenium >= 3.0.0

pytest-selenium is required to use the axe pytest fixture.

  • PyPOM >= 1.3.0

PyPOM is required to use the run_axe helper method.


To install pytest-axe:

$ pip install pytest-axe


pytest-axe adds a command line option for specifying whether or not to run accessibility tests.

Running pytest with --axe will run only tests marked as accessibility, i.e. @pytest.mark.accessibility.

The absence of this command line option will run only tests not marked as accessibility.

Pytest Fixture Example

The following example will run aXe-core against the entire page, and check for violations of any impact level.

import pytest

 def test_header_accessibility(axe):
     violations =
     assert len(violations) == 0,

You can also customize your accessibility tests by defining context, options, or impact.

import pytest

 def test_header_accessibility(axe):
     violations ='header', None, 'critical')
     assert len(violations) == 0,

The above example runs aXe against only the content within the <header> tag, and filters for violations labeled critical.

For more information on context and options, view the aXe documentation here.

The third parameter, impact, allows you to filter violations by their impact level. The options are 'critical', 'serious' and 'minor', with the default value set to None.

This will filter violations for the impact level specified, and all violations with a higher impact level.

The axe fixture uses base_url defined in the pytest command or in a config file.

$ pytest --base-url --driver Firefox

PyPOM Example

These examples are dependent on the use of PyPOM , and assumes any Page object has a selenium object attribute.

from pytest_axe.pytest_axe import run_axe

 def test_login_page_accessibility(login_page):
     """Test login page for accessibility violations."""

And with custom run options:

from pytest_axe.pytest_axe import run_axe

 def test_login_page_accessibility(login_page):
     """Test login page header for critical accessibility violations."""
     run_axe(login_page, 'header', None, 'critical')

Recording Results

pytest-axe checks for an environment variable ACCESSIBILITY_REPORTING.

To enable writing the aXe JSON results to file, set ACCESSIBILITY_REPORTING=true.

Currently, this will write the JSON files to the root of your test directory, with the page title and a timestamp as the file name.


Version 1.0.0

  • Transferred functions and methods from axe_selenium_python.
  • run_axe helper method, to simplify accessibility testing for test suites using PyPOM.
  • run() method, which injects the aXe JavaScript, runs aXe against the page, filters the results based on a specified impact level, and returns a dictionary of only violations, with the ruleId as the key.
  • impact_included, used by run() to filter checks by a specificed impact level.
  • Environment variable ACCESSIBILITY_REPORTING to enable recording results.
  • analyze(), which calls run() and writes the JSON results to file, if enabled using the environment variable.

Version 0.2.0

  • Added a command line argument to filter tests based on the presence or absence of a pytest accessibility marker.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pytest-axe-1.0.0.tar.gz (4.9 kB view hashes)

Uploaded source

Built Distribution

pytest_axe-1.0.0-py3-none-any.whl (8.3 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page