كيف يعمل حقن الاعتماديات (Dependency Injection) في NestJS؟

Question

Accepted Answer

**حقن الاعتماديات (Dependency Injection - DI)** هو نمط أساسي في NestJS حيث يقوم الإطار **تلقائياً بإنشاء وتوفير** الاعتماديات التي تحتاجها الفئة (Class)، بدلاً من أن تقوم الفئة بإنشاؤها بنفسها. تُصرح بما تحتاجه في المُنشئ (Constructor)، و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 تقرأ أنواع معاملات المُنشئ، تبحث عن مزودي الخدمات (Providers) المسجلين المناظرين، تُنشئهم (إذا لم تكن موجودة بالفعل)، وتمررهم — مما يحل الرسم البياني للاعتماديات بأكمله تلقائياً.

## تدفق 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();
```

بما أن الفئة لا تُنشئ اعتمادياتها، يمكنك استبدالها بمحاكاة (Mocks) للاختبار — DI يجعل تطبيقات NestJS قابلة للاختبار بدرجة عالية.

## حقن قيم غير متعلقة بالفئات

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

## لماذا يأتي في المقام الأول

حقن الاعتماديات هو النمط الأساسي الذي يدعم معمارية NestJS بأكملها — إنه كيفية حصول المتحكمات (Controllers) على الخدمات (Services)، وحصول الخدمات على المستودعات (Repositories) والخدمات الأخرى، وكيفية توصيل التطبيق بأكمله معاً.

فهمه ضروري لأن كل فئة تقريباً في NestJS تشارك في DI: تُصرح بالاعتماديات في المُنشئ ويقوم حاوي IoC في الإطار بحلها وتوفيرها تلقائياً، مما يلغي الحاجة للإنشاء اليدوي والارتباط الوثيق.

الفوائد كبيرة وأساسية لسبب تقديس NestJS: **مفكوك الارتباط** (تعتمد على التجريدات)، **الاختبارية** (احقن محاكاة بدلاً من الاعتماديات الحقيقية — مما يجعل الاختبار الشامل سهلاً)، إعادة الاستخدام (المفردات المشتركة)، والقابلية للصيانة.

DI مستعار من أطر عمل مثل Angular و Spring، وإتقانه — كيفية الإعلان والتسجيل والحقن ومحاكاة الاعتماديات — ضروري لبناء تطبيقات NestJS منظمة وقابلة للاختبار، وهو أحد أهم المفاهيم التي يجب فهمها بعمق في الإطار.