STEP BY STEP

Get started with Selenium Java + TestZombie

Use the ready-made Java example or add TestZombie to existing Selenium tests through Maven. Keep your tests and try healing.

Open working GitHub example View package Create a free account

Prepare Java and Maven

The GitHub example requires Java 21+, Maven 3.9+ and a browser (Chrome, Firefox or Edge).

Clone the example project

The project already includes TestZombie, Selenium, JUnit and a runnable test flow.

git clone https://github.com/testzombie/testzombie-example-selenium-java.git
cd testzombie-example-selenium-java

Connect your account and run the tests

mvn test -Dtestzombie.apikey=YOUR_API_KEY -Dtestzombie.email=YOUR_EMAIL

Try healing

The demo deliberately changes UI elements. Run different mutation levels and inspect healing in test runs.

Integrate with your existing Selenium project

Add the Java library to your pom.xml. The version below matches the current example project; check Maven Central for available releases. Then create the driver through TestZombie instead of ChromeDriver.

<dependency>
  <groupId>com.testzombie</groupId>
  <artifactId>testzombie-lib-java</artifactId>
  <version>1.2.0</version>
</dependency>

TestZombieDriver.setCredentials(apiKey, accountEmail);
WebDriver driver = TestZombieDriver.createChrome();

Java library on Maven Central

If your first run does not work

Connection failed?

Check the API key, account email and network access to the TestZombie API.

No healing shown?

A normal test can succeed without healing. Try the mutation levels described in the repository to see healing in action.

Want to update source code?

Source updates are optional. Start with preview and review changes before applying them.

First run completed. What next?

You can inspect test runs and healing logs in your dashboard. TestZombie may repair a broken locator; real application failures still fail. Successful locator fixes can optionally be reviewed and applied as source updates.

All integrations