Package Exports
- @guidepup/guidepup
- @guidepup/guidepup/lib/index.js
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@guidepup/guidepup) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
Guidepup
Screen-reader driver for automation.
Providing a reliable set of APIs to automate your screen-reader a11y workflows through JavaScript.
Getting Started
Install Guidepup to your project:
npm install @guidepup/guidepupAnd get cracking with your first screen-reader automation code! 🚀
import { VoiceOver } from "@guidepup/guidepup";
async function run(): Promise<void> {
// Construct and start your screen-reader instance 🎉
const vo = new VoiceOver();
await vo.start();
// Navigate your environment with screen-readers just as your users do 🏎
await vo.moveNext();
// Assert on what your users really see and hear when using screen-readers 👂
console.log(await vo.getLastSpokenPhrase());
await vo.stop();
}
run();Guides
Check out these fab guides on how to set up your local or CI environments for using Guidepup. 📚
Examples
Check out these awesome examples to learn how you could use Guidepup in your projects. 🤓
API Documentation
Want to dive in? 🤿
The API documentation has all the information you need to write fantastic screen-reader driven workflows. 🧑💻
Roadmap
Screen-reader support:
- VoiceOver on MacOS
- NVDA on Windows (WIP)
- VoiceOver on iOS
- Talkback on Android
Environment support:
- MacOS local machine
- MacOS virtual machine
- CircleCI
- GitHub Actions (WIP)
- Windows local machine
- Windows virtual machine
Related
Building on the shoulders of giants! 🙌
Here are some related projects: