-
Notifications
You must be signed in to change notification settings - Fork 3.6k
Extend testdriver.js and wptrunner to test AAMs (platform accessibility APIs) #53733
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: master
Are you sure you want to change the base?
Conversation
I wonder if we can make the name |
Amazing, thanks @jcsteh! I didn't know about that Firefox option, I always used the gnome accessibility trick. I changed the CLI arg to |
762b8de to
356e3c4
Compare
62fc8e5 to
b937113
Compare
5b98700 to
fbf3fdf
Compare
7c3363d to
0f4b380
Compare
This reverts commit d508e40.
Co-authored-by: Jonathan Lee <jonathan-j-lee@users.noreply.github.com>
550c19d to
c8c462e
Compare
Closes web-platform-tests/interop-accessibility#210
This PR adds an extension to
testdriver.jsin order to test accessibility API, as defined by the ARIA, Core-AAM and HTML-AAM specifications. The RFC to extendtestdriver.jsin this way can be found here. The decision to open a PR with these changes was made at TPAC 2024.The change in this CL:
--enable-accessibility-api. So on regular runs of wpt.fyi, they will fail, for now, as you can see with:a. The option
--enable-accessibility-apihas been added. This option will install the appropriate python requirements for accessibility API tests and turn on accessibility for Firefox and Chromium browsers. If this option is not supplied, tests may fail withAccessibility API testing not enabled. The primary reason for the flag is that on linux, there are system requirements for the python requirements, so./wpt runwill fail in environments where the system requirements are not installed. For now I think it's better to only run the tests intentionally/behind a flag.a. The product name ("chrome", "firefox", etc) is passed back to the executor level. This is necessary because accessibility APIs are exposed externally to the browser, and we need to find the browser in the accessibility API by name. Ideally, this will be done by PID (to allow for parallelization), but that requires some changes to chromedriver and safaridriver.
executorplatformaccessibility.pyandtools/wptrunner/wptrunner/executors/platformaccessibility: these executors run tests against platform specific accessibility APIs, so there is an executor for Linux, Windows, and macOS. The Windows and macOS ones are proof of concepts and will need more work. The Linux one is fully featured and can run all of the tests added in this PR.To run tests on Linux:
On Debian distros:
apt install libatspi2.0-dev libcairo2-dev libgirepository1.0-devNotes about macOS and Windows
On Windows and macOS, even with the following dependencies, these tests will fail with the message "Fail: Test not implemented".
Thanks to @alice for the macOS code and thanks @jcsteh, the code to get IA2 interface was very inspired by the firefox test infrastructure: https://searchfox.org/mozilla-central/source/accessible/tests/browser/windows/a11y_setup.py
Running the tests on macOS
To run against Firefox, you need to turn on VoiceOver the screen reader.
To run against Chrome, you need to include --no-headless.