Yksikkö- ja integraatiotestien automatisointi
Tällä sivulla
Testien kirjoittamisen automatisointi
Testit ovat ensimmäinen asia, josta tingitään, kun aika loppuu kesken, ja ne ovat tekninen velka, joka maksaa myöhemmin eniten. Codex muuttaa tilannetta: koko moduulin kattavuuden saavuttaminen muuttuu minuuttien eikä iltapäivän mittaiseksi urakaksi. Sinun on kuitenkin pyydettävä enemmän kuin pelkkä “kirjoita testit” -käsky, joka tuottaa vain kourallisen nimellistapauksia – vihreitä, rauhoittavia ja arvottomia.
Yksikkötestien generointi
Tärkein vipu on nimetä reunatapaukset itse. Tunnet liiketoimintadomainisi; agentti ei tiedä, että yli 100 %:n alennus tapahtuu datassasi vain kerran neljännesvuosittain.
"Generate unit tests for src/lib/pricing.ts.
Use Vitest. Cover all edge cases: negative price,
discount > 100%, invalid currency, zero quantity."
Codex analysoi lähdekoodin, tunnistaa viedyt funktiot, ymmärtää niiden logiikan ja tuottaa sitten testisarjan, joka kattaa sekä normaalit polut että mainitsemasi tapaukset.
// 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();
});
});
Yksi yksityiskohta vaatii tarkastelua: odotettu virheilmoitus “Invalid price” on otettu suoraan toteutuksesta, eikä sitä ole keksitty. Tämä on merkki koodista kirjoitetusta testistä eikä mallineesta peräisin olevasta, ja se on ensimmäinen asia, joka on tarkistettava generoitua testisarjaa arvioitaessa.
Integraatiotestien generointi
API-reittiä tai tietokantaa käyttävää palvelua varten sinun on annettava enemmän kontekstia, erityisesti siitä, mitä tulee mockata.
"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 erottaa selvästi nämä kaksi testitasoa: se määrittää sopivat mockit, hoitaa testitietokannan alustuksen ja purkamisen sekä simuloi ulkoisia palveluita. Stripesin ja supertestin nimeäminen eksplisiittisesti estää sitä keksimästä rinnakkaista infrastruktuuria sille, mitä tiimisi jo käyttää.
Koko projektin kattaminen
Projektissa, jossa testit puuttuvat rakenteellisesti, globaali tehtävä on tehokkaampi kuin sarja tiedosto kerrallaan -pyyntöjä.
"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 käsittelee sitten tiedostot yksi kerrallaan sovittaen testit kuhunkin moduuliin; koko sarjan suorittamiseen kannattaa varata useita minuutteja. Suorita tämä tehtävä yhdelle kansiolla kerrallaan eikä koko src/-hakemistolle: sen ylittäessäsi vetopyynnöstä tulee liian suuri tarkistettavaksi, ja lukematta hyväksytty testisarja ei suojaa ketään.
Olemassa olevien testien parantaminen
Codex ei vain luo, vaan se voi myös diagnosoida testisarjan, joka rauhoittaa suojelematta.
"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."
Nämä kolme oiretta selittävät useimmat vihreät testisarjat, jotka päästävät bugit läpi. Kolmas on salakavalin: testit, jotka jakavat muuttuvan tilan, läpäisevät ajon niin kauan kuin ne suoritetaan tavallisessa järjestyksessä, ja alkavat epäonnistua satunnaisesti sinä päivänä, kun otat käyttöön rinnakkaisuuden.
Testit komponenttityypin mukaan
Pyydettävän testin tyyppi riippuu suoraan koodin luonteesta, ja ohjeistus muuttuu sen mukana.
| Koodityyppi | Testityyppi | Codex-ohjeistus |
|---|---|---|
| Apufunktio | Yksikkö | ”Testaa kaikki mahdolliset syötteet ja tulosteet” |
| API-reitti | Integraatio | ”Testaa supertestillä, mockaa ulkoiset palvelut” |
| React-komponentti | Renderöinti | ”Testaa renderöinti ja vuorovaikutus Testing Libraryllä” |
| Palvelu, jossa DB | Integraatio | ”Käytä testitietokantaa, nollaa se jokaisen testin välillä” |
AGENTS.md:n konfigurointi testejä varten
Näiden valintojen toistamisen sijaan jokaisen tehtävän kohdalla kirjoita ne kerran ja lopullisesti AGENTS.md-tiedoston omassa osiossaan.
## 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)
Näillä seitsemällä rivillä Codex soveltaa käytäntöjäsi jokaiseen generoimaansa testiin, vaikka kiireinen kehittäjä muotoilisi pyyntönsä kolmella sanalla. Tämä on taloudellisin tapa tehdä testien laadusta riippumaton ohjeistuksen laadusta.
Keskeiset asiat
- Codex generoi testeja, jotka on sovitettu koodiisi, ei yleisiä testejä
- Määritä ohjeistuksessasi reunatapaukset, jotka haluat kattaa
- Codex erottaa toisistaan yksikkö- ja integraatiotestit
- Käytä AGENTS.md-tiedostoa määritelläksesi testikäytäntösi
- Codex voi parantaa olemassa olevia testejä, ei vain luoda uusia