Teste unitare și de integrare automate
Pe această pagină
Automatizarea scrierii testelor
Testele sunt primele elemente pe care le sacrificați când timpul lipsește, iar datoria tehnică rezultată este cea mai costisitoare pe termen lung. Codex schimbă raportul de forțe: generarea unei acoperiri complete pentru un modul devine o chestiune de minute, nu o întreagă după-amiază. Totuși, trebuie să cereți mai mult decât un simplu „scrie teste“, o instrucțiune care produce doar câteva cazuri nominale – verzi, liniștitoare, dar inutile.
Generarea testelor unitare
Pârghia principală constă în definirea manuală a cazurilor limită. Dumneavoastră cunoașteți domeniul de activitate; agentul nu știe că o reducere mai mare de 100% apare o dată pe trimestru în datele dumneavoastră.
"Generate unit tests for src/lib/pricing.ts.
Use Vitest. Cover all edge cases: negative price,
discount > 100%, invalid currency, zero quantity."
Codex analizează codul sursă, identifică funcțiile exportate, înțelege logica lor și produce apoi o suită care acoperă atât căile normale, cât și cazurile pe care le-ați menționat.
// 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();
});
});
Un detaliu merită inspectat: mesajul de eroare așteptat, „Invalid price“, a fost preluat din implementarea reală, nu inventat. Aceasta este semnătura unui test scris pe baza codului, nu a unui șablon, și primul lucru de verificat atunci când revizuiți o suită generată.
Generarea testelor de integrare
Pentru o rută API sau un serviciu care interacționează cu baza de date, trebuie să furnizați mai mult context, în special privind ce anume trebuie simulat (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 distinge clar între cele două niveluri de testare: configurează simulările (mocks) adecvate, gestionează inițializarea și curățarea bazei de date de test și simulează serviciile externe. Menționarea explicită a Stripe și supertest îl împiedică să inventeze o infrastructură paralelă cu cea pe care echipa dumneavoastră o utilizează deja.
Acoperirea unui întreg proiect
În cazul unui proiect care suferă structural de lipsa testelor, o sarcină globală este mai eficientă decât o serie de cereri fișier cu fișier.
"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 procesează apoi fișierele unul câte unul, adaptând testele la fiecare modul; calculați câteva minute de execuție pentru o suită completă. Rulați această sarcină câte un folder o dată, nu pe întregul director src/: dincolo de această limită, pull request-ul devine prea voluminos pentru a fi revizuit, iar o suită de teste aprobată fără a fi citită nu protejează pe nimeni.
Îmbunătățirea testelor existente
Codex nu doar creează; poate, de asemenea, să diagnosticheze o suită care liniștește fără a proteja.
"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."
Aceste trei simptome explică majoritatea suitelor „verzi“ care lasă bug-urile să treacă neobservate. Al treilea este cel mai insidios: testele care partajează stare mutabilă reușesc atâta timp cât rulează în ordinea obișnuită și încep să eșueze aleatoriu în ziua în care activați paralelizarea.
Teste pe tipuri de componente
Tipul de test pe care trebuie să îl solicitați depinde direct de natura codului, iar instrucțiunea se modifică în consecință.
| Tip de cod | Tip de test | Instrucțiune Codex |
|---|---|---|
| Funcție utilitară | Unitar | „Testează toate intrările și ieșirile posibile“ |
| Rută API | Integrare | „Testează cu supertest, simulează serviciile externe“ |
| Componentă React | Randare | „Testează randarea și interacțiunile cu Testing Library“ |
| Serviciu cu BD | Integrare | „Folosește o BD de test, resetează între fiecare test“ |
Configurarea AGENTS.md pentru teste
În loc să repetați aceste alegeri pentru fiecare sarcină, scrieți-le o singură dată într-o secțiune dedicată din 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)
Cu aceste șapte linii, Codex aplică convențiile dumneavoastră fiecărui test pe care îl generează, chiar și atunci când un dezvoltator grăbit formulează cererea în trei cuvinte. Aceasta este cea mai economică metodă de a face ca calitatea testelor dumneavoastră să fie independentă de calitatea instrucțiunilor.
Puncte cheie
- Codex generează teste adaptate codului dumneavoastră, nu teste generice
- Specificați cazurile limită pe care doriți să le acoperiți în instrucțiuni
- Codex face distincția între testele unitare și cele de integrare
- Utilizați AGENTS.md pentru a defini convențiile de testare
- Codex poate îmbunătăți testele existente, nu doar să creeze unele noi