Skip to main content

Use the Self-Healing function in Katalon Recorder

On some websites, automation scripts can fail because the default locator fails to find an element. In that case, Self-Healing will automatically try out other locators. If it finds a valid locator, it will continue the automation script using that locator and records the broken and valid locators for later use.

Enabling and disabling Self-Healing​

Self-healing is enabled by default.

You can disable it by following these steps:

  1. Go to Settings > Self-Healing.

  2. Uncheck Enable Self-Healing execution.

  3. Save and close.



Prioritizing locator methods in Self-Healing​

Self-Healing uses 3 locator methods, in this priority order: id, css, xpath. However, the best locator methods may vary depending on your websites under test.

You can change the order of locator methods by following these steps:

  1. Go to Settings > Self-Healing.

  2. Make sure Self-Healing is enabled.

  3. Drag and drop the locator methods in the order of your choosing.

  4. Save and close.

Excluding certain commands from Self-Healing​

Warning:

Some commands validate that a particular element exists on a certain page. We advise you to not trigger Self-Healing on these commands, as it encurs the risk of validating elements incorrectly.

By default, verifyElementPresent,verifyElementNotPresent,assertElementPresent andassertElementNotPresent commands are excluded from Self-Healing.

You can choose to exclude certain commands from Self-Healing by following these steps:

  1. Go to Settings > Self-Healing.

  2. Make sure Self-Healing is enabled.

  3. Add the commands you want to exclude to the list.

  4. Save and close.

Note:

Regex is also supported for excluding commands. For example, you can exclude all command starting with the keywordwaitFor by adding ^waitFor to the list.

Approving Self-Healing proposals​

When the default locator fails, Self-Healing finds alternative locators to complete the test execution. After the test execution is completed, you can choose to replace failing locators by approving Self-Healing suggestions.



The Self-Healing tab is refreshed on every new execution.

To approve Self-healing suggestions, follow these steps:

  1. Go to the Self-Healing tab.

  2. Select the suggested locators using the status filter.

  3. Press Approve.