Robot Framework
Robot Framework sits above Selenium: Accessibility is still configured on the underlying browser session (desired capabilities passed into Open Browser or your library’s remote configuration). This page is the onboarding path for teams using SeleniumLibrary (or equivalent) against the TestMu AI grid.
Browsers: Use Chrome or Edge with supported versions for Accessibility Automation.
Prerequisites
- Robot Framework + SeleniumLibrary (or compatible library) installed
- Remote URL and credentials for TestMu AI
- Accessibility enabled for your workspace
Onboarding path
1. Encode capabilities as variables
Define suite or global variables so every test uses the same grid options:
*** Variables ***
${LT_OPTIONS} {"accessibility": true, "accessibility.wcagVersion": "wcag21aa"}
Exact syntax depends on how you merge JSON into capabilities for your Open Browser keyword—some teams use a custom keyword that builds the options dict in Python and passes it to Create Dictionary / Evaluate.
2. Open Browser with Accessibility on
Pass the merged capabilities into Open Browser (or your wrapper) so the remote session includes "accessibility": true. Match the pattern you already use for browserName, platformName, and auth.
3. On-demand scan with Execute Javascript
After the page is ready:
Execute Javascript return document.readyState
Execute Javascript lambda-accessibility-scan
Use the second line only when you are not using accessibility.autoscan.
4. Auto-scan alternative
If you prefer scans on every navigation without Robot keywords:
# In capabilities JSON / dict
accessibility.autoscan ${True}
5. Run the suite and review reports
robot --outputdir results tests/
Then open the Automation Dashboard for the session and the Accessibility tab.
Troubleshooting
| Symptom | What to check |
|---|---|
| No report | Robot must forward accessibility to the remote session; inspect the session capabilities in the dashboard. |
| Hook errors | Ensure Execute Javascript runs in browser context and spelling is exactly lambda-accessibility-scan. |
Chat with Us
Ask the Community