Automatizované unit a integračné testy
Na tejto strane
Automatizuj písanie testov
Testy sú prvou vecou, ktorú vynecháš, keď dochádza čas, no práve ony ťa neskôr stoja najviac. Codex mení tento kompromis: vytvorenie úplného pokrytia pre modul sa stáva otázkou minút namiesto celého popoludnia. Musíš však žiadať viac než len „napíš testy“, čo je inštrukcia, ktorá vygeneruje len zopár nominálnych prípadov – zelené, upokojujúce a bezcenné.
Generuj unit testy
Hlavnou pákou je, aby si hraničné prípady pomenoval sám. Ty poznáš svoju business doménu; agent nevie, že zľava vyššia ako 100 % sa vo tvojich dátach vyskytne raz za štvrťrok.
"Generate unit tests for src/lib/pricing.ts.
Use Vitest. Cover all edge cases: negative price,
discount > 100%, invalid currency, zero quantity."
Codex analyzuje zdrojový kód, identifikuje exportované funkcie, pochopí ich logiku a následne vytvorí sadu testov, ktorá pokrýva bežné cesty aj prípady, ktoré si uviedol.
// 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 detail si zaslúži pozornosť: očakávaná chybová správa „Invalid price“ bola prevzatá priamo z implementácie, nie vymyslená. Toto je znakom testu napísaného na základe kódu, nie šablóny, a prvou vecou, ktorú treba skontrolovať pri recenzii vygenerovanej sady testov.
Generuj integračné testy
Pre API route alebo službu, ktorá pracuje s databázou, musíš poskytnúť viac kontextu, najmä pokiaľ ide o to, čo sa má mockovať.
"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 jasne rozlišuje medzi týmito dvoma úrovňami testovania: nakonfiguruje vhodné mocky, postará sa o nastavenie a teardown testovacej databázy a simuluje externé služby. Explicitné pomenovanie Stripe a supertest zabráni tomu, aby si vymyslel paralelnú infraštruktúru k tej, ktorú už tvoj tím používa.
Pokryj celý projekt
Pri projekte, ktorý štrukturálne postráda testy, je globálna úloha efektívnejšia než séria požiadaviek súbor po súbore.
"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 následne spracuje súbory jeden po druhom a prispôsobí testy každému modulu; počítaj s niekoľkými minútami behu pre kompletnú sadu. Túto úlohu spúšťaj radšej priebežne na jednotlivé priečinky než na celý adresár src/. Nad rámec toho sa pull request stane príliš veľkým na recenzovanie a sada testov schválená bez prečítania nikoho neochráni.
Vylepši existujúce testy
Codex nielen tvorí, ale dokáže aj diagnostikovať sadu testov, ktorá síce upokojuje, no nechráni.
"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."
Tieto tri symptómy vysvetľujú väčšinu zelených sád testov, ktoré prepúšťajú chyby. Tretí je najzákernejší: testy zdieľajúce mutovateľný stav prechádzajú, pokiaľ bežia v obvyklom poradí, a začnú náhodne zlyhávať v deň, keď povolíš paralelizáciu.
Testy podľa typu komponentu
Typ testu, ktorý máš požadovať, priamo závisí od povahy kódu a inštrukcia sa tomu prispôsobuje.
| Typ kódu | Typ testu | Inštrukcia pre Codex |
|---|---|---|
| Pomocná funkcia | Unit | ”Test all possible inputs and outputs” |
| API route | Integračný | ”Test with supertest, mock external services” |
| React komponent | Renderovanie | ”Test rendering and interactions with Testing Library” |
| Služba s DB | Integračný | ”Use a test DB, reset between each test” |
Nakonfiguruj AGENTS.md pre testy
Namiesto opakovaného zadávania týchto volieb pri každej úlohe ich zapíš raz a navždy do vyhradenej sekcie v súbore 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)
Vďaka týmto siedmim riadkom aplikuje Codex tvoje konvencie na každý generovaný test, aj keď unavený vývojár formuluje svoju požiadavku len tromi slovami. Toto je najekonomickejší spôsob, ako zabezpečiť, aby kvalita tvojich testov nezávisela od kvality inštrukcií.
Kľúčové poznatky
- Codex generuje testy prispôsobené tvojmu kódu, nie všeobecné testy
- V inštrukciách špecifikuj hraničné prípady, ktoré chceš pokryť
- Codex rozlišuje medzi unit testami a integračnými testami
- Použi AGENTS.md na definovanie svojich testovacích konvencií
- Codex dokáže vylepšiť existujúce testy, nielen vytvárať nové