| name | web-a11y-testing |
| description | Validates accessibility with automated checks, keyboard walkthroughs, screen reader smoke tests, zoom/preference checks, and focused regression reporting. Use when verifying new UI or confirming fixes. |
Web A11y Testing
Test Order
For repeatable smoke-check steps, see CHECKS.md.
- Automated scan for changed surfaces.
- Keyboard-only journey.
- Screen reader smoke pass.
- Zoom, reflow, reduced motion, and forced-colors checks where relevant.
Checklist
Testing checklist
- [ ] Automation run completed and findings triaged
- [ ] All controls reachable and operable by keyboard
- [ ] Focus order and focus visibility are logical
- [ ] Names, roles, states, and values are announced correctly
- [ ] Dynamic changes are announced or focus-managed
- [ ] Forms expose errors, hints, and recovery paths
- [ ] Images, SVG, media controls, captions/transcripts, and unusual link behavior are verified where present
- [ ] User preference modes remain usable
Screen Reader Smoke Path
- Check page title, landmarks, and heading map.
- Navigate to critical controls and verify role/name/state.
- Trigger state changes, dialogs, filters, validation, and pagination.
- Confirm no stale or duplicate announcements block task completion.
Report
Include scope, tools used, pass/fail results, reproduction steps for failures, and residual risk.
