Что такое пользовательские провайдеры и токены внедрения?

Question

Accepted Answer

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

## Четыре типа пользовательских провайдеров

```ts
@Module({
  providers: [
    // 1. useClass — standard (or swap the implementation behind a token)
    { provide: PaymentService, useClass: StripePaymentService },

// 2. useValue — inject a constant/object/mock (great for config and testing)
    { provide: "CONFIG", useValue: { apiKey: "abc", timeout: 5000 } },

// 3. useFactory — compute the provider dynamically (can use other deps)
    {
      provide: "DATABASE_CONNECTION",
      useFactory: async (config: ConfigService) => {
        return await createConnection(config.get("DB_URL"));   // async setup
      },
      inject: [ConfigService],        // dependencies for the factory
    },

// 4. useExisting — create an alias for an existing provider
    { provide: "ALIAS", useExisting: PaymentService },
  ],
})
export class AppModule {}
```

## Токены внедрения — для зависимостей, которые не являются классами

```ts
// classes can be tokens directly (by type). For values/interfaces, use a string/Symbol token:
@Injectable()
export class PaymentProcessor {
  constructor(@Inject("CONFIG") private config: AppConfig) {}   // inject by token
}
```

Поскольку вы не можете внедрить интерфейс или простое значение по типу (они не существуют во время выполнения), вы используете **токен** (строку или `Symbol`) с `@Inject(token)` для его внедрения. Таким образом вы внедряете объекты конфигурации, клиентов сторонних сервисов или зависимости типизированные интерфейсом.

## useFactory — наиболее мощный способ (динамическая настройка, асинхронность)

```ts
// create a provider whose value depends on runtime config / async initialization
{
  provide: "REDIS_CLIENT",
  useFactory: (config: ConfigService) => new Redis(config.get("REDIS_URL")),
  inject: [ConfigService],
}
```

`useFactory` запускает функцию (с внедренными зависимостями) для создания провайдера — это необходимо для соединений, клиентов или чего-либо, требующего конфигурации во время выполнения или асинхронной настройки.

## Смена реализаций (useClass) — гибкость и тестирование

```ts
// inject a different implementation based on environment
{
  provide: PaymentService,
  useClass: process.env.NODE_ENV === "test" ? MockPaymentService : StripePaymentService,
}
```

Поскольку потребители зависят от токена (`PaymentService`), вы можете менять конкретный класс — реальный сервис Stripe в production, мок в тестах — без изменения кода потребителей.

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

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

Понимание их важно для нескольких распространенных сценариев: **внедрение значений, которые не являются классами** (объекты конфигурации, константы) через `useValue` и токены типа string/Symbol (так как вы не можете внедрить интерфейсы или простые значения по типу); **динамическое/асинхронное создание провайдеров** через `useFactory` (самая мощная форма — создание соединений с БД, клиентов Redis или экземпляров SDK сторонних сервисов, сконфигурированных из значений во время выполнения, с их собственными внедренными зависимостями); и **смена реализаций** через `useClass` скрытно за токеном (позволяет использовать реализации, зависящие от окружения, и главное, **простую подмену при тестировании** — предоставляете mock-класс для токена без изменения потребителей).

Эта гибкость делает DI NestJS мощной для production-архитектуры и обеспечивает отличную тестируемость.

Знание четырех типов провайдеров (`useClass`, `useValue`, `useFactory`, `useExisting`), того, как работают токены внедрения для зависимостей, которые не являются классами, и когда использовать каждый из них — это важный шаг за пределы базового DI — это способ, идиоматичный для NestJS, подключать БД, внешние сервисы, конфигурацию и подменяемые/мокируемые зависимости, что делает это часто требуемой и архитектурно значимой темой в реальных приложениях.