Automatiseeritud üksus- ja integratsioonitestid
Sellel lehel
Testide kirjutamise automatiseerimine
Testid on esimene asi, millest ajapuuduses loobutakse, ja võlg, mis hiljem kõige kallimaks osutub. Codex muudab seda kompromissi: mooduli täieliku kaetuse genereerimine muutub minutite, mitte terve pärastlõuna küsimuseks. Kuid sa pead nõudma rohkemat kui lihtsalt „kirjuta testid“ – käsk, mis toodab vaid peotäie nominaalseid juhtumeid: rohelised, rahustavad ja väärtusetud.
Üksustestide genereerimine
Peamine hoob on piirjuhtude ise nimetamine. Sina tunned oma äridomeeni; agent ei tea, et soodustus üle 100% juhtub sinu andmetes vaid kord kvartalis.
"Generate unit tests for src/lib/pricing.ts.
Use Vitest. Cover all edge cases: negative price,
discount > 100%, invalid currency, zero quantity."
Codex analüüsib lähtekoodi, tuvastab eksporditud funktsioonid, mõistab nende loogikat ja loob seejärel komplekti, mis hõlmab nii tavapäraseid teid kui ka sinu mainitud juhtumeid.
// 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();
});
});
Üks detail väärib tähelepanu: oodatav veateade „Invalid price“ on võetud tegelikust implementatsioonist, mitte välja mõeldud. See on tunnusjoon testist, mis on kirjutatud koodi, mitte malli põhjal, ja esimene asi, mida genereeritud komplekti ülevaatamisel kontrollida.
Integratsioonitestide genereerimine
API marsruudi või andmebaasiga suhtleva teenuse puhul pead pakkuma rohkem konteksti, eriti seoses sellega, mida mockida.
"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 teeb selget vahet kahe testitaseme vahel: see konfigureerib sobivad mock-id, haldab testandmebaasi seadistamist ja lammutamist ning simuleerib väliseid teenuseid. Stripe’i ja supertest’i otsene nimetamine takistab sellel leiutamast paralleelset infrastruktuuri sellele, mida sinu meeskond juba kasutab.
Kogu projekti katmine
Projekti puhul, millest struktuurselt puuduvad testid, on globaalne ülesanne tõhusam kui failide kaupa esitatud päringute seeria.
"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 töötleb seejärel faile ükshaaval, kohandades teste iga mooduli jaoks; arvuta terve komplekti jaoks mitu minutit täitmisaega. Käivita see ülesanne ühe kaupa ühe kaustal, mitte kogu src/ kataloogil: sellest kaugemale muutub pull request ülevaatamiseks liiga suureks ja ilma lugemiseta heaks kiidetud testikomplekt ei kaitse kedagi.
Olemasolevate testide parandamine
Codex ei loo ainult, vaid suudab diagnoosida ka komplekti, mis rahustab, kuid ei kaitse.
"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."
Need kolm sümptomit seletavad enamikku rohelistest komplektidest, mis lasevad vigadel läbi hiilida. Kolmas on kõige salakavalam: testid, mis jagavad muudetavat olekut, õnnestuvad seni, kuni need jooksevad tavapärases järjekorras, ja hakkavad juhuslikult ebaõnnestuma päeval, mil lubad paralleelsuse.
Testid komponendi tüübi järgi
Tauletava testi tüüp sõltub otseselt koodi olemusest ja juhend muutub koos sellega.
| Koodi tüüp | Testi tüüp | Codexi juhend |
|---|---|---|
| Utiliidifunktsioon | Üksus | ”Testi kõiki võimalikke sisendeid ja väljundeid” |
| API marsruut | Integratsioon | ”Testi supertestiga, mocki väliseid teenuseid” |
| Reacti komponent | Renderdamine | ”Testi renderdamist ja interaktsioone Testing Libraryga” |
| Andmebaasiga teenus | Integratsioon | ”Kasuta testandmebaasi, lähtesta iga testi vahel” |
Konfigureeri AGENTS.md testide jaoks
Selle asemel, et korrata neid valikuid iga ülesande jaoks, kirjuta need üks kord ja kõik AGENTS.md faili spetsiaalsesse sektsiooni.
## 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)
Nende seitsme reaga rakendab Codex sinu kokkuleppeid igale genereeritavale testile, isegi kui kiirustav arendaja sõnastab oma päringu kolme sõnaga. See on kõige ökonoomsem viis muuta testide kvaliteet sõltumatuks juhendite kvaliteedist.
Peamised punktid
- Codex genereerib teste, mis on kohandatud sinu koodile, mitte üldisi teste
- Määra juhendites piirjuhtumid, mida soovid katta
- Codex teeb vahet üksus- ja integratsioonitestidel
- Kasuta AGENTS.md faili oma testimise kokkulepete defineerimiseks
- Codex suudab parandada olemasolevaid teste, mitte ainult luua uusi