Что это вообще такое
1) useValue — подставляет готовый объект/примитив по токену. Удобно для конфигов и моков
2) useFactory — создаёт значение через фабрику (функцию). Может быть async, можно внедрять зависимости, менять логику по окружению
Оба — это способы объявить провайдеры без привязки к конкретному классу
useValue — конфиг и моки
export const CONFIG = Symbol('CONFIG');
@Module({
providers: [
{ provide: CONFIG, useValue: { apiBase: 'https://api.dev', timeout: 3000 } },
],
exports: [CONFIG],
})
export class ConfigModule {}
Тест с моками:
useFactory — фабрика с зависимостями и режимами
export const PAYMENT_GATEWAY = Symbol('PAYMENT_GATEWAY');
@Module({
providers: [
{
provide: PAYMENT_GATEWAY,
useFactory: (cfg: ConfigService) => {
const isProd = cfg.get('NODE_ENV') === 'production';
return isProd
? new StripeGateway(cfg.get('STRIPE_KEY'))
: new FakeGateway(); // быстрая локальная разработка
},
inject: [ConfigService],
},
],
exports: [PAYMENT_GATEWAY],
})
export class PaymentModule {}
💀Причём тут SOLID, буква D (Dependency Inversion)
Принцип инверсии зависимостей: высокоуровневые модули не зависят от низкоуровневых; оба зависят от абстракций
— В Nest абстракция = инъекционный токен (строка/символ), а не интерфейс TypeScript (он стирается в runtime)
— useValue/useFactory позволяют под этот токен подложить любую реализацию без изменения кода потребителей
😱 Итог
useValue/useFactory — это практические инструменты для реализации D из SOLID в Nest.js: вы зависите от абстракций (токенов) и свободно подменяете реализации. Так код становится тестируемее, модули — слабосвязанными, а конфигурация — гибкой. Используйте useValue для констант и моков, useFactory — для динамики и асинхронной инициализации
🚀 Пост Guru Node.js: @DemetraIT