Как работает внедрение зависимостей (dependency injection) в NestJS?

Question

Accepted Answer

**Dependency Injection (DI)** — это основной паттерн NestJS, где фреймворк **автоматически создает и предоставляет** зависимости, которые нужны классу, вместо того чтобы класс создавал их сам. Вы объявляете, что вам нужно в конструкторе, и NestJS это предоставляет — что приводит к слабо связанному и легко тестируемому коду.

## Как это работает: объявляем в конструкторе

```ts
@Injectable()
export class UsersService {
  // declare dependencies as constructor parameters — Nest injects them
  constructor(
    private readonly db: DatabaseService,
    private readonly logger: LoggerService,
  ) {}
  // you NEVER write `new DatabaseService()` — Nest creates and provides it
}
```

Nest читает типы параметров конструктора, ищет соответствующих зарегистрированных провайдеров, создает их (если еще не созданы) и передает их — автоматически разрешая весь граф зависимостей.

## Поток DI

```text
1. A class is marked @Injectable() → it's a provider
2. The provider is registered in a module's `providers` array
3. Another class declares it as a constructor parameter
4. NestJS's IoC container resolves and INJECTS the instance automatically
```

## Регистрация и разрешение

```ts
@Module({
  providers: [UsersService, DatabaseService, LoggerService],  // register all providers
  controllers: [UsersController],
})
export class UsersModule {}
// Nest's container now knows how to construct each and inject them where needed
```

## Почему DI ценно

```text
✓ Loose coupling — classes depend on ABSTRACTIONS, not on constructing concrete deps
✓ Testability — inject MOCK dependencies in tests easily (no real DB needed)
✓ Reusability — one shared instance (singleton) used across the app
✓ Maintainability — change an implementation in one place (the module registration)
```

## Тестируемость — главное преимущество

```ts
// in a test, provide a fake DatabaseService — no real database required
const module = await Test.createTestingModule({
  providers: [
    UsersService,
    { provide: DatabaseService, useValue: mockDatabase },  // inject a mock
  ],
}).compile();
```

Поскольку класс не создает свои зависимости, вы можете подставить моки для тестирования — DI делает приложения NestJS высоко тестируемыми.

## Внедрение не-классовых значений

```ts
// use injection tokens for config/values, not just classes
constructor(@Inject("CONFIG") private config: AppConfig) {}
```

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

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

Понимание этого критически важно, потому что почти каждый класс NestJS участвует в DI: вы объявляете зависимости в конструкторе, а IoC контейнер фреймворка автоматически разрешает и предоставляет их, исключая ручное создание экземпляров и тесную связность.

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

DI заимствован из фреймворков как Angular и Spring, и овладение им — как объявлять, регистрировать, внедрять и создавать моки зависимостей — необходимо для построения хорошо структурированных, легко тестируемых приложений NestJS и является одним из наиболее важных концепций для глубокого понимания в этом фреймворке.