Merv-Local + JUnit 5 guide

Introduction

JUnit 5 is the standard unit and integration test framework for Java. Merv-Local integrates via @ExtendWith(MervJUnitHandler.class) and writes HTML/JSON reports under merv.report.folder.

You will learn
  • How to add merv-client-api to Maven
  • Minimum merv.properties for local mode
  • How to register MervJUnitHandler
  • Optional Selenium binding for screenshots
  • How to record data, validation, and info steps

Add dependency

Add MERV to your project (use the latest version from Maven Central when available):

<dependency>
  <groupId>io.github.techelliptica</groupId>
  <artifactId>merv-client-api</artifactId>
  <version>3.0.3</version>
</dependency>

Configure merv.properties

Place merv.properties on the classpath (for example src/test/resources/):

merv.local=true
merv.regression_suite=Your Regression Suite Name
merv.report.folder=./merv-reports
merv.execution.parallel=false
merv.screenshot=on

Register JUnit 5 extension

Add the extension to your test class:

import org.junit.jupiter.api.extension.ExtendWith;
import org.teche.merv.client.plugin.MervJUnitHandler;

@ExtendWith(MervJUnitHandler.class)
class MyTests {
  // tests...
}

Alternatively, use @RegisterExtension if you want per-class control.

Bind automation (optional)

When merv.screenshot=on, bind your driver during test execution:

// Selenium example
MervJUnitHandler.setAutomationToolObject(AutomationTool.SELENIUM, driver);

Plugin steps in tests

Use the unified reporter API (same for Cucumber, TestNG, and JUnit 5):

MervReporter.validation("Verify total", expected, actual);
MervReporter.data("Payload", requestJson);
MervReporter.info("Reached checkout page");

Run tests

mvn test

Viewing Merv reports

After a run, reports live under {merv.report.folder} (for example ./merv-reports/). Open paths through a local web server — not via file:// in the file manager.

merv-reports/ index.html # Dashboard (all runs) 15-05-2026 14-23-41 Merv-Report/ json/merv-report.json # Suite + testcase data html/merv-report.html # Final suite report html/merv-report-live.html # Live report during run

Open with a web server

Merv-Local reports load JSON and charts with fetch. Browsers often block that on file:// URLs. Use your IDE’s static server (or any local HTTP server) so the address bar shows http://localhost:….

  1. In VS Code, install Live Server, right-click merv-reports/index.html, and choose Open with Live Server.
  2. In IntelliJ IDEA, right-click index.html and choose Open in Browser (built-in preview server).
  3. While tests run, keep merv-report-live.html open on the same server for live updates.

What’s next

← Back to Documentation