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`.