Catch Low-Hanging Accessibility Fruit with axe-core

rpearce

Robert Pearce

Posted on February 21, 2020

Catch Low-Hanging Accessibility Fruit with axe-core

Deque Systems, in addition to having an accessibility-testing browser plugin, has an open source package, axe-core, that can help you determine if HTML contains obvious accessibility issues.

That tool can be used on its own in your tests, or you can turn it into a Promise and use it like this!

import axe from 'axe-core'

const isA11y = html =>
  new Promise((resolve, reject) => {
    axe.run(html, {}, (err, result={}) => {
      const { violations=[] } = result

      if (err) {
        reject(err)
      } else if (violations.length > 0) {
        reject(violations)
      } else {
        // Uncomment to view incomplete/unavailable tests & why
        //console.log(result.incomplete)
        resolve(true)
      }
    })
  })

test('bad form', async () => {
  const wrap = document.createElement('div')
  wrap.innerHTML = `
    <form>
      <div>Enter your name</div>
      <input type="text" />
      <button type="submit">Submit</button>
    </form>
  `
  document.body.appendChild(wrap)

  expect(await isA11y(wrap)).toEqual(true)
})
// Failed: Array [
//   Object {
//     "description": "Ensures every form element has a label",
//     "help": "Form elements must have labels",
//     "helpUrl": "https://dequeuniversity.com/rules/axe/3.5/label?application=axeAPI",
//     "id": "label",
//     "impact": "critical",
//     "nodes": Array [
//       [Object],
//     ],
//     "tags": Array [
//       "cat.forms",
//       "wcag2a",
//       "wcag332",
//       "wcag131",
//       "section508",
//       "section508.22.n"
//     ],
//   }
//  ]
Enter fullscreen mode Exit fullscreen mode

It can detect all sorts of accessibility issues, so long as the environment in which it's being tested supports the browser features used in axe-core's tests. For example, jsdom, which jest uses as its browser mocking engine, only recently added some support for Range, it seems there are still some aspects missing, and this prevents axe-core from being able to test things like the color contrast accessibility of text color on certain backgrounds.

That said, the sheer number of issues that can be caught with this tool is staggering. If you work with tools like React and combine this with Deque's react-axe tool and eslint-plugin-jsx-a11y, you are sure to catch heaps of low-hanging fruit.

Here is an example in a real OSS project of mine that uses this axe-core technique with @testing-library/react: https://github.com/rpearce/react-medium-image-zoom/blob/6721f87370d968361d9d0d14cd30d752832877d1/__tests__/Uncontrolled.js#L27.

What are you waiting for?

This is also posted on https://robertwpearce.com/catch-low-hanging-accessibility-fruit-with-axe-core.html.

💖 💪 🙅 🚩
rpearce
Robert Pearce

Posted on February 21, 2020

Join Our Newsletter. No Spam, Only the good stuff.

Sign up to receive the latest update from our blog.

Related