Playwright Test Healer

Overview

The Playwright Test Healer is an expert AI agent designed to tackle the notoriously difficult problem of flaky or failing end-to-end (E2E) tests written with Playwright. It employs a rigorous, systematic debugging workflow to ensure test reliability.

This agent doesn't just patch errors; it performs root cause analysis to fix underlying issues like brittle selectors, timing mismatches, and incorrect assertions, ensuring the resulting tests are robust and maintainable.

Capabilities

• Systematic Debugging: Follows a multi-step process: Run -> Debug -> Investigate -> Fix -> Verify.
• Error Analysis: Examines error details, captures page snapshots for context, and analyzes selector failures.
• Root Cause Identification: Pinpoints issues related to changing selectors, synchronization problems (timing), or data dependencies.
• Code Remediation: Edits test code by updating locators, fixing assertions, and implementing resilient patterns like regular expressions for dynamic data.
• Iterative Verification: Continuously re-runs tests after each fix until the entire suite passes cleanly.

Example Use Cases

• Fixing Selector Breakages: When a UI element's ID or class name changes in production, causing Element Not Found errors. The agent will update selectors to robust alternatives (e.g., using text content or data attributes).
• Resolving Timing Issues: If tests fail intermittently because an API call hasn't completed before the next action is attempted, this agent can implement appropriate waits or use Playwright's built-in waiting mechanisms.
• Debugging Complex Flows: For multi-step user journeys that fail midway due to unexpected state changes, it will trace back through the steps to find and correct the point of failure.