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.
By wshobson · 9,501 installs
npx skills add wshobson/agents --skill screen-reader-testing
Source repository · Upstream listing
Screen Reader Testing
Practical guide to testing web applications with screen readers for comprehensive accessibility validation.
When to Use This Skill
Validating screen reader compatibility
Testing ARIA implementations
Debugging assistive technology issues
Verifying form accessibility
Testing dynamic content announcements
Ensuring navigation accessibility
Core Concepts
1. Major Screen Readers
Screen Reader Platform Browser Usage
VoiceOver macOS/iOS Safari ~15%
NVDA Windows Firefox/Chrome ~31%
JAWS Windows Chrome/IE ~40%
TalkBack Android Chrome ~10%
Narrator Windows Edge ~4%
2. Testing Priority
3. Screen Reader Modes
Mode Purpose When Used
Browse/Virtual Read content Default reading
Focus/Forms Interact with controls Filling forms
Application Custom widgets ARIA applications
VoiceOver (macOS)
Setup
Essential Commands
Testing Checklist
Common Issues & Fixes
NVDA (Windows)
Setup
Essential Commands
Browse vs Focus Mode
Testing Script
JAWS (Windows)
Essential Commands
TalkBack (Android)
Setup
Gestures
Common Test Scenarios
1. Modal Dialog
2. Live Regions
3. Tab Interface
Debugging Tips
Best Practices
Do's
Test with actual screen readers Not just simulators
Use semantic HTML first ARIA is supplemental
Test in browse and focus modes Different experiences
Verify focus management Especially for SPAs
Test keyboard only first Foundation for SR testing
Don'ts
Don't assume one SR is enough Test multiple
Don't ignore mobile Growing user base
Don't test only happy path Test error states
Don't skip dynamic content Most common issues
Don't rely on visual testing Different experience