writing-tests

Comprehensive guide for writing unit tests, integration tests, and component tests in AiderDesk using Vitest. Use when creating new tests, configuring mocks, or organizing test files.

1. Zainstaluj umiejętność w swoim projekcie AiderDesk, dodając ją do katalogu .aider-desk/skills/. Sprawdź, czy masz zainstalowane Vitest i React Testing Library w zależnościach projektu.

2. Utwórz nowy plik testowy w odpowiedniej lokalizacji — dla testów jednostkowych użyj src/common/__tests__/utils/, dla testów komponentów src/renderer/__tests__/. Nazwij plik z sufiksem .test.ts lub .test.tsx.

3. Napisz test, importując funkcje z Vitest (describe, it, expect) i testowaną funkcję lub komponent. Dla testów jednostkowych skupiaj się na czystych funkcjach i logice, dla komponentów testuj interakcje użytkownika i props.

4. Jeśli testujesz kod z zależnościami, użyj vi.mock() do mockowania modułów. Umiejętność zawiera przewodniki po fabrykom mocków i wzorcach API w pliku references/mocking-guide.md.

5. Uruchom testy poleceniem npm run test. Jeśli test się nie powiedzie, przeczytaj komunikat błędu, sprawdź konfigurację mocków i ścieżki importów. Do debugowania użyj screen.debug() w testach komponentów lub uruchom pojedynczy test: npm run test:node -- --no-color -t "nazwa testu".

6. Zweryfikuj pokrycie kodu poleceniem npm run test:coverage, aby upewnić się, że nowy kod jest testowany. Szczegółowe informacje o organizacji testów, poleceniach CLI i best practices znajdziesz w plikach referencyjnych umiejętności.