Testing

Playwright Locator Playground

Wklej mały DOM, porównaj locatory w stylu Playwright, sprawdź accessible names i zobacz, kiedy strict mode przejdzie, zawiedzie albo stanie się niejednoznaczny.

  • DOM zostaje w przeglądarce
  • Diagnostyka strictness
  • Podgląd accessible-name

Review locatora, zanim flaky test trafi do repo

Playwright rekomenduje locatory użytkownikowe, ale review kodu nadal potrzebuje szybkiego sposobu sprawdzenia, co getByRole, getByLabel, getByText, data-testid i CSS dopasują w małym snapshocie HTML. Ten playground daje stabilną powierzchnię review bez uruchamiania pełnego testu w przeglądarce.

Evaluator używa odpiętego dokumentu DOMParser, usuwa ryzykowne elementy i atrybuty oraz nie wysyła wklejonego markup-u do backendu.

Zbuduj strict locator

Wybierz preset DOM albo wklej markup, a potem porównaj typ locatora, rolę accessible, name/text query, filter hasText i nth jako tie breaker.

Uruchom locator

Review zwykłego formularza logowania z labelami, placeholderem, buttonem submit i linkiem resetu. Najlepszy domyślny wybór, gdy element ma znaczącą rolę i accessible name.

DOM i wejście locatora

Wynik locatora

Uruchom locator, aby zobaczyć strictness, dopasowane elementy, diagnostykę i snippet Playwright.

Co sprawdzić w review locatorów Playwright

Zaczynaj od ról i nazw

Role locators odzwierciedlają to, jak technologie asystujące widzą stronę. Gdy button, link albo dialog ma czytelne accessible name, test jest łatwiejszy do czytania i trudniejszy do przypadkowego popsucia.

Traktuj ambiguity jako sygnał designu

Jeżeli locator wskazuje więcej niż jeden element, strict mode Playwright chroni test przed wyborem złego targetu. Doprecyzuj name, scope albo filter przed dodaniem akcji.

CSS zostaw jako ostatni wybór

CSS locators bywają konieczne dla legacy markup-u, ale wiążą test ze strukturą. Preferuj label, role, text albo test id, gdy opisują kontrakt użytkownika.

Decyzje o locatorach zwykle łączą się z semantyką asercji, rule testingiem i przeglądem konfiguracji. Użyj sąsiednich narzędzi, gdy kontrakt testu jest szerszy niż jeden selector.

FAQ

Czy to uruchamia prawdziwy Playwright?

Nie. MVP jest symulatorem learning/review dla semantyki locatorów. Nie importuje Playwright w runtime i nie uruchamia przeglądarki.

Dlaczego strictness może być ambiguous?

Akcje Playwright oczekują jednego targetu. Jeśli locator pasuje do powtórzonych buttonów, rows albo labeli, test wymaga doprecyzowania przed click albo fill.

Jakie reguły accessible-name są ujęte?

Playground obejmuje praktyczny subset review: aria-labelledby, aria-label, label, alt, title, widoczny tekst i placeholder fallback.

Czy wklejony HTML opuszcza przeglądarkę?

Nie. Snapshot DOM jest parsowany i sanitizowany lokalnie w przeglądarce, bez wysyłania do backendu.