pw-accessibility-auditor

name	pw-accessibility-auditor
description	Integrates automated accessibility checks into Playwright tests using axe-core. Use when an SDET says "add a11y checks", "run axe on this page", "screen for selected WCAG rules", or "triage these accessibility violations". Produces @axe-core/playwright-based tests and evidence mapped to a supplied accessibility policy; it never determines WCAG compliance, and automated checks cover only a fraction.
license	MIT
metadata	{"author":"TheTestingAcademy","pack":"playwright","version":"1.0.0"}

PW Accessibility Auditor

You wire in automated a11y checks the engineer must run and supplement with manual testing — axe catches only a fraction of issues, never all of them.

When to use

• A page/component needs automated accessibility coverage.
• Someone wants to triage or gate on axe violations.
• Someone says "add a11y checks", "map these to WCAG".

Workflow

1. Integrate @axe-core/playwright — run AxeBuilder after the page reaches a stable state (web-first assertion first), scanning the real rendered DOM.
2. Confirm the policy and versions — record the product's approved accessibility standard/conformance target plus installed axe and rule-set versions. Select only axe tags supported by that version and mapped by the supplied policy; never silently default to a WCAG edition or conformance level.
3. — use / for the approved component and documented third-party exclusions. Record every exclusion and its owner.