TypeScript Academy · درس

reflect-metadata وأنواع التصميم

التقطوا أنواع المعلمات والخصائص أثناء التشغيل

الدرس 3 من 413 خطوة

reflect-metadata وأنواع التصميم درس مجاني في TypeScript Academy على CoddyKit. هذا هو الدرس 3 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في TypeScript Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة TypeScript Academy 4 دروس في المجموع.

reflect-metadata وأنواع التصميم

قبل توحيد البيانات الوصفية، كان TypeScript قادرًا على إصدار معلومات الأنواع وقت التصميم في وقت التشغيل عبر مكتبة reflect-metadata إلى جانب خيار المترجم emitDecoratorMetadata. يشرح هذا الدرس تلك الآلية الأقدم، التي لا تزال مستخدمة على نطاق واسع.

تفعيل الميزة

يلزم أمران: تفعيل خيارات المترجم واستيراد المكتبة مرة واحدة عند نقطة دخول البرنامج.

// tsconfig.json
// {
//   "compilerOptions": {
//     "experimentalDecorators": true,
//     "emitDecoratorMetadata": true
//   }
// }

import "reflect-metadata";

ما الذي يُصدَر

مع تفعيل emitDecoratorMetadata، يُصدر المترجم ثلاثة مفاتيح للأعضاء المزخرفة: design:type وdesign:paramtypes وdesign:returntype. وتكون القيم هي دوال الإنشاء، مثل String وNumber.

قراءة design:type

بالنسبة إلى خاصية مزخرفة، يُرجع Reflect.getMetadata("design:type", target, key) مُنشئ نوع الخاصية.

import "reflect-metadata";

function track(target: any, key: string) {
  const t = Reflect.getMetadata("design:type", target, key);
  console.log(key, "->", t.name); // e.g. "name -> String"
}

class Person {
  @track name!: string;
  @track age!: number;
}

قراءة design:paramtypes

في المُنشئ أو الطريقة، تكون design:paramtypes مصفوفة من مُنشئات أنواع المعلمات، وهي الأساس لحقن الاعتمادات.

function injectable(target: any) {
  const params = Reflect.getMetadata("design:paramtypes", target);
  console.log(params.map((p: any) => p.name)); // ["Database", "Logger"]
}

@injectable
class Service {
  constructor(private db: Database, private log: Logger) {}
}

قيود الأنواع المُصدرة

لا تبقى سوى الأنواع البسيطة القابلة للتمثيل وقت التشغيل. إذ تتحول الواجهات والاتحادات والأنواع العامة إلى Object لأنها لا تملك مُنشئًا وقت التشغيل. لذلك فإن أنواع التصميم تقريبية وليست نوع TypeScript الكامل.

بيانات وصفية مخصصة باستخدام Reflect

يمكنكم أيضًا تعريف مفاتيح البيانات الوصفية الخاصة بكم باستخدام Reflect.defineMetadata، بشكل مستقل عن أنواع التصميم.

import "reflect-metadata";

function required(target: any, key: string) {
  Reflect.defineMetadata("required", true, target, key);
}

function isRequired(target: any, key: string) {
  return Reflect.getMetadata("required", target, key) === true;
}

مواضع الاستخدام

تشغّل هذه الآلية العديد من الأطر الراسخة، مثل NestJS وTypeORM وclass-validator. فهي تقرأ design:type وdesign:paramtypes لربط الاعتمادات والتحقق من القيم دون أن تعيدوا التصريح بالأنواع.

reflect-metadata مقابل البيانات الوصفية القياسية

تُعد واجهة Symbol.metadata الجديدة جزءًا من اللغة، ولا تُصدر أنواع التصميم. أما reflect-metadata فتوفّر بشكل فريد معلومات النوع، لكنها مرتبطة بنمط المزخرفات التجريبي. اختاروا نموذجًا واحدًا لكل مشروع.

ترتيب الاستيراد مهم

يجب أن يُنفذ import "reflect-metadata" مرة واحدة، وقبل تقييم أي فئة مزخرفة، لأنه يضيف دوال البيانات الوصفية إلى كائن Reflect العام. استوردوه في أعلى ملف نقطة الدخول مباشرةً.

لماذا يهم ذلك

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

اختبار سريع

اختبروا فهمكم لمكتبة reflect-metadata.

أجب عليها في الدرس التفاعلي

مراجعة

مع experimentalDecorators وemitDecoratorMetadata، ومع تنفيذ import "reflect-metadata" مبكرًا، يُصدر المترجم design:type وdesign:paramtypes كمُنشئات وقت التشغيل. وتقرأ الأطر هذه القيم لحقن الاعتمادات والتحقق، مع أن الواجهات والاتحادات والأنواع العامة تتحول إلى Object.

البدء مجانًا

تعلم TypeScript مع معلم ذكاء اصطناعي — مجانًا

اكتب وقم بتشغيل أكوادك الفعلية في المتصفح، واحصل على مساعدة فورية من معلم ذكاء اصطناعي متاح 24/7، واستمر من حيث توقفت على الويب أو في التطبيق.

الدورات: 101
الدروس: 352

ابدأ التعلم مجانًا عرض الدورة الكاملة

الأسئلة الشائعة

هل درس «reflect-metadata وأنواع التصميم» مجاني؟

نعم — نص درس «reflect-metadata وأنواع التصميم» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة TypeScript Academy، انتقل إلى CoddyKit PRO. تتضمن دورة TypeScript Academy 4 دروس في المجموع.

ماذا ستتعلم في «reflect-metadata وأنواع التصميم»؟

التقطوا أنواع المعلمات والخصائص أثناء التشغيل تتمرن على TypeScript Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ TypeScript Academy؟

لا تُشترط خبرة سابقة. TypeScript Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 3 من أصل 4.

كم من الوقت يستغرق درس «reflect-metadata وأنواع التصميم»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس TypeScript Academy هذا؟

نعم. كل درس في TypeScript Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

← العودة إلى TypeScript Academy