Aqua Help

Advanced configuration

Aqua enables you to customize or modify specific aspects of Web Inspector according to your needs.

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.

    Change the UI Automation framework
  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 the IDE settings, then select Tools | Web Inspector.

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

    Add a new custom data attributes
  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.

Inlay hint

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.

    Hide Web Inspector code inlay hints
  3. Apply changes.

Last modified: 02 May 2024