Test Fixing & Self-Healing

Methodology

When a test fails, do not just "try random things". Follow this procedure:

Read the Error: Is it Timeout, AssertionError, or ReferenceError?
Check the Artifacts: Look at the Screenshot/Video/Trace at the moment of failure.
Isolate: Can you reproduce it with npx playwright test --project=chromium -g "test name"?

Race Condition: Did the test assert before the UI finished animating? (Sol: await expect auto-retries, check await page.waitForLoadState()).
Data Issue: Did previous tests dirty the database? (Sol: Ensure DB reset in beforeEach or unique naming).
Selector Changed: Did a class name change? (Sol: Update locator to be resilient).

Error	Probable Cause	Fix
`TimeoutError: waiting for selector`	Element not in DOM	Check `if` conditions, ensure correct page navigation.
`received: "Loading..." expected: "Data"`	Assertion too early	Use `await expect().not.toHaveText("Loading...")` first.
`Element is not clickable`	Overlay/Modal blocking	Check for sticky headers or previous modals not closing.

Related skills

Installs

–

Repository

First Seen

–

Security Audits