microsoft / microsoft/playwright-java
[Feature]: Support for Playwright Test Agents (Planner, Generator, Healer) in Java
Nobody has claimed this yet.
- 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
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- 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