Automatski unit i integracijski testovi
Na ovoj stranici
Automatiziraj pisanje testova
Testovi su prva stvar koju žrtvuješ kad ponestane vremena, a dug koji kasnije najskuplje plaćaš. Codex mijenja tu računicu: generiranje pune pokrivenosti za modul postaje pitanje minuta, a ne cijelog poslijepodneva. No, moraš tražiti više od napuke „napiši testove“, jer takva instrukcija daje samo šačicu nominalnih slučajeva – zelenih, umirujućih i bezvrijednih.
Generiraj unit testove
Glavna poluga je da sam imenuješ rubne slučajeve. Ti poznaješ svoju poslovnu domenu; agent ne zna da se popust veći od 100 % u tvojim podacima događa jednom kvartalno.
"Generate unit tests for src/lib/pricing.ts.
Use Vitest. Cover all edge cases: negative price,
discount > 100%, invalid currency, zero quantity."
Codex analizira izvorni kod, identificira izvezene funkcije, razumije njihovu logiku, a zatim proizvodi skup testova koji pokriva i normalne putanje i slučajeve koje si naveo/la.
// 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();
});
});
Jedan detalj zaslužuje provjeru: očekivana poruka greške, „Invalid price“, preuzeta je iz stvarne implementacije, a ne izmišljena. To je potpis testa napisanog na temelju koda, a ne predloška, i prva stvar koju trebaš provjeriti pri pregledu generiranog skupa testova.
Generiraj integracijske testove
Za API rutu ili servis koji dira bazu podataka, moraš pružiti više konteksta, posebno oko toga što treba mockirati.
"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 jasno razlikuje ove dvije razine testiranja: konfigurira odgovarajuće mockove, rukuje postavkom i čišćenjem testne baze podataka te simulira vanjske servise. Eksplicitno imenovanje Stripea i supertest sprječava ga da izmišlja paralelnu infrastrukturu onome što tvoj tim već koristi.
Pokrij cijeli projekt
Na projektu koji strukturno nema testove, globalni zadatak učinkovitiji je od niza zahtjeva datoteka po datoteku.
"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 zatim obrađuje datoteke jednu po jednu, prilagođavajući testove svakom modulu; računaj s nekoliko minuta izvršavanja za kompletan skup. Pokreni ovaj zadatak na jednu mapu odjednom, a ne na cijeli direktorij src/: izvan toga, pull request postaje prevelik za pregled, a skup testova odobren bez čitanja ne štiti nikoga.
Poboljšaj postojeće testove
Codex ne samo da stvara; može i dijagnosticirati skup testova koji umiruje, ali ne štiti.
"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."
Ova tri simptoma objašnjavaju većinu zelenih skupova testova koji propuštaju greške. Treći je najpodmukliji: testovi koji dijele promjenjivo stanje prolaze sve dok se izvršavaju u uobičajenom redoslijedu, a počinju nasumično padati onog dana kad uključiš paralelizaciju.
Testovi po vrsti komponente
Vrsta testa koju trebaš zatražiti izravno ovisi o prirodi koda, a s njom se mijenja i instrukcija.
| Vrsta koda | Vrsta testa | Codex instrukcija |
|---|---|---|
| Pomoćna funkcija | Unit | ”Test all possible inputs and outputs” |
| API ruta | Integracijski | ”Test with supertest, mock external services” |
| React komponenta | Renderiranje | ”Test rendering and interactions with Testing Library” |
| Servis s bazom | Integracijski | ”Use a test DB, reset between each test” |
Konfiguriraj AGENTS.md za testove
Umjesto ponavljanja ovih izbora za svaki zadatak, zapiši ih jednom zauvijek u namjenski odjeljak datoteke 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)
S ovih sedam redaka, Codex primjenjuje tvoje konvencije na svaki test koji generira, čak i kada užurbani programer svoj zahtjev sroči u tri riječi. To je najekonomičniji način da kvaliteta tvojih testova postane neovisna o kvaliteti instrukcije.
Ključne točke
- Codex generira testove prilagođene tvom kodu, a ne generičke testove
- U svojim instrukcijama specificiraj rubne slučajeve koje želiš pokriti
- Codex razlikuje unit testove i integracijske testove
- Koristi AGENTS.md za definiranje svojih konvencija testiranja
- Codex može poboljšati postojeće testove, a ne samo stvarati nove