{"id":15043953,"url":"https://github.com/amadeusitgroup/assistive-webdriver","last_synced_at":"2025-10-23T15:30:33.872Z","repository":{"id":38480754,"uuid":"244336976","full_name":"AmadeusITGroup/Assistive-Webdriver","owner":"AmadeusITGroup","description":"Assistive-Webdriver is a tool to automate end-to-end web application tests with a screen reader.","archived":false,"fork":false,"pushed_at":"2023-08-03T06:32:02.000Z","size":3536,"stargazers_count":25,"open_issues_count":8,"forks_count":9,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-02T05:05:45.495Z","etag":null,"topics":["automated-tests","playwright","screen-reader","webdriver"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AmadeusITGroup.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-03-02T09:58:18.000Z","updated_at":"2024-08-01T07:50:25.000Z","dependencies_parsed_at":"2024-09-25T01:51:39.517Z","dependency_job_id":"12483a36-dad9-4824-8b84-9181bdace367","html_url":"https://github.com/AmadeusITGroup/Assistive-Webdriver","commit_stats":{"total_commits":559,"total_committers":5,"mean_commits":111.8,"dds":0.5545617173524151,"last_synced_commit":"126a4e31f53609d85202c2b95551fbd12360479f"},"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AmadeusITGroup%2FAssistive-Webdriver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AmadeusITGroup%2FAssistive-Webdriver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AmadeusITGroup%2FAssistive-Webdriver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AmadeusITGroup%2FAssistive-Webdriver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AmadeusITGroup","download_url":"https://codeload.github.com/AmadeusITGroup/Assistive-Webdriver/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237843859,"owners_count":19375218,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automated-tests","playwright","screen-reader","webdriver"],"created_at":"2024-09-24T20:49:52.170Z","updated_at":"2025-10-23T15:30:33.383Z","avatar_url":"https://github.com/AmadeusITGroup.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![codecov](https://codecov.io/gh/AmadeusITGroup/Assistive-Webdriver/branch/master/graph/badge.svg)](https://codecov.io/gh/AmadeusITGroup/Assistive-Webdriver)\n\n# Presentation\n\nThis repository contains a set of components to automate end-to-end web application tests with a screen reader.\n\nWeb sites and web applications are increasingly required to be accessible, and, especially, compatible with screen readers, so that visually impaired users can use them.\n\nTo be sure that an application is compatible with a screen reader, it is important to test it in real conditions, which means using the application with the keyboard and listening to what the screen reader says. That is how a visually impaired user would interact with the application.\n\nMost of the time those tests are currently done manually. The tools available in this repository allow to automate them.\n\n## Assistive-Webdriver\n\nAssistive-webdriver is an implementation of a Webdriver server that allows testing a scenario in a web application with a screen reader and checking that the screen reader says what is expected.\n\nConcretely, it adds screen reader-related functions to webdriver.\n\nFor example:\n\n```js\nawait driver.wait(forScreenReaderToSay(\"Date of departure\"), 5000);\n```\n\nIt also allows keystrokes to be sent low-level enough to pass through the screen reader (unlike usual webdriver implementations that send keystrokes directly to the browser and bypass hooks in the operating system).\n\nFor example, the \"down arrow\" key usually makes a screen reader read the next thing on the screen:\n\n```js\nawait driver.actions().sendKeys(Key.DOWN).perform();\n```\n\nAssistive-webdriver uses a virtual machine to run tests. Here is a schema describing how it works:\n\n![Architecture of Assistive-Webdriver](components/assistive-webdriver/architecture.png)\n\nThe 3 yellow boxes in this schema are the three components of Assistive-Webdriver, in the following three directories:\n\n- [assistive-webdriver](components/assistive-webdriver)\n- [text-to-socket-engine](components/text-to-socket-engine)\n- [tcp-web-listener](components/tcp-web-listener)\n\nInside of the assistive-webdriver component, all calls to create, control, and destroy the virtual machine are made through the following component that can be used independently:\n\n- [vm-providers](components/vm-providers)\n\n## Assistive-Playwright\n\nAssistive-Playwright is similar to Assistive-Webdriver but is based on [playwright](https://playwright.dev/) rather than webdriver.\n\nIt adds screen reader-related functions to playwright:\n\n```js\nawait screenReader.waitForMessage(\"Date of departure\");\n```\n\nIn order to be able to send low-level mouse and keyboard events, Assistive-Playwright uses a virtual machine to run tests.\nHere is a schema describing how it works:\n\n![Architecture of Assistive-Playwright](components/assistive-playwright-client/architecture.png)\n\nThe 3 yellow boxes in this schema are the three components of Assistive-Playwright, in the following three directories:\n\n- [assistive-playwright-client](components/assistive-playwright-client)\n- [assistive-playwright-server](components/assistive-playwright-server)\n- [text-to-socket-engine](components/text-to-socket-engine)\n\nAnother package is provided for integration with the @playwright/test test runner (it uses assistive-playwright-client internally):\n\n- [assistive-playwright-test](components/assistive-playwright-test)\n\nInside of the assistive-playwright-client component, all calls to create, control, and destroy the virtual machine are made through the following component that can be used independently:\n\n- [vm-providers](components/vm-providers)\n\n**Note that the recommended way to run tests with a screen reader is to use the [assistive-playwright-test](components/assistive-playwright-test) package along with @playwright/test.**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famadeusitgroup%2Fassistive-webdriver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famadeusitgroup%2Fassistive-webdriver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famadeusitgroup%2Fassistive-webdriver/lists"}