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

Install

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.