A11y Report Runner

A11y Report Runner

Project

An accessibility scan script powered by Playwright and axe-core

Tech Stack

JS (ESM), axe-core, Playwright

Project summary

A11y Report Runner is an accessibility testing tool designed to automate the evaluation of web pages using Playwright and Axe. By combining browser automation with automated accessibility checks, it helps developers identify potential barriers, examine reported violations, and incorporate accessibility testing into their development workflows.

Project summary

A11y Report Runner is an accessibility testing tool designed to automate the evaluation of web pages using Playwright and Axe. By combining browser automation with automated accessibility checks, it helps developers identify potential barriers, examine reported violations, and incorporate accessibility testing into their development workflows.

This is my first accessibility tool. I wrote it specifically for my portfolio site, but I figured it could be useful to others. It uses axe-core and Playwright to render both a report in JSON and as an HTML document that can be viewed in the browser.

The project focuses on making accessibility testing more repeatable, consistent, and approachable while reducing the manual effort involved in running routine audits. Built with extensibility and maintainability in mind, Report Runner serves as a standalone testing utility that can evolve alongside accessibility standards and development practices.

Rather than treating automated testing as a substitute for human evaluation, the tool is intended to complement manual accessibility audits and support a more comprehensive approach to building inclusive web experiences.

Recent updates

  • Huge release update!

    Needing to use the report runner in a current working project, I discovered some (a lot of) room for improvement.

Browse all updates
Back to top