Zautomatyzowane testy jednostkowe i integracyjne
Na tej stronie
Automatyzacja pisania testów
Testy to pierwsza rzecz, z której rezygnujesz, gdy brakuje czasu, a później okazują się najdroższym długiem technicznym. Codex zmienia zasady gry: wygenerowanie pełnego pokrycia dla modułu zajmuje minuty, a nie całe popołudnie. Musisz jednak żądać czegoś więcej niż tylko „napisz testy“ – taka instrukcja zwróci garść przypadków nominalnych: zielonych, uspokajających i bezwartościowych.
Generowanie testów jednostkowych
Głównym dźwigniem jest samodzielne nazwanie przypadków brzegowych. Ty znasz swoją domenę biznesową; agent nie wie, że rabat większy niż 100% zdarza się w Twoich danych raz na kwartał.
"Generate unit tests for src/lib/pricing.ts.
Use Vitest. Cover all edge cases: negative price,
discount > 100%, invalid currency, zero quantity."
Codex analizuje kod źródłowy, identyfikuje eksportowane funkcje, rozumie ich logikę, a następnie tworzy zestaw testów obejmujący zarówno ścieżki standardowe, jak i przypadki, które wskazałeś.
// src/lib/pricing.test.ts
import { describe, it, expect } from "vitest";
import { calculatePrice, applyDiscount, formatPrice } from "./pricing";
describe("calculatePrice", () => {
it("calculates total price for a positive quantity", () => {
expect(calculatePrice(10, 3)).toBe(30);
});
it("returns 0 for a quantity of zero", () => {
expect(calculatePrice(10, 0)).toBe(0);
});
it("throws an error for a negative price", () => {
expect(() => calculatePrice(-5, 1)).toThrow("Invalid price");
});
});
describe("applyDiscount", () => {
it("applies a standard discount", () => {
expect(applyDiscount(100, 20)).toBe(80);
});
it("rejects a discount greater than 100%", () => {
expect(() => applyDiscount(100, 150)).toThrow();
});
});
Jeden szczegół wymaga uwagi: oczekiwana wiadomość błędu „Invalid price“ została zaczerpnięta z rzeczywistej implementacji, a nie wymyślona. To znak rozpoznawczy testu napisanego na podstawie kodu, a nie szablonu, i pierwsza rzecz, którą należy sprawdzić podczas recenzji wygenerowanego zestawu.
Generowanie testów integracyjnych
W przypadku tras API lub usług współpracujących z bazą danych musisz dostarczyć więcej kontekstu, zwłaszcza dotyczącego tego, co należy mockować.
"Generate integration tests for src/api/routes/orders.ts.
Use supertest for HTTP requests. Mock the Stripe
service with vi.mock. Test scenarios: order creation,
order with non-existent product, failed payment."
Codex wyraźnie rozróżnia te dwa poziomy testów: konfiguruje odpowiednie mocki, obsługuje inicjalizację i czyszczenie bazy danych testowej oraz symuluje usługi zewnętrzne. Jawne wymienienie Stripe i supertest zapobiega wymyślaniu przez niego infrastruktury równoległej do tej, której już używa Twój zespół.
Pokrycie całego projektu
W projekcie, który strukturalnie nie posiada testów, zadanie globalne jest skuteczniejsze niż seria próśb plik po pliku.
"Analyze all .ts files in src/lib/ and src/services/.
For each file without a corresponding .test.ts file,
generate unit tests. Aim for branch coverage > 80%."
Codex przetwarza wtedy pliki jeden po drugim, dostosowując testy do każdego modułu; wykonanie pełnego zestawu zajmie kilka minut. Uruchamiaj to zadanie folder po folderze, a nie na całym katalogu src/: poza tym pull request staje się zbyt duży do recenzji, a zestaw testów zatwierdzony bez przeczytania nikogo nie chroni.
Ulepszanie istniejących testów
Codex nie tylko tworzy, ale potrafi też zdiagnozować zestaw, który uspokaja, ale nie chroni.
"Analyze tests in src/__tests__/. Identify:
- Tests that check only one path (happy path)
- Vague assertions (toBeTruthy instead of toBe)
- Tests that share mutable state
Fix these issues."
Te trzy symptomy wyjaśniają większość zielonych zestawów, które przepuszczają błędy. Trzeci jest najbardziej podstępny: testy współdzielące stan zmienny przechodzą pomyślnie, dopóki uruchamiane są w zwykłej kolejności, a zaczynają losowo zawodzić w dniu, w którym włączysz paralelizację.
Testy według typu komponentu
Rodzaj testu, o który poprosisz, zależy bezpośrednio od natury kodu, a instrukcja zmienia się wraz z nim.
| Typ kodu | Typ testu | Instrukcja dla Codex |
|---|---|---|
| Funkcja użytkowa | Jednostkowy | „Przetestuj wszystkie możliwe dane wejściowe i wyjściowe“ |
| Trasa API | Integracyjny | „Przetestuj za pomocą supertest, mockuj usługi zewnętrzne“ |
| Komponent React | Renderowanie | „Przetestuj renderowanie i interakcje za pomocą Testing Library“ |
| Usługa z bazą danych | Integracyjny | „Użyj bazy danych testowej, resetuj ją między każdym testem“ |
Konfiguracja AGENTS.md dla testów
Zamiast powtarzać te wybory przy każdym zadaniu, zapisz je raz na zawsze w dedykowanej sekcji pliku AGENTS.md.
## Tests
- Framework: Vitest
- Command: `npm run test`
- Coverage: `npm run test:coverage`
- Convention: .test.ts files next to source code
- Mocks: use vi.mock(), no manual mocks
- Assertions: prefer toBe/toEqual over toBeTruthy/toBeFalsy
- Each test must be independent (no shared state)
Dzięki tym siedmiu liniom Codex zastosuje Twoje konwencje do każdego generowanego testu, nawet gdy zabiegany programista sformułuje swoje żądanie w trzech słowach. To najbardziej ekonomiczny sposób, aby jakość testów była niezależna od jakości instrukcji.
Kluczowe wnioski
- Codex generuje testy dostosowane do Twojego kodu, a nie testy generyczne
- W instrukcjach określaj przypadki brzegowe, które chcesz pokryć
- Codex rozróżnia testy jednostkowe i integracyjne
- Użyj pliku AGENTS.md, aby zdefiniować swoje konwencje testowe
- Codex potrafi ulepszać istniejące testy, a nie tylko tworzyć nowe