Automatizované unit a integrační testy
Na této stránce
Automatizuj psaní testů
Testy jsou první věc, kterou škrtnete, když dochází čas, a dluh, který vás později stojí nejvíc. Codex mění poměr rizika a přínosu: vygenerování plného pokrytí pro modul se stane otázkou minut místo celého odpoledne. Musíš ale požádat o víc než jen „napiš testy“, což je instrukce, která vyprodukuje hrstku nominálních případů – zelených, uklidňujících a k ničemu.
Generuj unit testy
Hlavní pákou je, že hraniční případy pojmenuješ sám. Znáš svou business doménu; agent neví, že sleva větší než 100 % se ve tvých datech objeví jen jednou za čtvrtletí.
"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é funkce, pochopí jejich logiku a následně vytvoří sadu testů, která pokryje jak běžné cesty, tak tebou uvedené případy.
// 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 zaslouží pozornost: očekávaná chybová zpráva „Invalid price“ byla převzata ze skutečné implementace, nevymyšlena. To je podpis testu napsaného na základě kódu, nikoliv šablony, a první věc, kterou musíš zkontrolovat při revizi vygenerované sady testů.
Generuj integrační testy
U API routy nebo služby, která sahá do databáze, musíš poskytnout více kontextu, zejména ohledně toho, co mockovat.
"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 jasně rozlišuje mezi těmito dvěma úrovněmi testů: nakonfiguruje vhodné mocky, zajistí nastavení a úklid testovací databáze a simuluje externí služby. Explicitní uvedení Stripe a supertest mu zabrání vymýšlet paralelní infrastrukturu k té, kterou váš tým již používá.
Pokryj celý projekt
U projektu, který strukturálně postrádá testy, je globální úkol efektivnější než série požadavků soubor po souboru.
"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 poté zpracuje soubory jeden po druhém a přizpůsobí testy každému modulu; počítej s několika minutami běhu pro kompletní sadu. Spusť tento úkol vždy jen na jedné složce najednou, nikoliv na celém adresáři src/. Přesáhneš-li tuto hranici, pull request bude příliš velký na revizi a sada testů schválená bez přečtení nikoho neochrání.
Vylepši existující testy
Codex nejen tvoří, ale dokáže také diagnostikovat sadu testů, která uklidňuje, ale nechrání.
"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."
Tyto tři symptomy vysvětlují většinu zelených sad testů, které propouští chyby. Ta třetí je nejzákeřnější: testy sdílející mutabilní stav projdou, dokud běží v obvyklém pořadí, a začnou náhodně selhávat ve chvíli, kdy povolíte paralelizaci.
Testy podle typu komponenty
Typ testu, o který požádáš, přímo závisí na povaze kódu a instrukce se tomu přizpůsobuje.
| Typ kódu | Typ testu | Instrukce pro Codex |
|---|---|---|
| Pomocná funkce | Unit | „Otestuj všechny možné vstupy a výstupy“ |
| API route | Integrační | „Otestuj se supertest, mockuj externí služby“ |
| React komponenta | Renderování | „Otestuj renderování a interakce s Testing Library“ |
| Služba s DB | Integrační | „Použij testovací DB, resetuj mezi každým testem“ |
Nakonfiguruj AGENTS.md pro testy
Místo opakování těchto voleb pro každý úkol je zapiš jednou provždy do vyhrazené sekce v souboru 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)
Díky těmto sedmi řádkům aplikuje Codex tvé konvence na každý vygenerovaný test, i když ve spěchu formulovaný vývojář zadá požadavek třemi slovy. Je to nejúspornější způsob, jak zajistit, aby kvalita tvých testů nezávisela na kvalitě instrukcí.
Klíčové poznatky
- Codex generuje testy přizpůsobené tvému kódu, nikoliv obecné testy
- V instrukcích specifikuj hraniční případy, které chceš pokrýt
- Codex rozlišuje mezi unit testy a integračními testy
- Použij AGENTS.md k definování svých konvencí pro testování
- Codex dokáže vylepšit existující testy, nejen vytvářet nové