@quales/playwright-healer

AI-powered self-healing locator agent for Playwright. When a test fails due to a broken selector, the healer automatically suggests a replacement — posted to healing-report.md in your project root.

Installation

npm install @qualestech/playwright-healer --save-dev

Setup

1. Add to playwright.config.ts:

import { defineConfig } from '@playwright/test';

export default defineConfig({
  reporter: [
    ['list'],
    ['@qualestech/playwright-healer']
  ],
  // ... rest of your config
});

2. Add your licence key to .env:

QUALES_API_KEY=qlc_live_xxxxxxxxxxxx

Or pass it directly in the config:

reporter: [
  ['list'],
  ['@quales/playwright-healer', { apiKey: 'qlc_live_xxxxxxxxxxxx' }]
]

Usage

Run your tests as normal:

npx playwright test

When a locator fails, the healer activates automatically. After the run, open healing-report.md in your project root to see suggested replacements.

Output

🔍 Quales healer active — watching for broken locators

✗ logout button returns user to /login

🔧 Healing: "logout button returns user to /login"
   Broken: [data-testid="btn-logout-OLD"]
   ✅ Suggestion: getByTestId('btn-logout')
   Confidence: high

🩹 Healing report → healing-report.md
   1 locator(s) analysed

Licence

Contact [email protected] for a licence key. Commercial use requires an active Quales subscription.