# nestjs-testing

Правило nestjs-testing для NestJS-проектов: тестирует сервисы через TestingModule, мокирует зависимости Jest и пишет E2E-тесты с Supertest. Нужно, чтобы тесты не вызывали реальные API и БД.

- правило · `type=rule` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline · ★ 372 у репозитория
- Автор: Giuseppe Trisciuoglio
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/giuseppe-trisciuoglio/developer-kit/tree/HEAD/plugins/developer-kit-typescript/rules/nestjs-testing.md
- Обновлён: 2026-09-10
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/rules/nestjs-testing

## Что делает

Правило задаёт три уровня тестирования. На уровне модуля используется `Test.createTestingModule()` с мокированными провайдерами — зависимости заменяются Jest-объектами, `afterEach` очищает все моки. На уровне интеграции мокируются внешние сервисы: HTTP-клиенты, репозитории, SDK. Ошибки (таймауты, 500-е ответы) тестируются явно. E2E-тесты собирают настоящий `AppModule`, применяют глобальные пайпы и гварды, проверяют весь путь запроса — от маршрута до ответа.

Правило включает примеры охраны авторизации (401 без токена, 200 с валидным), валидации DTO и обработки ошибок. Гварды и интерсепторы тестируются отдельно с мокированными `ExecutionContext` и `CallHandler`. Каждый тест следует паттерну Arrange-Act-Assert: входные данные, вызов метода, проверка результата и вызовов.

## Установка

### Claude Code (родная платформа)

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add giuseppe-trisciuoglio/developer-kit
```
В чате агента (не в терминале):
```text
/plugin install developer-kit-typescript@developer-kit
```

2. **Вручную: положить файлы**
- Файл: `.claude/rules/nestjs-testing.md` — Поле paths во frontmatter ограничивает файлы

### Codex

**AGENTS.md**
- Codex читает AGENTS.md: вставьте текст правила туда

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/rules/nestjs-testing.mdc` — Во frontmatter: description, globs, alwaysApply

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/instructions/nestjs-testing.instructions.md` — Поле applyTo задаёт, к каким файлам применять

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/rules/nestjs-testing.md`

### Cline

**Вручную: положить файлы**
- Файл: `.clinerules/nestjs-testing.md`

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/giuseppe-trisciuoglio/developer-kit/tree/HEAD/plugins/developer-kit-typescript/rules/nestjs-testing.md

## Когда брать
- Писать unit-тесты для NestJS-сервисов и контроллеров без утечек в реальные БД и API
- Мокировать зависимости (HTTP-клиенты, репозитории) в тестах через Jest
- Тестировать охрану авторизации и валидацию DTO в E2E
- Структурировать E2E-тесты так, чтобы они изолировались между прогонами
- Проверять сценарии ошибок: таймауты, rate-limiting, невалидные данные

## Примеры запросов агенту
- Напиши unit-тест для `UsersService.create()`, который мокирует `UserRepository` и проверяет, что при дублирующемся email выбросится исключение
- Добавь E2E-тест для `POST /users`, который валидирует DTO и возвращает 400 при пустом email
- Напиши тест для гварда `RolesGuard`, который проверяет, что запрос без нужной роли вернёт 403

## Похожие
- [typescript-e2e-testing](https://affpapa.org/nevibecode/skills/typescript-e2e-testing.md) — скилл · 2300 установок
- [typescript-nestjs-best-practices-cursorrules-promp](https://affpapa.org/nevibecode/rules/typescript-nestjs-best-practices-cursorrules-promp.md) — правило · ★ 41178 у репозитория
- [nestjs-clean-typescript](https://affpapa.org/nevibecode/skills/nestjs-clean-typescript.md) — скилл · 998 установок
- [nestjs-expert](https://affpapa.org/nevibecode/agents/carlrannaberg-nestjs-expert.md) — субагент · ★ 763 у репозитория
- [api-test-suite-generator](https://affpapa.org/nevibecode/skills/api-test-suite-generator.md) — скилл · 319 установок
- [typescript-unit-testing](https://affpapa.org/nevibecode/skills/typescript-unit-testing.md) — скилл · 518 установок

Из того же набора: [giuseppe-trisciuoglio/developer-kit](https://affpapa.org/nevibecode/by/giuseppe-trisciuoglio/developer-kit.md) — 191 карточка

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
