Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »

gulp-axe-webdriver

2.1.2 • Public • Published

gulp-axe-webdriver

Package Quality

Gulp plugin for aXe utilizing WebDriverJS.

Inspired by grunt-axe-webdriver and gulp-axe-core.

This plugin checks local and remote urls, using the Chrome browser via chromedriver.

Install

$ npm install --save-dev gulp-axe-webdriver

The task

Usage

var gulp = require('gulp');
var axe = require('gulp-axe-webdriver');
 
gulp.task('axe', function(done) {
  var options = {
    saveOutputIn: 'allHtml.json',
    urls: ['http://www.foobar-url-1/', 'http://www.foobar-url-2/']
  };
  return axe(options, done);
});
var gulp = require('gulp');
var axe = require('gulp-axe-webdriver');
 
gulp.task('axe', function(done) {
  var options = {
    saveOutputIn: 'allHtml.json',
    urls: ['src/file2.html']
  };
  return axe(options, done);
});

With Headless Chrome

var gulp = require('gulp');
var axe = require('gulp-axe-webdriver');
 
gulp.task('axe', function(done) {
  var options = {
    saveOutputIn: 'allHtml.json',
    headless: true,
    urls: ['src/file2.html']
  };
  return axe(options, done);
});

With Glob patterns

var gulp = require('gulp');
var axe = require('gulp-axe-webdriver');
 
gulp.task('axe', function() {
  var options = {
    saveOutputIn: 'allHtml.json',
    urls: ['src/*.html', 'http://www.foobar-url-2/']
  };
  return axe(options, done);
});

Options

Type: Object

Default value:

{
  threshold: 0,
  folderOutputReport: 'aXeReports',
  saveOutputIn: '',
  tags: null
}

a11yCheckOptions

Type: Object

Specifies options to be used by axe.a11yCheck. Will override any other configured options. See axe-core API documentation for information on its structure.

exclude

Type: String

Default value: null

Add a CSS selector to the list of elements to exclude from analysis.

folderOutputReport

Type: String

Default value: aXeReports

An optional folder to indicate where the output will be saved.

headless

Type: Boolean

Default value: false

To run the Chrome browser in Headless mode.

include

Type: String

Default value: null

Adds a CSS selector to the list of elements to include in analysis.

saveOutputIn

Type: String

Default value: ''

An optional file to which the results of the accessibility scans will be written as a JSON Array of results objects.

showOnlyViolations

Type: Boolean

Default value: false

Returns only the results with the accessibility issues.

tags

Type: String or Array[String]

Default value: null

Which tags to filter violations on.

threshold

Type: Number

Default value: 0

A number that represents the maximum number of allowable violations. Each violation represents a rule that fails, it may fail for an number of nodes. It is recommended that this value not be changed. A negative value will prevent failure whatever the number of violations.

urls

Type: Array[String]

Default value: []

An Array of URLs that will be tested. The default value is an empty array, you must supply at least one URL in order to successfully complete this task.

Can also be a glob pattern;

verbose

Type: Boolean

Default value: false

Show status of the analysis.

Release History

Read the full changelog.

License

MIT © Felix Zapata

install

npm i gulp-axe-webdriver

Downloadsweekly downloads

415

version

2.1.2

license

MIT

repository

githubgithub

last publish

collaborators

  • avatar