Automatiserade enhets- och integrationstester
På denna sida
Automatisera testskrivning
Tester är det första du stryker när tiden tryter, och den tekniska skuld som kostar mest i efterhand. Codex ändrar förutsättningarna: att generera full täckning för en modul blir en fråga om minuter snarare än en eftermiddag. Men du måste begära mer än bara « skriv tester », en instruktion som ofta ger ett fåtal nominella fall – gröna, lugnande och värdelösa.
Generera enhetstester
Den viktigaste hävstången är att du själv namnger kantfallen. Du känner din affärsdomän; agenten vet inte att en rabatt på över 100 % bara inträffar en gång per kvartal i dina data.
"Generate unit tests for src/lib/pricing.ts.
Use Vitest. Cover all edge cases: negative price,
discount > 100%, invalid currency, zero quantity."
Codex analyserar källkoden, identifierar exporterade funktioner, förstår deras logik och producerar sedan en svit som täcker både normala flöden och de fall du angivit.
// 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();
});
});
En detalj förtjänar granskning: det förväntade felmeddelandet, « Invalid price », hämtades från den faktiska implementationen, inte hittat på. Detta är kännetecknet på ett test skrivet utifrån koden snarare än från en mall, och det första du bör kontrollera när du granskar en genererad svit.
Generera integrationstester
För en API-rutt eller en tjänst som interagerar med databasen måste du tillhandahålla mer kontext, särskilt gällande vad som ska mockas.
"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 skiljer tydligt mellan de två testnivåerna: det konfigurerar lämpliga mockar, hanterar inställning och nedstängning av testdatabasen samt simulerar externa tjänster. Genom att explicit nämna Stripe och supertest förhindrar du att det hittar på parallell infrastruktur till det ditt team redan använder.
Täck ett helt projekt
På ett projekt som strukturellt saknar tester är en global uppgift mer effektiv än en serie fil-för-fil-förfrågningar.
"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 bearbetar sedan filerna en efter en och anpassar testen till varje modul; räkna med flera minuters exekvering för en komplett svit. Kör denna uppgift på en mapp i taget snarare än på hela katalogen src/: utöver det blir pull requesten för stor att granska, och en testsvit som godkänns utan att ha lästs skyddar ingen.
Förbättra befintliga tester
Codex skapar inte bara; det kan också diagnostisera en svit som ger lugn utan att skydda.
"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."
Dessa tre symtom förklarar de flesta gröna sviter som låter buggar smita igenom. Den tredje är den mest lömska: tester som delar muterbart tillstånd klarar sig så länge de körs i vanlig ordning, men börjar misslyckas slumpmässigt den dag du aktiverar parallellisering.
Tester efter komponenttyp
Typen av test du bör begära beror direkt på kodens natur, och instruktionen ändras därefter.
| Kodtyp | Testtyp | Codex-instruktion |
|---|---|---|
| Hjälpfunktion | Enhet | « Testa alla möjliga in- och utdata » |
| API-rutt | Integration | « Testa med supertest, mocka externa tjänster » |
| React-komponent | Rendering | « Testa rendering och interaktioner med Testing Library » |
| Tjänst med DB | Integration | « Använd en testdatabas, återställ mellan varje test » |
Konfigurera AGENTS.md för tester
Istället för att upprepa dessa val för varje uppgift skriver du dem en gång för alla i en dedikerad sektion av 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)
Med dessa sju rader tillämpar Codex dina konventioner på varje test det genererar, även när en stressad utvecklare formulerar sin begäran med tre ord. Detta är det mest ekonomiska sättet att göra din testkvalitet oberoende av instruktionskvaliteten.
Viktiga punkter
- Codex genererar tester anpassade till din kod, inte generiska tester
- Specificera de kantfall du vill täcka i dina instruktioner
- Codex skiljer mellan enhetstester och integrationstester
- Använd AGENTS.md för att definiera dina testkonventioner
- Codex kan förbättra befintliga tester, inte bara skapa nya