Przejdź do głównej treści
Polski— Wybierz język
Menu

Zautomatyzowane testy jednostkowe i integracyjne

Lekcja 7 z 20 Zaktualizowano 29 lipca 2026 Programista
Na tej stronie
  1. Automatyzacja pisania testów
  2. Generowanie testów jednostkowych
  3. Generowanie testów integracyjnych
  4. Pokrycie całego projektu
  5. Ulepszanie istniejących testów
  6. Testy według typu komponentu
  7. Konfiguracja AGENTS.md dla testów
  8. Kluczowe wnioski

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 koduTyp testuInstrukcja dla Codex
Funkcja użytkowaJednostkowy„Przetestuj wszystkie możliwe dane wejściowe i wyjściowe“
Trasa APIIntegracyjny„Przetestuj za pomocą supertest, mockuj usługi zewnętrzne“
Komponent ReactRenderowanie„Przetestuj renderowanie i interakcje za pomocą Testing Library“
Usługa z bazą danychIntegracyjny„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