Playwright-Healer

Automatic self-healing selectors for resilient Playwright tests.

📌 Problem

UI tests often fail due to small, unexpected changes in web applications, such as:

• Renamed CSS classes or selectors
• Structural DOM changes
• Dynamic attribute shifts

These brittle selectors lead to:

• Increased maintenance burden
• Flaky CI pipelines
• Slower feature releases

Manual fixing of selectors slows down teams and increases technical debt.

🎯 Solution

playwright-healer augments your Playwright tests by making selectors self-healing. When a selector is broken, the package:

1. Detects broken selectors during runtime.
2. Suggests or finds alternatives using heuristics and AI-assisted DOM analysis.
3. Updates selector mappings for future test runs.

Benefit: Reduce manual maintenance and keep CI/CD pipelines green.

⚙️ Features

• 🔎 Automatic healing of selectors on failure
• 🤖 AI/heuristic powered selector matching
• 🛠️ Easy integration with existing Playwright test code
• ✅ Out-of-the-box compatibility with Playwright
• 📊 Detailed reports of healed selectors for manual verification

📦 Installation

npm install playwright-healer