dust-test

Umiejętność do tworzenia praktycznych testów dla projektów Dust zgodnie z zasadą 80/20. Nauczy Cię, jak pisać skoncentrowane testy, które pokrywają najważniejsze ścieżki kodu i przypadki brzegowe bez zbędnego mockowania. Zawiera konkretne wytyczne dla TypeScript i Next.js, wskazówki dotyczące użycia fabryk testowych oraz listę tego, co testować, a czego pominąć, aby zaoszczędzić czas i utrzymać czytelność testów.

1. Zaimportuj niezbędne moduły z katalogów testowych projektu Dust — fabrykami z front/tests/utils/factories oraz narzędziami z front/tests/utils/utils. Użyj testowej bazy danych zamiast mockowania, aby testy były bliższe rzeczywistemu zachowaniu kodu.

2. Zidentyfikuj główną funkcjonalność pliku, który chcesz testować. Skupiaj się na najważniejszych ścieżkach wykonania i przypadkach brzegowych, które dają 80 procent wartości — pomiń kombinacje parametrów i mało prawdopodobne scenariusze.

3. Strukturyzuj test za pomocą wzorca Arrange-Act-Assert: najpierw przygotuj dane testowe używając fabryk (np. makeTestWorkspace, makeTestUser), następnie wykonaj testowaną funkcję, wreszcie zweryfikuj wynik za pomocą asercji.

4. Mockuj tylko zewnętrzne serwisy i API, nigdy nie mockuj bazy danych. Preferuj rzeczywiste implementacje, gdy to możliwe, aby testy były bardziej wiarygodne i łatwiejsze w utrzymaniu.

5. Testuj zachowanie kodu, a nie jego wewnętrzną implementację. Obejmij główne ścieżki sukcesu, najczęstsze warunki błędu, krytyczne przypadki brzegowe (null, undefined, puste tablice) oraz sprawdzenia uprawnień, jeśli są istotne.

6. Utrzymuj testy proste i zrozumiałe — każdy test powinien być łatwy do przeczytania i modyfikacji. Unikaj skomplikowanego setupu i zbędnych szczegółów implementacyjnych, które utrudniają zrozumienie celu testu.