Documentation Frameworks

Documentation

Compatibility with Test Automation Frameworks

Healenium is a versatile visual testing and self-healing framework that can be seamlessly integrated with several popular test automation frameworks, enhancing your ability to create robust and reliable automated tests. In this section, we'll explore how Healenium can be used in conjunction with the following frameworks:

Serenity
Robot Framework
WebdriverIO
Cucumber BDD
Browserstack

Serenity

Serenity is a popular open-source library for writing high-quality, maintainable acceptance criteria tests. Healenium can be seamlessly integrated into Serenity-based projects, enabling automatic healing of your UI tests. To start using Healenium with WebdriverIO, follow the guidance:

Install Healenium-Proxy with or without using Docker.
Configure a Remote Web Driver to connect to Healenium with URL http://<hlm-proxy-host>:<hlm-proxy-port>. In the case of a local launch: http://localhost:8085

webdriver {
  driver = remote
  remote {
    url="http://localhost:8085"
    driver=chrome
  }
}

3. Execute the tests.

Example project: https://github.com/healenium/healenium-serenity-example

Robot Framework

Robot Framework is an open-source automation framework that provides an easy-to-read tabular syntax. By combining Robot Framework with Healenium, you can create maintainable and self-healing test suites. To use Healenium with Robot Framework, follow the guidance:

Install Healenium-Proxy with or without using Docker.
Configure a Remote Web Driver to connect to Healenium with URL http://<hlm-proxy-host>:<hlm-proxy-port>. In the case of a local launch: http://localhost:8085

Open Remote Chrome Browser
    Open Browser    ${PAGE_URL}  ${BROWSER}  remote_url=http://localhost:8085

3. Execute the tests.

Robot Framework always uses multiple element search (findElements). Since Healenium disables healing for multiple element searches (findElements) by default, you need to specify -FIND_ELEMENTS_AUTO_HEALING=true in the healenium-backend service.

Example project: https://github.com/healenium/healenium-robot-framework-example

WebdriverIO

WebdriverIO is a leading JavaScript test automation framework that provides an easy-to-use API for automating web applications. When combined with Healenium, WebdriverIO tests become more resilient and capable of self-healing. To start using Healenium with WebdriverIO, follow the guidance:

Install Healenium-Proxy with or without using Docker.
Configure a Remote Web Driver to connect to Healenium with URL http://<hlm-proxy-host>:<hlm-proxy-port>. In the case of a local launch: http://127.0.0.1:8085

    services: [],
    // host/port/protocol your hlm-proxy service
    hostname: '127.0.0.1',
    port: 8085,
    protocol: 'http'

3. Execute the tests.

Example project: https://github.com/healenium/healenium-example-webdriverio

Cucumber BDD

Cucumber is a widely-used behavior-driven development (BDD) framework that allows you to write tests in plain language. Integrating Healenium with Cucumber can enhance your BDD tests by adding self-healing capabilities to them. To get started with Healenium and Cucumber, follow the steps:

Install Healenium-Proxy with or without using Docker.
Configure a Remote Web Driver to connect to Healenium with URL http://<hlm-proxy-host>:<hlm-proxy-port>. In the case of a local launch: http://localhost:8085

ChromeOptions options = new ChromeOptions();
WebDriver driver = new RemoteWebDriver(new URL("http://localhost:8085"), options);

3. Execute the tests.

Java example project: https://github.com/healenium/healenium-cucumber-example

Browserstack

Leveraging the strength of Browserstack, a widely-used cloud testing platform, you can enhance your web application testing with Healenium. It's important to note that Healenium can exclusively integrate with Browserstack using the legacy approach, which involves specific configuration settings. Browserstack provides a versatile testing environment, while Healenium offers self-healing capabilities, making it a powerful combination.

Install Healenium-Proxy with or without using Docker.
If you are using Docker Compose for Healenium, locate the docker-compose-appium.yaml file
2.1. Replace the SELENIUM_SERVER_URL and APPIUM_SERVER_URL environment variables of the healenium-proxy service with the following URL

https://User_Name:Access_Key@hub.browserstack.com/wd/hub

2.2. Replace User_Name with your BrowserStack User Name and Access_Key with your BrowserStack Access Key.

3. If you are not using Docker, navigate to the shell-installation/selenium-grid directory.
3.1. Open the start_healenium.sh script.
3.2. Replace the SELENIUM_SERVER_URL and APPIUM_SERVER_URL environment variables with the following URL:

https://User_Name:Access_Key@hub.browserstack.com/wd/hub

3.3. Replace User_Name with your BrowserStack User Name and Access_Key with your BrowserStack Access Key.

4. Configure a Remote Web Driver to connect to Healenium with URL http://<hlm-proxy-host>:<hlm-proxy-port>. In the case of a local launch: http://localhost:8085

ChromeOptions options = new ChromeOptions();
WebDriver driver = new RemoteWebDriver(new URL("http://localhost:8085"), options);

3. Execute the tests.

Java example project: https://github.com/healenium/healenium-browserstack-example

Healenium

About Healenium

Help

Contacts

Anna_Chernyshova@epam.com - Project Manager
Dmitriy_Gumeniuk@epam.com - Project Supervisor