screen-reader-testing
Test web applications with screen readers including VoiceOver, NVDA, and JAWS. Use when validating screen reader compatibility, debugging accessibility issues, or ensuring assistive technology support.
Author
Category
Development ToolsInstall
Hot:1
Download and extract to your skills directory
Copy command and send to OpenClaw for auto-install:
Download and install this skill https://openskills.cc/api/download?slug=sickn33-skills-screen-reader-testing&locale=en&source=copy
Screen Reader Testing Skill Guide
Skill Overview
Screen Reader Testing is a testing skill used to verify the compatibility of web applications with screen readers. It supports major screen reader software such as VoiceOver, NVDA, and JAWS.
Applicable Scenarios
1. Accessibility Compatibility Verification
Before product release, use screen readers to verify the accessibility of web pages, components, and interactive functions for users with visual impairments, ensuring compliance with WCAG accessibility standards.
2. ARIA Implementation Debugging
Check whether ARIA attributes (such as
aria-label, aria-live, aria-expanded, etc.) are correctly interpreted and spoken by screen readers, and troubleshoot semantic issues.3. Dynamic Content Testing
Test dynamic scenarios in single-page applications, such as route changes, asynchronously loaded content, and real-time notifications, to ensure screen readers can correctly detect and inform users of state changes.
Core Functions
1. Multi-Platform Screen Reader Support
Provide testing guidance for three major screen readers: VoiceOver (macOS/iOS), NVDA (Windows), and JAWS (Windows), covering differences in shortcuts and interactions across platforms.
2. Accessibility Issue Diagnosis
Help identify common accessibility issues, including: images missing alt text, unlabelled form fields, inaccessible custom components, focus management problems, and more.
3. Test Methods and Best Practices
Offer a systematic testing process, including test environment setup, test case design, issue logging, and repair verification, to ensure that accessibility testing is repeatable and effective.
Common Questions
What tools should be used for screen reader testing?
It is recommended to use three major screen readers: VoiceOver (built into macOS; enable with Cmd+F5), NVDA (free and open-source on Windows), and JAWS (commercial software on Windows). It’s best to test at least VoiceOver and NVDA to cover both macOS and Windows platforms.
Can screen reader testing fully replace automated tools?
No. Automated tools (such as axe-core, Lighthouse) can quickly detect syntax-level accessibility issues, but they cannot verify the actual screen reader reading experience and interaction flow. They should be used together: automated tools for initial screening, and screen reader testing for in-depth validation.
How to test route changes in a single-page application?
Route changes in a single-page application require focus management and use of
aria-live regions. When testing, verify that after a route switch the screen reader reads the new page title, the focus moves to a reasonable location, and the history updates correctly. If route changes are not announced, consider using an aria-live="polite" region or manually calling the screen reader’s live-region/announcement API.