A command-line utility for executing test plans from w3c/aria-at. It operates by communicating with an AT Driver server and (in some environments) a WebDriver server.
aria-at-automation · aria-at-automation-harness · aria-at-automation-driver · aria-at-automation-results-viewer
- Install the software under test
- an assistive technology (currently limited to the NVDA screen reader and the VoiceOver screenreader)
- an AT Driver server for the assistive technology under test (e.g. the NVDA AT Driver server for NVDA or macOS AT Driver server for VoiceOver)
- a web browser (e.g. Mozilla Firefox, Google Chrome, or Apple Safari)
- a WebDriver server for the browser under test (e.g. GeckoDriver for Firefox or ChromeDriver for Chrome--this project does not currently require SafariDriver to test Safari)
- Install Node.js
- Download ARIA-AT and build the tests:
$ git clone https://github.com/w3c/aria-at $ cd aria-at && npm install && npm run build
- Download this project's source code and install its dependencies:
$ git clone https://github.com/w3c/aria-at-automation-harness.git $ cd aria-at-automation-harness && npm install
- Run the AT Driver server for the assistive technology under test
- Run the appropriate WebDriver server (if testing with Firefox or Chrome)
- Run the assistive technology under test
With the required software in place and the environment correctly configured,
the host.js
command-line application can be used to run ARIA-AT test plans.
Execute the following command to review the available arguments:
$ bin/host.js run-plan --help --show-hidden
For example, to run ARIA-AT's "Horizontal slider" test plan using NVDA and Firefox, execute the following command in a terminal:
$ node aria-at-automation-harness/bin/host.js run-plan \
--plan-workingdir aria-at/build/tests/horizontal-slider \
'{reference/**,test-*-nvda.*}' \
--agent-web-driver-url=http://127.0.0.1:4444 \
--agent-at-driver-url=ws://127.0.0.1:4382/session \
--reference-hostname=127.0.0.1 \
--agent-web-driver-browser=firefox
A collection of projects for automating assistive technology tests from w3c/aria-at and beyond
aria-at-automation-harness
A command-line utility for executing test plans from w3c/aria-at without human intervention using the aria-at-automation-driver
aria-at-automation-driver
A WebSocket server which allows clients to observe the text enunciated by a screen reader and to simulate user input
aria-at-automation-results-viewer
A tool which translates the JSON-formatted data produced by the aria-at-automation-harness into a human-readable form