Автоматизирани модулни и интеграционни тестове
На тази страница
Автоматизиране на писането на тестове
Тестовете са първото нещо, което се пропуска, когато времето притесне, и дългът, който по-късно струва най-скъпо. Codex променя баланса: генерирането на пълно покритие за даден модул става въпрос на минути, а не на цял следобед. Но трябва да поискате повече от просто „напиши тестове“ – инструкция, която води до шепа номинални случаи – зелени, успокояващи и безполезни.
Генериране на модулни тестове
Основният лост е Вие сами да назовете граничните случаи. Вие познавате своята предметна област; агентът не знае, че отстъпка, по-голяма от 100%, се случва веднъж на тримесечие във Вашите данни.
"Generate unit tests for src/lib/pricing.ts.
Use Vitest. Cover all edge cases: negative price,
discount > 100%, invalid currency, zero quantity."
Codex анализира изходния код, идентифицира експортираните функции, разбира тяхната логика и след това създава набор, който покрива както нормалните пътища на изпълнение, така и случаите, които сте посочили.
// 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();
});
});
Един детайл заслужава проверка: очакваното съобщение за грешка „Invalid price“ е взето от действителната имплементация, а не е измислено. Това е белегът на тест, написан въз основа на кода, а не по шаблон, и първото нещо, което трябва да проверите при преглед на генериран набор.
Генериране на интеграционни тестове
За API маршрут или услуга, която работи с база данни, трябва да предоставите повече контекст, особено относно това какво да се мокира (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 ясно разграничава двете нива на тестване: конфигурира подходящи мокове, обработва настройката и почистването на тестовата база данни и симулира външни услуги. Изричното назоваване на Stripe и supertest предотвратява измислянето на паралелна инфраструктура към тази, която екипът Ви вече използва.
Покриване на цял проект
При проект, който структурно липсват тестове, глобална задача е по-ефективна от поредица от заявки файл по файл.
"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 обработва файловете един по един, адаптирайки тестовете към всеки модул; очаквайте няколко минути изпълнение за пълен набор. Стартирайте тази задача върху една папка наведнъж, а не върху цялата директория src/: отвъд този мащаб, заявката за сливане (pull request) става твърде голяма за преглед, а набор от тестове, одобрен без прочитане, не защитава никого.
Подобряване на съществуващи тестове
Codex не само създава, но може и да диагностицира набор, който успокоява, без да защитава.
"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."
Тези три симптома обясняват повечето зелени наборове, които позволяват бъгове да се промъкнат. Третият е най-коварен: тестове, които споделят променливо състояние, минават успешно, докато се изпълняват в обичайния ред, и започват да се провалят случайно в деня, в който активирате паралелизация.
Тестове по тип компонент
Типът тест, който трябва да поискате, зависи пряко от естеството на кода и инструкцията се променя съответно.
| Тип код | Тип тест | Инструкция за Codex |
|---|---|---|
| Помощна функция | Модулен | ”Test all possible inputs and outputs” |
| API маршрут | Интеграционен | ”Test with supertest, mock external services” |
| React компонент | Рендиране | ”Test rendering and interactions with Testing Library” |
| Услуга с БД | Интеграционен | ”Use a test DB, reset between each test” |
Конфигуриране на AGENTS.md за тестове
Вместо да повтаряте тези избори за всяка задача, запишете ги веднъж завинаги в специален раздел на 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)
С тези седем реда Codex прилага Вашите конвенции към всеки тест, който генерира, дори когато разработчик, бързащ за време, формулира заявката си с три думи. Това е най-икономичният начин да направите качеството на Вашите тестове независимо от качеството на инструкциите.
Ключови изводи
- Codex генерира тестове, адаптирани към Вашия код, а не общи тестове
- Посочете граничните случаи, които искате да покриете, във Вашите инструкции
- Codex прави разлика между модулни и интеграционни тестове
- Използвайте AGENTS.md, за да дефинирате Вашите конвенции за тестване
- Codex може да подобрява съществуващи тестове, а не само да създава нови