Use AI self-heal for your Selenium tests running on BrowserStack Automate TurboScale

Automatically recover failed Selenium tests on BrowserStack Automate TurboScale with AI.

BrowserStack’s self-healing feature for automated tests enables automatic recovery from locator changes or sub-optimal locator strategies during test execution. This feature enhances test suite robustness, reduces test flakiness, and improves reliability.

Enable self-healing

To enable the self-healing feature, set the selfHeal capability to true in your test configuration file.

The self healing feature is supported on the following browsers:

userName: YOUR_USERNAME
accessKey: YOUR_ACCESS_KEY
platforms:
  - os: Windows
    browserName: Chrome
    browserVersion: latest
projectName: BrowserStack Self-Heal
sessionName: First Self-Heal Test
selfHeal: true

MutableCapabilities capabilities = new MutableCapabilities();
HashMap<String, Object> browserstackOptions = new HashMap<String, Object>();
browserstackOptions.put("userName", "YOUR_USERNAME");
browserstackOptions.put("accessKey", "YOUR_ACCESS_KEY");
browserstackOptions.put("selfHeal", "true");
capabilities.setCapability("bstack:options", browserstackOptions);

var capabilities = {
	'bstack:options' : {
		"userName" : "YOUR_USERNAME",
		"accessKey" : "YOUR_ACCESS_KEY",
		"selfHeal" : "true"
	}
}

Dictionary<string, object> browserstackOptions = new Dictionary<string, object>();
browserstackOptions.Add("userName", "YOUR_USERNAME");
browserstackOptions.Add("accessKey", "YOUR_ACCESS_KEY");
browserstackOptions.Add("selfHeal", "true");
capabilities.AddAdditionalOption("bstack:options", browserstackOptions);

$caps = array(
	'bstack:options' => array(
		"userName" => "YOUR_USERNAME",
		"accessKey" => "YOUR_ACCESS_KEY",
		"selfHeal" => "true"
	)
)

desired_cap = {
	'bstack:options' : {
		"userName" : "YOUR_USERNAME",
		"accessKey" : "YOUR_ACCESS_KEY",
		"selfHeal" : "true"
	},
}

capabilities = {
	'bstack:options' => {
		"userName" => "YOUR_USERNAME",
		"accessKey" => "YOUR_ACCESS_KEY",
		"selfHeal" => "true"
	}
}

DesiredCapabilities caps = new DesiredCapabilities();
caps.setCapability("userName", "YOUR_USERNAME");
caps.setCapability("accessKey", "YOUR_ACCESS_KEY");
caps.setCapability("browserstack.selfHeal", "true");

var capabilities = {
 "userName" : "YOUR_USERNAME",
 "accessKey" : "YOUR_ACCESS_KEY",
 "browserstack.selfHeal" : "true"
}

DesiredCapabilities capability = new DesiredCapabilities();
capability.AddAdditionalCapability("userName", "YOUR_USERNAME");
capability.AddAdditionalCapability("accessKey", "YOUR_ACCESS_KEY");
capability.AddAdditionalCapability("browserstack.selfHeal", "true");

$caps = array(
 "userName" => "YOUR_USERNAME",
 "accessKeyild" => "YOUR_ACCESS_KEY",
 "browserstack.selfHeal" => "true"
);

desired_cap = {
 "userName" : "YOUR_USERNAME",
 "accessKey" : "YOUR_ACCESS_KEY",
 "browserstack.selfHeal" : "true"
}

caps = Selenium::WebDriver::Remote::Capabilities.new
caps["userName"] = "YOUR_USERNAME"
caps["accessKey"] = "YOUR_ACCESS_KEY"
caps["browserstack.selfHeal"] = "true"

All your tests that are recovered by self-heal appear on the dashboard marked by the self-heal icon as shown in the following image:

You can view these self-healed locators in the Text Logs tab of your session masked by the self-heal icon

You can filter the self-healed builds using the builds filter and selecting the Healed option under Self-Healing dropdown.

You can also filter your self-healed sessions using the sessions filter and selecting the Healed option under Self-Healing dropdown.

You can filter the Text Logs to only view the self-healed locators as shown in the following image:

How Self-heal works

The self-healing functionality for Selenium locators represents an advanced approach in test automation to mitigate volatility of inconsistent tests. It intelligently adjusts locators by consolidating attributes and context, promoting robustness and flexibility. During runtime, it continuously monitors the web page to detect changes in the Document Object Model (DOM).

Once an element is successfully located on the page, its DOM path is logged for future reference. If the same element subsequently cannot be found, the system analyzes the current page state and generates new locators for modified elements based on past references.

The self-healing feature automatically detects new locators that were changes by web elements and continues the test execution.

Self-heal advantages

Self-healing streamlines test automation processes, offering several key benefits:

Self-heal limitations

Although the self-heal feature is engineered to handle a broad spectrum of issues, it comes with it’s own set of limitations, such as: