Avtomatizirano pisanje enotskih in integracijskih testov
Na tej strani
Avtomatiziraj pisanje testov
Testi so prva stvar, ki jo odrežeš, ko zmanjka časa, in dolg, ki kasneje stane največ. Codex spremeni razmerje med stroški in koristmi: ustvarjanje popolne pokritosti za modul postane zadeva minut namesto popoldneva. Vendar moraš zahtevati več kot le „napiši teste”, navodilo, ki vrže ven peščico nominalnih primerov – zelenih, pomirjujočih in brez vrednosti.
Generiraj enotske teste
Glavna vzvod je, da robne primere poimenuješ sam. Ti poznaš svojo poslovno domeno; agent ne ve, da se popust, večji od 100 %, v tvojih podatkih zgodi enkrat na četrtletje.
"Generate unit tests for src/lib/pricing.ts.
Use Vitest. Cover all edge cases: negative price,
discount > 100%, invalid currency, zero quantity."
Codex analizira izvorno kodo, identificira izvožene funkcije, razume njihovo logiko in nato proizvede nabor, ki pokriva tako normalne poti kot primere, ki si jih navedel.
// 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();
});
});
Ena podrobnost si zasluži pregled: pričakovano sporočilo o napaki „Invalid price” je bilo prevzeto iz dejanske implementacije, ne izmišljeno. To je podpis testa, napisanega na podlagi kode in ne predloge, ter prva stvar, ki jo je treba preveriti pri pregledu generiranega nabora.
Generiraj integracijske teste
Za pot API ali storitev, ki se dotika baze podatkov, moraš zagotoviti več konteksta, zlasti glede tega, kaj simulirati (mock).
"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 med obema ravnema testov: konfigurira ustrezne simulacije, obravnava nastavitev in pospravljanje testne baze podatkov ter simulira zunanje storitve. Izrecno imenovanje Stripe in supertest prepreči, da bi izumil vzporedno infrastrukturo tistemu, kar tvoja ekipa že uporablja.
Pokrij celoten projekt
Pri projektu, ki strukturno nima testov, je globalna naloga učinkovitejša od niza zahtev datoteka za datoteko.
"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 nato obdela datoteke eno za drugo in prilagodi teste vsakemu modulu; za popoln nabor prištej nekaj minut izvajanja. To nalogo zaženi na eno mapo naenkrat in ne na celoten imenik src/: prek tega meja postane prevelika za pregled, testni nabor, odobren brez branja, pa ne ščiti nikogar.
Izboljšaj obstoječe teste
Codex ne le ustvarja; lahko tudi diagnosticira nabor, ki pomirja, a ne ščiti.
"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."
Ti trije simptomi pojasnjujejo večino zelenih naborov, ki prepustijo hrošče skozi mrežo. Tretji je najbolj zahrbtn: testi, ki si delijo spremenljivo stanje, uspejo, dokler tečejo v običajnem vrstnem redu, in začnejo naključno odpovedovati dan, ko omogočiš vzporedno izvajanje.
Testi po vrsti komponente
Vrsta testa, ki jo moraš zahtevati, je neposredno odvisna od narave kode, in navodilo se spreminja z njo.
| Vrsta kode | Vrsta testa | Navodilo za Codex |
|---|---|---|
| Pomožna funkcija | Enotski | „Testiraj vse možne vhode in izhode” |
| Pot API | Integracijski | „Testiraj s supertest, simuliraj zunanje storitve” |
| Komponenta React | Upodabljanje | „Testiraj upodabljanje in interakcije s Testing Library” |
| Storitev z bazo podatkov | Integracijski | „Uporabi testno bazo, ponastavi med vsakim testom” |
Konfiguriraj AGENTS.md za teste
Namesto da bi te izbire ponavljal za vsako nalogo, jih zapiši enkrat za vselej v namenski razdelek 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 temi sedmimi vrsticami Codex uporabi tvoje konvencije za vsak test, ki ga generira, tudi ko nagljen razvijalec svojo zahtevo oblikuje v treh besedah. To je najbolj ekonomičen način, da kakovost tvojih testov postane neodvisna od kakovosti navodil.
Ključne ugotovitve
- Codex generira teste, prilagojene tvoji kodi, ne generičnih testov
- V svojih navodilih določi robne primere, ki jih želiš pokriti
- Codex razlikuje med enotskimi testi in integracijskimi testi
- Uporabi AGENTS.md za opredelitev svojih konvencij testiranja
- Codex lahko izboljša obstoječe teste, ne le ustvarja novih