microsoft / microsoft/playwright-java

[Feature]: Support for Playwright Test Agents (Planner, Generator, Healer) in Java

Open
#1,885 3 comments 4 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

P3-collecting-feedback
Dominant language
Java
Stars
1.6k
Forks
298
Avg merge
3d 2h
Merged PRs (30d)
14

Description

🚀 Feature Request

Description
Playwright v1.56+ introduced the Agentic Workflow (planner, generator, and healer) which has significantly improved the efficiency of test authoring and maintenance for Node.js users. However, these tools are currently not accessible to teams using the Java bindings.

As a Java user, I would like to leverage the AI-powered Healer Agent to automatically repair failing tests by inspecting the UI and updating locators, just as it is currently possible with npx playwright init-agents --loop=vscode.

Motivation
Many enterprise environments rely on Java for their test automation infrastructure. Currently, Java users have to:

Manually debug and fix locators.

Use third-party proxies (like Healenium) which require additional infrastructure.

Maintain separate Node.js environments just to utilize the AI agents.

Bringing parity to the Java library would allow us to integrate self-healing directly into our JUnit/TestNG workflows.

Proposed Implementation
CLI Support: Add agent initialization to the Playwright Java CLI (e.g., mvn exec:java -e -D exec.mainClass=com.microsoft.playwright.CLI -D exec.args="init-agents").

Healer Integration: Allow the Healer to analyze Java test failures and suggest/apply patches to .java source files or Page Object Models.

Documentation: Provide a guide on how to configure the agentic loop within a Maven/Gradle project.

Example Use Case
When a locator in a Page Object fails:

Java
// Page Object
private final Locator submitButton;
public LoginPage(Page page) {
this.submitButton = page.locator("#old-id"); // This ID changed to #new-id
}
The Healer Agent should detect the TimeoutError, scan the DOM, identify the new ID, and suggest the fix directly in the console or IDE.

Example

No response

Motivation

Playwright has it for Javascript/Typscript (which I played with on my own and thought it was cool). But the test automation project that I am working was written with Java using the Selenium library. I added Playwright to the project due to 1) able to inject API responses and 2) able to execute using for Safari/Webkit (due to security the automation scripts have to set the user-agent value that Safari does not allow us to do). This would be able another cool feature.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing the Playwright Java CLI entry point, com.microsoft.playwright.CLI, and how Java Maven/Gradle projects invoke it. Clarify the intended scope for agent initialization, Java test-failure handling, source-file patching, and documentation; done should include an agreed implementation boundary and validation for the supported workflow.

Written by the indexing model from the issue text.

Assessment

Tech stack
java
Domain
cli, testing-qa
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.