@testcafe-community/axe

@testcafe-community/axe

The TestCafe module that allows you to use the aXe accessibility engine in TestCafe tests.

Installation

yarn add -D axe-core @testcafe-community/axe

How to use

You can write a TestCafe test with automated accessibility checks like this.

Add the following clientScript in your testcafe config:

"clientScripts":[{"module":"axe-core/axe.min.js"}]

import { axeCheck, createReport } from '@testcafe-community/axe';

fixture `TestCafe tests with Axe`
    .page `http://example.com`;

test('Automated accessibility testing', async t => {
    const { error, violations } = await axeCheck(t);
    await t.expect(violations.length === 0).ok(createReport(violations));
});

If any accessibility issues are found, you will see a detailed report generated by the createReport function.

aXe options

The @testcafe-community/axe module allows you to define the context and options axe.run parameters in a TestCafe test.

test('Automated accessibility testing', async () => {
    const axeContext = { exclude: [['select']] };
    const axeOptions = { rules: { 'html-has-lang': { enabled: false } } };
    const { error, violations } = await axeCheck(t, axeContext, axeOptions);
    await t.expect(violations.length === 0).ok(createReport(violations));
});