Accessibility checks run against a page or a specific element in your application to check for violations. You can configure accessibility checks to fail based on the severity of violations or target specific tags or rules. This article explains how to create an accessibility check in the mabl Trainer.
For a more comprehensive tutorial on accessibility testing in mabl, check out our getting started guide!
To create an accessibility check for your application, take the following steps:
- Launch the mabl Trainer with the application under test
- Get the application into the desired state.
- Click on the plus sign to add a new step.
- Select Accessibility.
- In the accessibility check menu, select a target:
- Current frame (default): checks the frame in focus and any associated iframes that are eligible to be checked
- Page: checks the full page, including all eligible iframes. If the accessibility check occurs after the test has switched context into an iframe, this check will still scan the full page and all eligible iframes.
- Element: checks accessibility at the element level. Element-level checks are appropriate when you have different accessibility standards for specific elements.
- Set failure criteria based on the severity of the violations.
- If you want to customize the check based on specific tags or rules, toggle on Advanced settings and select the tags or rules that you want to run in the accessibility check. Learn more here.
- Click OK.
Creating accessibility checks in the Trainer
To include content inside frames in the accessibility check, you may need to toggle on Bypass CORS in advanced settings. Learn more here.
Accessibility checks run like any other step in mabl. The output of the check appears at the step level in the test results. Accessibility check output includes a summary of all violations, checks that are incomplete or inapplicable, passing checks, and additional help resources. For an overview of accessibility violations across your testing, use the accessibility dashboard.
Detailed violation results
- Accessibility check results are not available during trainer replay at this time
- Minimal information on accessibility checks can be viewed during local runs. For complete results, the test must be executed in the cloud.