dust-test

Step-by-step guide for writing focused, practical tests for Dust codebases following the 80/20 principle.

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.