browser-test

Browser Test to umiejętność do interaktywnej walidacji funkcji. Zamiast pisać testy, opisujesz co chcesz sprawdzić, a narzędzie uruchamia agenta, który steruje przeglądarką za pomocą Playwright. Automatycznie wykrywa port aplikacji, czyta pliki specyfikacji lub przyjmuje opis funkcji, a następnie generuje raport ze zrzutami ekranu. Idealne do szybkiej weryfikacji bez konfiguracji testów.

1. Przygotuj informacje o aplikacji: jeśli masz plik specyfikacji w formacie Gherkin (np. specs/features/moja-funkcja.feature), przygotuj jego ścieżkę; jeśli nie, przygotuj krótki opis tego, co chcesz przetestować.

2. Określ port aplikacji. Narzędzie automatycznie szuka pliku .dev-port w katalogu głównym repozytorium. Jeśli plik nie istnieje, uruchamia skrypt scripts/dev-up.sh, który go tworzy. Możesz też podać port ręcznie w argumentach.

3. Uruchom umiejętność, przekazując port (opcjonalnie) i opis funkcji lub ścieżkę do pliku specyfikacji. Przykład: podaj port 5570 i opis "sprawdź czy dashboard ładuje się po zalogowaniu" lub ścieżkę "specs/features/beta-pill.feature".

4. Narzędzie parsuje Twoje argumenty, odczytuje plik specyfikacji (jeśli podałeś ścieżkę) i konwertuje scenariusze na listę kroków do weryfikacji. Jeśli nic nie podasz, uruchomi domyślny test: sprawdzenie czy aplikacja się ładuje, logowanie działa i dashboard się renderuje.

5. Agent sterujący przeglądarką wykonuje każdy krok, a wyniki wraz ze zrzutami ekranu zapisywane są w katalogu browser-tests z datą i nazwą funkcji.

6. Przejrzyj raport ze zrzutami ekranu, aby potwierdzić że funkcja działa poprawnie. Brak plików testów — tylko interaktywna weryfikacja i dokumentacja wizualna.