Automatizált egység- és integrációs tesztek
Ezen az oldalon
A tesztek írásának automatizálása
A tesztek az elsők, amelyeket időhiány esetén kihagysz, mégis ez a technikai tartozás kerül a legdrágábban a későbbiekben. A Codex megváltoztatja ezt az egyenletet: egy modul teljes lefedettségének generálása percek kérdése lesz ahelyett, hogy egy egész délutánt venne igénybe. De többet kell kérned annál, hogy „írj teszteket“, mert egy ilyen utasítás csak néhány névleges esetet eredményez – zöldek, megnyugtatóak, de értéktelenek.
Egységtesztek generálása
A fő eszköz az, ha te magad nevezed meg a szélsőséges eseteket (edge cases). Te ismered az üzleti domainedet; az ágens nem tudja, hogy a te adataid között negyedévente egyszer fordul elő 100%-ot meghaladó kedvezmény.
"Generate unit tests for src/lib/pricing.ts.
Use Vitest. Cover all edge cases: negative price,
discount > 100%, invalid currency, zero quantity."
A Codex elemzi a forráskódot, azonosítja az exportált függvényeket, megérti a logikájukat, majd olyan tesztsorozatot állít elő, amely lefedi mind a normál útvonalakat, mind az általad megnevezett eseteket.
// 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();
});
});
Egy részlet alapos vizsgálatot érdemel: a várt hibaüzenet, az „Invalid price“, magát a megvalósítást tükrözi, nem pedig kitalálták. Ez annak a jele, hogy a tesztet a kódból kiindulva írták, nem pedig egy sablon alapján, és ez az első dolog, amit ellenőrizned kell egy generált tesztsorozat átnézésekor.
Integrációs tesztek generálása
Egy API útvonal vagy egy adatbázist érintő szolgáltatás esetén több kontextust kell biztosítanod, különösen azt illetően, hogy mit kell mockolni.
"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."
A Codex egyértelműen különbséget tesz a két tesztszint között: megfelelő mockokat konfigurál, kezeli a tesztadatbázis előkészítését és lebontását, valamint szimulálja a külső szolgáltatásokat. A Stripe és a supertest explicit megnevezése megakadályozza, hogy a csapatod által már használt infrastruktúrával párhuzamos, kitalált megoldásokat vezessen be.
Egy teljes projekt lefedése
Olyan projekteknél, amelyek strukturálisan nélkülözik a teszteket, egy globális feladat hatékonyabb, mint a fájlonkénti kérések sorozata.
"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%."
A Codex ezután fájlonként dolgozza fel az állományokat, minden modulhoz igazítva a teszteket; egy teljes sorozat elkészítése több perc futási időt vehet igénybe. Ezt a feladatot mappánként futtasd, ne az egész src/ könyvtáron egyszerre: efölött a pull request túl nagy lesz az átnézéshez, és egy elolvasás nélkül jóváhagyott tesztsorozat senkit sem véd meg.
Meglévő tesztek javítása
A Codex nemcsak létrehoz, hanem diagnosztizálni is tud olyan tesztsorozatokat, amelyek megnyugtatnak, de nem védenek.
"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."
Ez a három tünet magyarázza a legtöbb olyan „zöld“ tesztsort, amelyen keresztülcsúsznak a hibák. A harmadik a legárulkodóbb: azok a tesztek, amelyek megosztható állapotot (mutable state) használnak, addig működnek, amíg a szokásos sorrendben futnak, de véletlenszerűen elkezdenek megbukni azon a napon, amikor bekapcsolod a párhuzamosítást.
Tesztek komponens típus szerint
A kérendő teszt típusa közvetlenül függ a kód természetétől, és az utasítás is ennek megfelelően változik.
| Kód típusa | Teszt típusa | Codex utasítás |
|---|---|---|
| Segédfüggvény | Egységteszt | ”Test all possible inputs and outputs” |
| API útvonal | Integrációs teszt | ”Test with supertest, mock external services” |
| React komponens | Renderelési teszt | ”Test rendering and interactions with Testing Library” |
| Adatbázissal rendelkező szolgáltatás | Integrációs teszt | ”Use a test DB, reset between each test” |
Az AGENTS.md konfigurálása tesztekhez
Ahelyett, hogy minden feladatnál megismételnéd ezeket a választásokat, írd le őket egyszer és mindenkorra az AGENTS.md fájl egy erre szánt szekciójában.
## 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)
Ezzel a hét sorral a Codex minden általa generált tesztre alkalmazni fogja a te konvencióidat, még akkor is, ha egy kapkodó fejlesztő csupán három szóban fogalmazza meg a kérését. Ez a leggazdaságosabb módja annak, hogy a tesztek minősége független legyen az utasítások minőségétől.
Főbb megállapítások
- A Codex a kódodhoz igazított teszteket generál, nem pedig általánosakat
- Az utasításaidban specifikáld a lefedni kívánt szélsőséges eseteket (edge cases)
- A Codex különbséget tesz az egység- és az integrációs tesztek között
- Használd az AGENTS.md fájlt a tesztelési konvencióid meghatározására
- A Codex képes a meglévő tesztek javítására is, nemcsak újak létrehozására