Katalon Self Healing not working

Web Testing
, ,
1

Hi All, Self healing is not showing any suggestions in any scenarios to approve although I have enabled it. I have tried with Katalon git hub project also. I tried all posisble way to do but still not showing. Any suggestions will be great!!

image
image1393Ă—351 85.9 KB

image
image808Ă—624 66.4 KB

image
image1411Ă—346 30.7 KB

1 Like
2

Hi there, and thanks for posting in the Katalon community! :hugs:

To help you faster, please review our guide on Git here:

Double-checking the steps and configurations might resolve the issue.

If the doc doesn’t help, feel free to provide more details, and a community member will assist you soon. Thanks for being a part of our community!

Best,
Elly Tran

3

Can Someone connect with me?

1 Like
4

Dear Rahul,

Based on your screenshots and the official documentation, I can now identify the critical issue:

Your test is failing with

TestObjectException: Object is null

  • This is a different type of error than a broken locator, and self-healing CANNOT fix this type of error.

Looking at your execution log (second screenshot), the error is:

TestObjectException: Object is null
Unable to click on object

This means the test object itself is null/not found at all, not that the locator is broken. Self-healing only works when:

  1. A locator fails to find an element (but the element exists)
  2. An alternative locator can find it

Possible Cause

Self-healing suggestions will NOT appear because:

  1. The test object is null - The object reference itself is null, not just the locator
  2. Self-healing only handles broken locators - It doesn’t handle null object references
  3. The error occurs before locator evaluation - The test object isn’t even being evaluated because it’s null

This is why your Self-Healing Insights tab is empty even though self-healing is enabled.

Solutions

Solution 1: Verify the Test Object Exists and is Properly Referenced

Steps:

  1. In your test case, check how you’re calling the test object:

groovy

// ❌ WRONG - This might return null
WebUI.click(findTestObject('Object Repository/Page_Name/element_name'))

// âś… CORRECT - Verify the object exists first
def testObject = findTestObject('Object Repository/Page_Name/element_name')
if (testObject != null) {
    WebUI.click(testObject)
} else {
    KeywordUtil.markFailed("Test object not found!")
}

  1. Verify the test object path is exactly correct - check for typos or incorrect folder paths

  2. Ensure the test object file exists in your Object Repository

Source: Katalon Documentation - Self-healing mechanism

Solution 2: Create a Test Object with Multiple Locators

For self-healing to work, your test object needs multiple locator methods configured:

Steps:

  1. Open your test object in the Object Repository
  2. Add multiple locators (XPath, CSS, Attributes, Smart Locator, Image)
  3. Save the test object
  4. Run your test again

Example test object with multiple locators:

Selection Method: XPath
XPath: //input[@id='txt-username']

Alternative Locators:
- CSS: #txt-username
- Attributes: //input[@name='username']
- Smart Locator: [generated automatically]

Source: Katalon Documentation - Locator methods for WebUI objects

Solution 3: Use Failure Handling to Continue on Error

If the object is legitimately missing, configure failure handling:

Steps:

  1. In your test case, add failure handling:

WebUI.click(findTestObject('Object Repository/Page_Name/element_name'), FailureHandling.CONTINUE_ON_FAILURE)

  1. This allows the test to continue even if the object is not found

Source: Katalon Documentation - Failure Handling

Solution 4: Test with the Official Self-Healing Sample Project

To verify self-healing works in your environment:

Steps:

  1. Clone the sample project: Self-healing sample project
  2. Run the test cases - they’re designed with intentionally broken locators (not null objects)
  3. Check the Self-Healing Insights tab - you should see suggestions
  4. This confirms self-healing is working and the issue is with your test objects

So in this case, Your error is “Object is null” - this is NOT a broken locator issue, so self-healing cannot help. You need to fix the test object reference first.

Please let me know if this help, if not please provide your org ID our support team will be in assistance.

Bella

5

Hi there,

Could you please let us know which Katalon Studio version you’re currently using?

To verify if the issue is environment-specific, please try running this sample project without making any changes:
https://github.com/katalon-studio/self-healing-demo

Simply open the project in Katalon Studio and run the provided test case.

If the self-healing suggestions still do not appear, kindly share your error log file located at:
<Katalon Studio installation folder>\\config\\.metadata\\.log

This will help us further investigate the issue.

2 Likes