playwright

Skill do tworzenia niezawodnych testów Playwright dla projektów. Nauczy Cię pisać testy e2e, które unikają typowych pułapek: jawnych timeoutów, kruchych selektorów i mocków. Zawiera pomocnicze funkcje do refaktoryzacji kodu testowego, wskazówki dotyczące atrybutów test ID oraz rekomendacje dotyczące modeli AI do testowania. Idealne dla zespołów chcących utrzymać wysoką jakość testów automatycznych.

1. Zainstaluj skill w swoim projekcie, dodając go do konfiguracji agenta AI (szczegóły instalacji znajdują się w repozytorium BloomBooks).

2. Przed napisaniem testu przejrzyj plik playwright_helpers.ts w projekcie — zawiera on funkcje pomocnicze i model inexpensive_model_for_testing, który powinieneś używać domyślnie do testów.

3. Pisząc test, unikaj jawnych timeoutów (np. wait() czy sleep()). Zamiast tego polegaj na wbudowanych mechanizmach czekania Playwright. Jeśli absolutnie potrzebujesz timeout, poproś użytkownika o zgodę i zapisz tę decyzję w komentarzu kodu.

4. Zamiast dopasowywać elementy po etykietach, tekstach promptów czy innych kruchych selektorach, dodaj atrybuty test ID do komponentów w kodzie aplikacji. Użyj tych ID w selektorach testów.

5. Refaktoryzuj powtarzający się kod testowy — przenieś wspólne operacje do playwright_helpers.ts, aby utrzymać testy czyste i łatwe do utrzymania.

6. Nigdy nie używaj mocków w testach. Testy powinny pracować z rzeczywistym kodem i rzeczywistymi zależnościami, aby weryfikować faktyczne zachowanie aplikacji.