Automatiniai vienetų ir integracijos testai
Šiame puslapyje
Automatizuok testų rašymą
Testai yra pirmas dalykas, kurio atsisakai, kai trūksta laiko, tačiau vėliau tai tampa brangiausia technine skola. Codex keičia šį balansą: pilno padengimo sukūrimas moduliui tampa minučių, o ne visos popietės užduotimi. Tačiau turi prašyti daugiau nei tiesiog „parašyk testus“, nes toks nurodymas sugeneruoja tik keletą nominalių atvejų – jie praeina, nuramina, bet yra beverčiai.
Generuok vienetų testus
Pagrindinis svertas – pačiam įvardyti ribinius atvejus. Tu pažįsti savo dalykinę sritį; agentas nežino, kad nuolaida, didesnė nei 100 %, tavo duomenyse pasitaiko tik kartą per ketvirtį.
"Generate unit tests for src/lib/pricing.ts.
Use Vitest. Cover all edge cases: negative price,
discount > 100%, invalid currency, zero quantity."
Codex analizuoja šaltinio kodą, identifikuoja eksportuojamas funkcijas, supranta jų logiką ir tada sukuria testų rinkinį, apimantį tiek įprastus scenarijus, tiek tavo nurodytus atvejus.
// 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 detalė nusipelno dėmesio: tikėtinas klaidos pranešimas „Invalid price“ buvo paimtas iš realios implementacijos, o ne sugalvotas. Tai yra testų, parašytų remiantis kodu, o ne šablonu, požymis ir pirmas dalykas, kurį reikia patikrinti peržiūrint sugeneruotą testų rinkinį.
Generuok integracijos testus
API maršrutui arba servisui, kuris dirba su duomenų baze, reikia pateikti daugiau konteksto, ypač dėl to, ką reikia imituoti (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 aiškiai atskiria šiuos du testų lygmenis: jis sukonfigūruoja tinkamus imitavimus, tvarko testinės duomenų bazės nustatymą ir išvalymą bei simuliuoja išorinius servisus. Aiškus „Stripe“ ir „supertest“ įvardijimas neleidžia jam išgalvoti paralelinės infrastruktūros, kuri skirtųsi nuo tos, kurią jau naudoja tavo komanda.
Padengk visą projektą
Projektuose, kuriuose iš esmės trūksta testų, globali užduotis yra efektyvesnė nei prašymų serija failas po failo.
"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%."
Tuomet Codex apdoroja failus vieną po kito, pritaikydamas testus kiekvienam moduliui; viso rinkinio vykdymas gali užtrukti kelias minutes. Vykdyk šią užduotį vienam aplankui vienu metu, o ne visam src/ katalogui: antraip „pull request“ taps per didelis peržiūrėti, o be perskaitymo patvirtintas testų rinkinis nieko neapsaugo.
Tobulink esamus testus
Codex ne tik kuria, bet ir gali diagnozuoti testų rinkinį, kuris nuramina, bet neapsaugo.
"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 trys simptomai paaiškina daugumą „žalių“ testų rinkinių, kurie praleidžia klaidas. Trečiasis yra klastingiausias: testai, bendrinantys kintamą būseną, praeina tol, kol vykdomi įprasta tvarka, ir pradeda atsitiktinai žlugti tą dieną, kai įjungiamas lygiagretus vykdymas.
Testai pagal komponento tipą
Reikalingo testo tipas tiesiogiai priklauso nuo kodo pobūdžio, todėl ir nurodymas keičiasi.
| Kodo tipas | Testo tipas | Codex nurodymas |
|---|---|---|
| Pagalbinė funkcija | Vienetų | ”Test all possible inputs and outputs” |
| API maršrutas | Integracijos | ”Test with supertest, mock external services” |
| React komponentas | Atvaizdavimo | ”Test rendering and interactions with Testing Library” |
| Servisas su DB | Integracijos | ”Use a test DB, reset between each test” |
Suconfigūruok AGENTS.md testams
Užuot kartojęs šiuos pasirinkimus kiekvienai užduočiai, vieną kartą ir visiems laikams įrašyk juos į atskirą „AGENTS.md“ failo skyrių.
## 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)
Šių septynių eilučių dėka Codex taikys tavo konvencijas kiekvienam sugeneruotam testui, net jei skubantis kūrėjas savo prašymą suformuluos trimis žodžiais. Tai ekonomiškiausias būdas užtikrinti, kad testų kokybė nepriklausytų nuo nurodymų kokybės.
Svarbiausi punktai
- Codex generuoja testus, pritaikytus tavo kodui, o ne bendro pobūdžio testus
- Nurodymuose specifikuok ribinius atvejus, kuriuos nori padengti
- Codex atskiria vienetų ir integracijos testus
- Naudok „AGENTS.md“ savo testavimo konvencijoms apibrėžti
- Codex gali ne tik kurti naujus, bet ir tobulinti esamus testus