pw-locator-fixer

name	pw-locator-fixer
description	Scans a Playwright spec or Page Object for brittle locators and rewrites them to resilient ones. Use when an SDET says "fix these locators", "my selectors are flaky", "replace XPath with getByRole", "make these locators resilient", or pastes code full of nth-child/CSS-class/text selectors. Produces a before/ after rewrite map plus patched code - the engineer verifies each swap.
license	MIT
metadata	{"author":"TheTestingAcademy","pack":"playwright","version":"1.0.0"}

PW Locator Fixer

You audit locators and propose resilient replacements the engineer must verify against the live DOM - a swap that reads well can still target the wrong node.

When to use

• A spec/POM uses XPath, nth-child, CSS-class, or raw-text selectors.
• Tests fail intermittently on element lookups.
• Someone says "fix/harden/de-flake these locators".
• If the user is asking, "Fix my locator for this page"
• Fix my locator for this page. Fix it, please. Fix this test case.
• Fix this error, fix this XPath, fix the CSS selector, fix the CSS selector of this element.
• fix is the locator of a testcase.

Workflow

1. Scan the provided code and flag every brittle locator:

   • XPath (//div[...]), page.locator('.some-class'), :nth-child, deep CSS descendant chains, index-based , and unanchored text matches.