What it is

axe-core is an open source accessibility testing engine for websites. It is a set of rules written in JavaScript that run inside a web page and report the elements that break them. The project is maintained by Deque Systems, an accessibility company, and is published under the Mozilla Public License 2.0.

Many accessibility tools are built on axe-core, so its rule names, such as color-contrast and image-alt, are familiar to many developers and AI agents.

What it finds

axe-core checks things that can be decided from the page’s code and styles:

  • images, buttons, links and form fields with no accessible name
  • text with too little contrast against its background
  • wrong or incomplete ARIA attributes
  • a missing page title or page language
  • structures that assistive technology cannot read, such as lists and tables with broken markup

Each rule is tied to one or more WCAG success criteria. The project’s stated aim is to report no false positives, so it stays silent when it is not sure.

What it cannot find

  • Whether a text alternative is right. It sees that an image has an alt text, not whether the text describes the image.
  • Whether a page can be used with a keyboard from start to end.
  • Whether headings, link texts and instructions make sense to a person.
  • Anything that appears only after an interaction the check does not make.

How Supervisor uses it

  • axe-core is the main checker. It runs on every page, at a desktop and a mobile size.
  • Supervisor runs the rules tagged for WCAG 2.0 and 2.1 at levels A and AA, and for WCAG 2.2 at level AA. Best-practice rules and level AAA rules are left out.
  • It runs in a part of the browser that the page’s own scripts cannot reach, so a page cannot change its own result.
  • For each rule, up to 10 failing elements per page are kept, with a screenshot where one can be taken. Findings on elements that cannot be seen on screen are dropped.
  • Most axe-core findings become open issues at once. Findings for nine WCAG criteria, where a rule is more often wrong, wait for a person. What Supervisor checks with lists them.
  • When a check follows a journey, axe-core is the only checker that runs after each step.

Supervisor is an independent service. It is not affiliated with Deque Systems or the axe-core project.