Craig Morten

@cmor10.bsky.social

Building Guidepup - Screen Reader Automation • Doing Web Things https://www.guidepup.dev

Been messing with Guidepup this week, it is super cool! It has it's flaws, but it is a really cool concept of trying to do some automated testing for screen reader functionality. Keyword, functionality, doesn't replace actual screen reader testing www.guidepup.dev

Screen reader driver for test automation | Guidepup

Reliable automation for your screen reader accessibility test workflows with Guidepup. Drive VoiceOver and NVDA a11y tests with ease

guidepup.dev

New to Guidepup: screen reader capture for 3rd party interactions. Use Playwright to drive your test. Use Guidepup to capture what the screen reader actually says. No need to choose between browser automation and real screen reader output.

Code block:

import { screenReaderTest as test } from "@guidepup/playwright";
import { expect } from "@playwright/test";

test.describe("Screen Reader Tests", () => {
  test("I can capture screen reader output from Playwright commands", async ({
    page,
    screenReader,
  }) => {
    await page.goto("https://www.example.com");

    const button = page.locator("#triggerAnnouncement");
    await button.waitFor();

    await screenReader.navigateToWebContent();

    await button.focus();

    const { spokenPhrase } = await screenReader.capture(() => button.click());

    expect(spokenPhrase).toContain("live region announcement");
  });
});

One thing I’m particularly happy with in the latest Guidepup releases: Screen reader settings can now be overridden per test. No more relying on user screen reader configuration, and no permanent changes to user preferences. Makes screen reader automation much more reproducible.

await voiceOver.start({
  settings: { ... }
});

Today's accessibility reminder. The only way to get better at screen reader testing is to practice using screen readers. Use shortcuts, skip around, don't just depend on the Tab key. You don't read every website top to bottom so why would we assume screen reader users do that?

We’ve invested a ton of effort into building out screen reader automation as part of our end-to-end accessibility testing service. And we’ve learned a ton along the way! This article goes deep into the geeky details of why & how to automate screen readers. 🦾 assistivlabs.com/articles/aut...

Automating Screen Readers for Accessibility Testing

Automated accessibility testing is an essential component of a successful accessibility strategy, but traditional automated accessibility tools haven’t included screen readers. New tools are being dev...

assistivlabs.com