الإعلانات والاندماج

تُستخدم ملفات تعريف النوع (ذات الامتداد .d.ts) في TypeScript لوصف شكل كود JavaScript الموجود دون تنفيذ أي منطق فعلي. أنها تحتوي فقط على تعريفات النوع والواجهات وتوقيعات الوظائف.

تعتبر هذه الملفات ضرورية عند استخدام مكتبات الجهات الخارجية المكتوبة بلغة JavaScript خالصة.

دمج الإعلان

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

الحالة الأكثر شيوعًا هي دمج الواجهة:

interface User {
  name: string;
}

interface User {
  age: number;
}

// The resulting User interface has both name and age properties!
const student: User = {
  name: 'Alice',
  age: 23,
};

إذا كانت الخصائص تشترك في نفس الاسم، فيجب أن تكون من نفس النوع، وإلا فإن TypeScript ستبلغ عن خطأ.

تعديل الوحدات العالمية والخارجية

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

على سبيل المثال، إذا أردنا إضافة خاصية إلى كائن window العام للمتصفح:

declare global {
  interface Window {
    analyticsToken: string;
  }
}

باستخدام declare global، نخبر TypeScript أننا نقوم بإدخال توقيع جديد في واجهة Window العامة الحالية.

جربه بنفسك

التمرين 1: دمج الإعلان الأساسي

التمرين 2: توسيع واجهة النافذة العالمية