تحميل المُنشئ في TypeScript: بشكل صحيح وجميل

تعلم Python بسهولة دون إرهاق نظري. حل مهام عملية مع التحقق التلقائي واكتب الكود مباشرة في المتصفح.

تحميل المُنشئ في TypeScript: من المبتدئ إلى المحترف

تخيل: أنت تكتب فئة User، والتي يجب أن تكون قادرة على الإنشاء من مصادر مختلفة. من سلسلة JSON، من كائن ببيانات، وأحيانًا بدون معلمات على الإطلاق — مجرد ملف شخصي فارغ. في JavaScript، كنت ستتحقق ببساطة من الأنواع داخل مُنشئ واحد. لكن TypeScript يمنحنا أداة أكثر أناقة وأمانًا — تحميل المُنشئ.

هذا الموضوع هو حديث الساعة على Stack Overflow. آلاف المطورين يبحثون عن إجابة للسؤال: «كيفية تنفيذ منشئات متعددة في TypeScript؟». وليس من المستغرب: تحميل المُنشئ هو نمط قوي يجعل كودك مرنًا وقابلاً للقراءة وآمنًا من حيث النوع. في هذه المقالة، سنشرح كل شيء من «لماذا هذا ضروري» إلى «كيفية القيام بذلك بشكل صحيح» مع أمثلة واقعية.

ما هو تحميل المُنشئ ولماذا هو مطلوب؟

في البرمجة الشيئية الكلاسيكية، تحميل المُنشئ (constructor overload) هو إمكانية الإعلان عن عدة منشئات في فئة واحدة، كل منها بمجموعة المعلمات الخاصة به. TypeScript، على عكس JavaScript، يدعم هذا المفهوم، ولكن مع ميزة مهمة واحدة: على مستوى التجميع. في وقت التشغيل، يمكن أن يكون للفئة تطبيق واحد فقط للمنشئ، لكن TypeScript يسمح بالإعلان عن عدة تواقيع (تحميلات)، ثم كتابة تطبيق واحد مشترك يقوم بتحليل الوسائط.

لماذا هذا مطلوب؟ دعنا ننظر في ثلاثة سيناريوهات:

مرونة API: يمكن لفئتك قبول البيانات بتنسيقات مختلفة (سلسلة، كائن، مصفوفة).
التوافق مع الإصدارات السابقة: تقوم بإضافة معلمات جديدة دون كسر الكود القديم.
تحسين تجربة المطور (DX): سيقوم IDE باقتراح جميع الخيارات الممكنة لاستدعاء المُنشئ.

صيغة تحميل المُنشئ: شرح مبسط

دعنا ننتقل مباشرة إلى الموضوع. إليك مثال كلاسيكي — فئة User، والتي يمكن إنشاؤها بثلاث طرق:

class User {    public name: string;    public age: number;    public email: string;

    // التحميل 1: بدون معلمات (مستخدم فارغ)    constructor();    // التحميل 2: الاسم فقط    constructor(name: string);    // التحميل 3: البيانات الكاملة    constructor(name: string, age: number, email: string);    // التطبيق — واحد لجميع الحالات    constructor(name?: string, age?: number, email?: string) {        if (name === undefined) {            this.name = 'Guest';            this.age = 0;            this.email = '';        } else if (age === undefined) {            this.name = name;            this.age = 0;            this.email = '';        } else {            this.name = name;            this.age = age;            this.email = email ?? '';        }    }}

// الاستخدام:const guest = new User();                // Guest, 0, ''const john = new User('John');           // John, 0, ''const jane = new User('Jane', 25, 'jane@mail.com'); // Jane, 25, jane@mail.com

لاحظ: ثلاثة تواقيع (تحميلات) وتطبيق واحد. التواقيع هي «وعود» لمترجم TypeScript، والتطبيق هو «كيف يعمل هذا في الواقع». يجب أن تكون المعلمات في التطبيق اختيارية (?) لتغطية جميع الخيارات.

الأخطاء النموذجية عند تحميل المُنشئ

غالبًا ما يتعثر المطورون في ثلاث مشاكل:

الخطأ 1: عدم توافق الأنواع. إذا وعد التوقيع بـ string، لكن التطبيق يتلقى number — سيعطي TypeScript خطأ. يجب أن تكون جميع التواقيع متوافقة مع التطبيق.
الخطأ 2: ترتيب التحميلات. يختار TypeScript أول توقيع مناسب. إذا كان لديك constructor(x: string | number) و constructor(x: string)، فإن الثاني لن