CheckOps home

Tools directory

H

CheckOps

Healenium

Healenium is an open-source, Apache-2.0 self-healing library for Selenium (with an Appium adapter) that replaces broken locators at runtime using a machine-learning matching algorithm.

Visit website

Latest public signals

Not refreshed yet. Refresh reads the public site and, when the entry has a GitHub repository, the latest release.

Visit Website

Introduction

Healenium is an open-source self-healing library for Selenium-based tests. The GitHub organisation publishes it under Apache-2.0. The official site says it improves the stability of Selenium tests by replacing a broken locator with the one that best matches the changed element, so tests keep running.

It integrates with existing Selenium frameworks and offers an adapter for Appium-based tests. Healenium is available on AWS Marketplace, and the team offers paid support hours and a Healenium Pro edition.

Features

  1. Runtime locator healing: When a locator breaks, Healenium finds the best matching element and continues.
  2. Selenium integration: Works as a wrapper around WebDriver in existing frameworks.
  3. Appium adapter: Supports Appium-based mobile tests.
  4. Healing reports: Reports which locators were healed, so you can update code.
  5. Backend service: A backend (healenium-backend) stores element history used for matching.
  6. AWS Marketplace: Available through AWS Marketplace.
  7. Pro edition: Healenium Pro adds features with a 30-day trial.

Pros

  1. Free and open: Apache-2.0 core.
  2. No rewrite: Add to an existing Selenium suite.
  3. Transparent: Reports show what was healed.
  4. Mobile option: Appium adapter.
  5. Paid support available: For teams that need help.

Cons

  1. Extra infrastructure: Needs the backend service and storage.
  2. Healing can hide changes: A healed locator may point to the wrong element; review reports.
  3. Selenium-centric: Not for Playwright or Cypress.
  4. Small community: Around 170 stars on the main repo at review.
  5. Locator-only: It heals locators, not logic or assertions.

Add the Healenium client to your Selenium project, run the backend (Docker images are provided), and wrap your WebDriver with Healenium’s self-healing driver as described in the docs. After runs, open the healing report and update locators in code.

Resources:

Pricing

From healenium.io:

  1. Free: Healenium open source.
  2. Support: Healenium open source plus 10 service hours, $1,000 a year.
  3. Professional: Healenium Pro, with a 30-day free trial; contact for price.
  1. Teams with large, brittle Selenium suites.
  2. Java test automation engineers wanting less locator maintenance.
  3. Appium users with similar locator churn.
  4. Not a fit for Playwright or Cypress suites.

Conclusion

Healenium is a practical, open-source way to add self-healing to Selenium without changing frameworks.

Treat healed locators as warnings to fix in code, not as permanent solutions.

Alternatives

Other tools on CheckOps that cover similar ground. Open a page, or compare one with Healenium side by side.