cypress-axe

Spec sheet

Purpose

cypress-axe lets users test accessibility with axe-core in Cypress.Read 11 Oct 2026 · github.com

Free plan

YesRead 23 Sep 2026 · github.com

License

The repository identifies the project as MIT licensed.Read 11 Oct 2026 · github.com

Accessibility checks

cy.checkA11y runs axe against the document when called and can check issues that appear after user interactions.Read 11 Oct 2026 · github.com

Automated scans

YesRead 23 Sep 2026 · github.com

Browser extension

NoRead 23 Sep 2026 · github.com

Check accessibility

The cy.checkA11y command runs axe against the document when called and can also analyze a specified DOM context.Read 11 Oct 2026 · github.com

CI/CD integration

YesRead 23 Sep 2026 · github.com

Compatibility

The package metadata declares peer dependencies axe-core ^3 or ^4 and Cypress versions ^10 through ^16.Read 11 Oct 2026 · github.com

Configuration

cy.configureAxe configures the data format and can add rules that must be registered with the library to execute.Read 11 Oct 2026 · github.com

Configure checks

The cy.configureAxe command configures axe data and can add rules registered with the library.Read 11 Oct 2026 · github.com

Creators and maintainers

The README says Andy Van Slaars created the project and Artem Sapegin maintains it.Read 11 Oct 2026 · github.com

Custom callbacks

An optional violation callback receives included violations and can be used for custom side effects such as terminal output.Read 11 Oct 2026 · github.com

Custom output

A violation callback can receive violations for custom side effects, including terminal output using Cypress tasks.Read 11 Oct 2026 · github.com

Cypress compatibility

The README gives installation instructions for Cypress 10 and above, and for Cypress 9 using cypress-axe 0.x.x.Read 11 Oct 2026 · github.com

Cypress versions

The README gives separate setup instructions for Cypress v10 and above and for Cypress v9 and below.Read 11 Oct 2026 · github.com

Failure behavior

By default, detected accessibility violations fail the test; skipFailures disables assertions and logs violations to the console.Read 11 Oct 2026 · github.com

Failure handling

The skipFailures option defaults to false; when enabled, checks log violations without asserting on them.Read 11 Oct 2026 · github.com

Filter and retry

cy.checkA11y supports filtering violations by impact and retrying checks at a specified interval.Read 11 Oct 2026 · github.com

Impact filters and retries

Checks can filter violations by minor, moderate, serious, or critical impact and retry checks to account for dynamic content.Read 11 Oct 2026 · github.com

Inject axe-core

The cy.injectAxe command injects the axe-core runtime into the page under test and should run after cy.visit and before cy.checkA11y.Read 11 Oct 2026 · github.com

Installation

The README instructs users to install cypress-axe, axe-core, and Cypress from npm.Read 11 Oct 2026 · github.com

Integration

The package is installed from npm as a development dependency alongside axe-core and Cypress.Read 11 Oct 2026 · github.com

Maintainers

The README says the project was created by Andy Van Slaars and is maintained by Artem Sapegin.Read 11 Oct 2026 · github.com

Manual review tools

NoRead 23 Sep 2026 · github.com

Mobile testing

NoRead 23 Sep 2026 · github.com

Page injection

The cy.injectAxe command injects axe-core into the page under test after cy.visit and before cy.checkA11y.Read 11 Oct 2026 · github.com

Remediation guidance

NoRead 23 Sep 2026 · github.com

Scoped analysis

Checks can target the document or a specific DOM selector, and accept axe.run options.Read 11 Oct 2026 · github.com

TypeScript

The README provides TypeScript configuration instructions for adding cypress-axe types to Cypress's tsconfig.json.Read 11 Oct 2026 · github.com

WCAG coverage

wcag 2.0Read 23 Sep 2026 · github.com

Plans and prices

Every cypress-axe plan and price →

Where Specifiction places it

• Website Accessibility Tools#61 of 1337.9
• Accessibility Testing Software#79 of 1698.0