How to use AutoHeal using Hooks

Autoheal feature automatically handles dynamic element changes during Selenium test execution. This is especially useful for tests where elements’ IDs, XPaths, or attributes may change between runs. Autoheal ensures your tests are more resilient and reduces flakiness.

Autoheal can be started or stopped at any point in your test script using simple hooks. This allows for precise control over when your tests should attempt element healing, improving reliability and reducing flaky tests. This guide explains how to enable and disable Autoheal in your Selenium scripts using the lambdatest hooks.

Using Autoheal Hooks in Tests

Autoheal hooks can be inserted anywhere in the script depending on where you need dynamic element handling. Typical flow:

• Navigate to your test page.
• Start Autoheal before interacting with elements that may change.
• Perform element actions (find, click, send keys, etc.).
• Stop Autoheal after these actions.
• Continue the rest of your test normally.

This gives you fine-grained control over Autoheal, improving test stability without affecting unrelated test steps.

Enable AutoHeal

Use the following hook to start Autoheal at any point in your Selenium test script:

driver.execute_script('lambdatest_executor:{"action":"lambda-heal-start"}')

Usage : Place this hook right before interacting with elements that may dynamically change during the test.

Disable AutoHeal

Use the following hook to stop Autoheal at any point in your Selenium test script:

driver.execute_script('lambdatest_executor:{"action":"lambda-heal-stop"}')

Usage : Place this hook immediately after the actions requiring Autoheal are completed. This ensures subsequent test steps execute with normal Selenium behavior.

Sample Script

Test.py

import os
import time
from selenium import webdriver

platform = os.getenv('HYPEREXECUTE_PLATFORM')

desired_cap_chrome = {
 "build": "Lambdatest Build 2",
 "name": "Lambdatest Test",
 "platform": platform,
 "browserName": "Chrome",
 "version": "latest",
 "visual": False,
 "video": True,
 "network": True,
 "console": True,
 'goog:chromeOptions': {'args': ['--window-size=400x300']},
}

hub = f"https://{os.getenv('LT_USERNAME')}:{os.getenv('LT_ACCESS_KEY')}@hub.lambdatest.com/wd/hub"

def test_autoheal(caps, sleep_time=5):
    driver = webdriver.Remote(command_executor=hub, desired_capabilities=caps)
    
    # Navigate to page
    driver.get("https://www.selenium.dev")
    
    # ===== Autoheal START =====
    driver.execute_script('lambdatest_executor:{"action":"lambda-heal-start"}')
    
    # Interact with elements that may change dynamically
    driver.find_element_by_id('td-block-1')
    driver.execute_script('document.getElementById("td-block-1").id="updatedtd-block-1";')
    driver.find_element_by_id('updatedtd-block-1')
    
    # ===== Autoheal STOP =====
    driver.execute_script('lambdatest_executor:{"action":"lambda-heal-stop"}')
    
    # Continue normal test steps
    driver.execute_script("console.log('Test completed successfully');")
    driver.execute_script("lambda-status=passed")
    
    driver.quit()

test_autoheal(desired_cap_chrome)

With these steps, you can seamlessly integrate LambdaTest HyperExecute Autoheal into your Selenium tests, reducing flaky tests and improving stability.