ما هي دمج التصريحات (Declaration Merging)؟

Question

IT Interview Practice · Accepted Answer

**دمج التصريحات** هو عملية يقوم بها TypeScript بدمج تصريحات متعددة بنفس **الاسم** في تعريف واحد. تندمج الواجهات (Interfaces) والمساحات (Namespaces) وبعض الإنشاءات الأخرى تلقائياً.

## دمج الواجهات

```ts
interface Box { width: number; }
interface Box { height: number; }
// Box is now { width: number; height: number } — both merged
```

## حالة الاستخدام الرئيسية: توسيع أنواع الطرف الثالث / الأنواع العامة

هذه هي الطريقة التي تضيف بها أنواع للمكتبات أو المتغيرات العامة التي لا تمتلكها:

```ts
// Add a custom property to Express's Request
declare global {
  namespace Express {
    interface Request { user?: { id: string }; } // merges into Express.Request
  }
}
request.user; // ✅ now typed everywhere

// Augment a module
declare module "some-lib" {
  interface Options { newOption: boolean; }
}
```

نظراً لأن `Request`/`Options` للمكتبة هي `interface`، فإن تصريحك *ينضم* إليها بدلاً من التعارض — مما يسمح لك بتوسيع الأنواع بأمان دون تحريرها.

## دمج Namespace + Function

```ts
function greet() {}
namespace greet { export const version = "1.0"; }
greet.version; // "1.0" — namespace merged onto the function
```

## لماذا لا يمكن لـ `type` أن يفعل هذا

```ts
type A = { x: number };
type A = { y: number }; // ❌ Error: duplicate identifier
```

اسم مستعار للنوع فريد؛ فقط الواجهات (والمساحات) تندمج — وهذا سبب رئيسي لاستخدام `interface` لأشكال API العام القابلة للتوسع.

## لماذا يهم

دمج التصريحات هو الآلية خلف **module augmentation** — توسيع طلبات Express وإضافة إلى `window` وتخصيص أنواع المكتبة وأنظمة المواضيع.

إنها معرفة أساسية لتحديد نوع التطبيقات الحقيقية حيث يجب عليك تكييف الأنواع التي لا تتحكم بها، دون نسخها.

دمج الواجهات

حالة الاستخدام الرئيسية: توسيع أنواع الطرف الثالث / الأنواع العامة

دمج Namespace + Function

لماذا لا يمكن لـ type أن يفعل هذا

لماذا يهم

أسئلة ذات صلة

لماذا لا يمكن لـ `type` أن يفعل هذا