Skip to main content

Java adapter — ai.testiv:testivai (experimental)

New here? vs. rolling your own covers what this replaces (including how it compares to AShot).

Experimental

The Java adapter ships full source in java/ with the same stabilization, ignore and naming semantics as the other adapters (the playwright-java path records no element map yet; see Capture semantics) — compiled and unit-tested in CI (JUnit 5 + Mockito) — but is not yet published to Maven Central. Build it with mvn package for now; feedback and contributions welcome.

Local-first visual regression for playwright-java and Selenium (SeleniumWitness.witness(driver, ...) — see the Selenium guide), sharing baselines, tolerances, report, and PR approvals with the JS/TS and Python adapters. Node.js is required for the compare/report step — playwright-java already ships a Node driver.

Usage (JUnit 5)​

import ai.testiv.testivai.CaptureOptions;
import ai.testiv.testivai.TestivAIExtension;
import ai.testiv.testivai.Witness;

@ExtendWith(TestivAIExtension.class)   // runs `testivai report` after the run
class HomepageTest {

  @Test
  void homepage() {
    page.navigate("http://localhost:3000");
    Witness.witness(page, "homepage");
  }

  @Test
  void pricing() {
    page.navigate("http://localhost:3000/pricing");
    Witness.witness(page, "pricing", new CaptureOptions()
        .setIgnoreSelectors(List.of(".live-chat"))  // hidden from pixels AND the DOM signal
        .setVariant("chromium"));                    // keys baselines per browser
  }
}

Without JUnit: call Runner.runReport() yourself after your tests.

First run creates new snapshots — approve and commit:

npx testivai approve --all
git add .testivai/baselines/

Capture semantics​

Shared with the other adapters: stabilization CSS (animations complete at final state, caret hidden, fonts awaited), ignoreSelectors excluded from pixels and DOM, variant folded into the snapshot name. Configuration comes from the same .testivai/config.json.

One difference: Witness.witness(page, ...) (playwright-java) writes only .testivai/temp/<name>/{screenshot.png, dom.html}, with no element map (elements.json). Its snapshots get no style check (styleCheck: "unavailable"), no selector attribution and no page-shift detection: a pixel diff with an identical DOM reads styles not compared — could be render noise or a stylesheet-only change — never likely noise, and noiseAutoPass never passes it. SeleniumWitness.witness(driver, ...) records the element map and gets the full analysis.