Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Automatizované unit a integrační testy

Lekce 7 z 20 Aktualizováno 29. července 2026 Vývojář
Na této stránce
  1. Automatizuj psaní testů
  2. Generuj unit testy
  3. Generuj integrační testy
  4. Pokryj celý projekt
  5. Vylepši existující testy
  6. Testy podle typu komponenty
  7. Nakonfiguruj AGENTS.md pro testy
  8. Klíčové poznatky

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óduTyp testuInstrukce pro Codex
Pomocná funkceUnit„Otestuj všechny možné vstupy a výstupy“
API routeIntegrační„Otestuj se supertest, mockuj externí služby“
React komponentaRenderování„Otestuj renderování a interakce s Testing Library“
Služba s DBIntegrač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é