Automatizēti vienību un integrācijas testi
Šajā lapā
Automatizē testu rakstīšanu
Testi ir pirmā lieta, no kuras atsakies, kad pietrūkst laika, taču tie ir parāds, kas vēlāk izmaksā visdārgāk. Codex maina šo līdzsvaru: pilnīga pārklājuma ģenerēšana modulim kļūst par minūšu, nevis pēcpusdienas darbu. Taču tev ir jāprasa vairāk nekā tikai „uzraksti testus”, jo šāda instrukcija radīs tikai dažus nominālos gadījumus — zaļus, nomierinošus, bet bezvērtīgus.
Ģenerē vienību testus
Galvenais instruments ir pašam nosaukt robežgadījumus. Tu pazīsti savu biznesa domēnu; aģents nezina, ka atlaide, kas pārsniedz 100 %, taviem datiem rodas tikai reizi ceturksnī.
"Generate unit tests for src/lib/pricing.ts.
Use Vitest. Cover all edge cases: negative price,
discount > 100%, invalid currency, zero quantity."
Codex analizē pirmkodu, identificē eksportētās funkcijas, saprot to loģiku un pēc tam izveido kopu, kas aptver gan normālos ceļus, gan tavus minētos gadījumus.
// 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();
});
});
Viena detaļa ir pelnījusi uzmanību: sagaidāmais kļūdas ziņojums „Invalid price” ir ņemts tieši no faktiskās implementācijas, nevis izgudrots. Šī ir pazīme testam, kas rakstīts, balstoties uz kodu, nevis uz šablonu, un tas ir pirmais, kas jāpārbauda, recenzējot ģenerētu testu kopu.
Ģenerē integrācijas testus
API maršrutam vai servisam, kas strādā ar datubāzi, tev ir jāsniedz vairāk konteksta, jo īpaši attiecībā uz to, kas ir jāmocko.
"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 skaidri nošķir abus testu līmeņus: tas konfigurē atbilstošus mockus, nodrošina testa datubāzes sagatavošanu un attīrīšanu, kā arī simulē ārējos servisus. Tieša Stripe un supertest nosaukšana novērš to, ka tas izgudro paralēlu infrastruktūru tam, ko tava komanda jau izmanto.
Aptver visu projektu
Projektam, kurā strukturāli trūkst testu, globāls uzdevums ir efektīvāks nekā virkne pieprasījumu fails pēc faila.
"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 pēc tam apstrādā failus pa vienam, pielāgojot testus katram modulim; rēķinies ar vairākām minūtēm izpildes laikam pilnai kopai. Palaids šo uzdevumu pa vienai mapei, nevis visai src/ direktorijai: pārsniedzot šo robežu, pull request kļūst pārāk liels, lai to recenzētu, un testu kopa, kas apstiprināta to nelasot, neaizsargā nevienu.
Uzlabo esošos testus
Codex ne tikai rada jaunu, bet spēj arī diagnosticēt testu kopu, kas nomierina, bet neaizsargā.
"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."
Šie trīs simptomi izskaidro lielāko daļu zaļo testu kopu, kas ļauj kļūdām izslīdēt cauri. Trešais ir visnodevīgākais: testi, kas koplieto maināmu stāvokli, izdodas, kamēr tie tiek izpildīti parastajā secībā, un sāk nejauši izgāzties tajā dienā, kad ieslēdz paralēlo izpildi.
Testi pēc komponenta veida
Pieprasāmā testa veids ir tieši atkarīgs no koda rakstura, un instrukcija mainās līdz ar to.
| Koda veids | Testa veids | Codex instrukcija |
|---|---|---|
| Utilītfunkcija | Vienība | ”Test all possible inputs and outputs” |
| API maršruts | Integrācija | ”Test with supertest, mock external services” |
| React komponents | Renderēšana | ”Test rendering and interactions with Testing Library” |
| Serviss ar DB | Integrācija | ”Use a test DB, reset between each test” |
Konfigurē AGENTS.md testiem
Tā vietā, lai šīs izvēles atkārtotu katram uzdevumam, ieraksti tās vienreiz un uz visiem laikiem dedicated sadaļā failā 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)
Ar šīm septiņām rindām Codex piemēro tavas konvencijas katram ģenerētajam testam, pat ja steigā esošs izstrādātājs savu pieprasījumu noformulē trīs vārdos. Tas ir ekonomiskākais veids, kā padarīt testu kvalitāti neatkarīgu no instrukciju kvalitātes.
Galvenās atziņas
- Codex ģenerē testus, kas pielāgoti tavam kodam, nevis vispārīgus testus
- Instrukcijās norādi robežgadījumus, kurus vēlies aptvert
- Codex nošķir vienību testus un integrācijas testus
- Izmanto AGENTS.md, lai definētu savas testēšanas konvencijas
- Codex spēj uzlabot esošos testus, ne tikai radīt jaunus