Как тестировать приложения NestJS?

Question

Accepted Answer

NestJS предоставляет встроенную **утилиту тестирования (`@nestjs/testing`)**, интегрированную с Jest, и его **архитектура внедрения зависимостей делает тестирование особенно чистым** — вы создаете тестовый модуль и внедряете моки для зависимостей. Тесты делятся на модульные тесты (изолированные) и e2e тесты (полное приложение).

## Модульное тестирование сервиса (с моками зависимостей)

```ts
import { Test } from "@nestjs/testing";

describe("UsersService", () => {
  let service: UsersService;
  let mockRepo = { find: jest.fn(), save: jest.fn() };

beforeEach(async () => {
    const module = await Test.createTestingModule({
      providers: [
        UsersService,
        // inject a MOCK for the repository — no real database needed
        { provide: getRepositoryToken(User), useValue: mockRepo },
      ],
    }).compile();

service = module.get<UsersService>(UsersService);
  });

it("returns all users", async () => {
    mockRepo.find.mockResolvedValue([{ id: 1, name: "Ann" }]);
    const result = await service.findAll();
    expect(result).toHaveLength(1);
    expect(mockRepo.find).toHaveBeenCalled();
  });
});
```

Ключевое преимущество: DI в NestJS позволяет **заменять реальные зависимости на моки** через поставщиков тестового модуля — так вы тестируете сервис в изоляции, без реальной базы данных или внешних сервисов.

## Легкое создание моков зависимостей

```ts
// provide a fake for ANY dependency by its token
{ provide: EmailService, useValue: { send: jest.fn() } }
{ provide: ConfigService, useValue: { get: () => "test-value" } }
```

Поскольку классы не конструируют свои зависимости (это делает DI), подмена моков тривиальна — основа чистых модульных тестов.

## Сквозное тестирование (e2e) — полное приложение по HTTP

```ts
import * as request from "supertest";

describe("Users (e2e)", () => {
  let app: INestApplication;

beforeAll(async () => {
    const module = await Test.createTestingModule({
      imports: [AppModule],        // the whole app
    }).compile();
    app = module.createNestApplication();
    await app.init();
  });

it("GET /users", () => {
    return request(app.getHttpServer())   // make a real HTTP request
      .get("/users")
      .expect(200)
      .expect(res => expect(res.body).toBeInstanceOf(Array));
  });

afterAll(async () => await app.close());
});
```

**E2E тесты** запускают полное приложение и делают реальные HTTP запросы (через `supertest`), проверяя, что весь поток (маршрутизация → guards → pipes → handler → response) работает вместе.

## Стратегия тестирования

```text
Unit tests  → services, guards, pipes in isolation (mock dependencies) — fast, numerous
Integration → a controller + its real service together via the testing module
E2E tests   → full app over HTTP (supertest) — verify real request flows, fewer
Use a TEST database (or mocks) for e2e; override providers for external services.
```

## Почему это важно

Тестирование необходимо для надежных приложений, и архитектура NestJS делает это особенно чистым — понимание того, как тестировать, важно как для качества кода, так и потому, что фреймворк *спроектирован* для тестируемости.

Центральная идея в том, что **внедрение зависимостей делает создание моков тривиальным**: поскольку классы объявляют свои зависимости, а DI их предоставляет, модуль `@nestjs/testing` позволяет заменить любую зависимость (репозитории базы данных, внешние сервисы, конфигурация) на мок по его токену, обеспечивая быстрые, изолированные **модульные тесты** сервисов, guards и pipes без реальной инфраструктуры.

Эта тестируемость — главная причина, почему фреймворки на основе DI, такие как NestJS, ценятся.

Дополняя модульные тесты, **e2e тесты** (запуск полного приложения и реальные HTTP запросы через `supertest`) проверяют, что весь конвейер запросов — маршрутизация, guards, валидация, handlers — работает вместе корректно.

Знание утилит тестирования (`Test.createTestingModule`, переопределение поставщиков для создания моков), умение писать как модульные, так и e2e тесты, и разумная стратегия тестирования (много быстрых изолированных модульных тестов, меньше полных e2e тестов, тестовая база данных) — отличительная черта профессиональной разработки на NestJS.

Это отражает зрелую инженерную практику и использует именно то, что делает структурированный, DI-ориентированный дизайн NestJS ценным, делая это важной темой уровня senior.