Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Automatski unit i integracijski testovi

Lekcija 7 od 20 Ažurirano 29. srpnja 2026. Programer
Na ovoj stranici
  1. Automatiziraj pisanje testova
  2. Generiraj unit testove
  3. Generiraj integracijske testove
  4. Pokrij cijeli projekt
  5. Poboljšaj postojeće testove
  6. Testovi po vrsti komponente
  7. Konfiguriraj AGENTS.md za testove
  8. Ključne točke

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 kodaVrsta testaCodex instrukcija
Pomoćna funkcijaUnit”Test all possible inputs and outputs”
API rutaIntegracijski”Test with supertest, mock external services”
React komponentaRenderiranje”Test rendering and interactions with Testing Library”
Servis s bazomIntegracijski”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