aXe runner

This runner can be used with CrawlKit in order to audit a website with the aXe accessibility engine.

Install

1npm install crawlkit-runner-axe --save

Example

1const CrawlKit = require('crawlkit');
2const AxeRunner = require('crawlkit-runner-axe');
3
4const crawler = new CrawlKit('http://your/page');
5// You could add a finder here in order to audit a whole network of pages
6crawler.addRunner('aXe', new AxeRunner());
7
8crawler.crawl()
9    .then((data) => {
10        console.log(JSON.stringify(data.results, true, 2));
11    }, (err) => console.error(err));

Configuring the aXe runner

Passing options

You can pass an options object to the aXe runner like this:

1crawler.addRunner('aXe', new AxeRunner(), {
2  runOnly: {
3      type: 'tag',
4      values: ['wcag2aa']
5    }
6});

For a list of options and the structure of the options object, please consult the aXe API.

Defining context

You can define the context the aXe runner should use like this:

1crawler.addRunner('aXe', new AxeRunner(), null, '.my-context');

By default, the context is document. Please bear in mind that only selector contexts work, as the code of the aXe runner itself runs in node.

This project is in no way affiliated with Deque Labs.