Премини към основното съдържание
Български— Изберете език
Меню

Автоматизирани модулни и интеграционни тестове

Урок 7 от 20 Обновен 29 юли 2026 г. Програмист
На тази страница
  1. Автоматизиране на писането на тестове
  2. Генериране на модулни тестове
  3. Генериране на интеграционни тестове
  4. Покриване на цял проект
  5. Подобряване на съществуващи тестове
  6. Тестове по тип компонент
  7. Конфигуриране на AGENTS.md за тестове
  8. Ключови изводи

Автоматизиране на писането на тестове

Тестовете са първото нещо, което се пропуска, когато времето притесне, и дългът, който по-късно струва най-скъпо. 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 може да подобрява съществуващи тестове, а не само да създава нови