Advanced configuration

Change a UI automation framework

If the system fails to recognize the UI automation framework used in your project, it selects the most suitable one. In case the framework is selected incorrectly, you can manually change it. To do this:

1. Open the Web Inspector tool window.

2. Click the name of the current UI automation framework on the Status bar.

   

3. Select the appropriate UI automation framework from the UI Automation Framework menu.

Add custom data attributes

If the webpage you are testing contains elements with custom data-attributes, you can instruct Aqua to prioritize such attributes over non-custom ones when generating locators. To do this:

1. Press Ctrl+Alt+S to open settings, then select Tools | Web Inspector.

   

2. In the Custom Data Attributes window, click the button, specify the attribute name, and click OK.

   

3. Apply changes.

As a result, specified custom data attributes will be prioritized when generating locators.

Hide Web Inspector code inlay hints

In Aqua, there is a special marker that appears in the editor next to the locator.

You can use this marker to verify that the corresponding locator exists on the webpage and points to a specific element on it.

However, if you do not want to display these inlay hints, you can hide them. To do this:

1. Click the button in the Locators Evaluator section.

2. Disable the Show validation hints for XPath and CSS locators in a code parameter.

   

3. Apply changes.