التحميل الزائد للدوال وتوقيعات الاستدعاء
صرّح بتوقيعات التحميل الزائد لأشكال الاستدعاء المختلفة، واستخدم توقيعات الاستدعاء داخل أنواع الكائنات لإنشاء واجهات برمجية مرنة.
التحميل الزائد للدوال وتوقيعات الاستدعاء درس مجاني في TypeScript Academy على CoddyKit. هذا هو الدرس 1 من أصل 3. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في TypeScript Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة TypeScript Academy 3 دروس في المجموع.
مقدمة
الهدف: نمذجة الدوال التي تقبل مدخلات مختلفة وتعيد مخرجات مختلفة باستخدام overloads، ووصف call signatures داخل أنواع الكائنات لواجهات برمجة التطبيقات الشبيهة بالـ callbacks.
نمط Overload
يُصرّح عن overloads كتواقيع متعددة، إضافةً إلى تنفيذ واحد يضيّق المدخلات ويعيد النوع الصحيح.
// 1) Overload signatures (no body)
function parse(input: string): number;
function parse(input: number): string;
// 2) Single implementation compatible with all overloads
function parse(input: string | number): string | number {
if (typeof input === "string") {
return input.length; // string -> number
} else {
return String(input); // number -> string
}
}
console.log(parse("TS")); // 2 (number)
console.log(parse(123)); // "123" (string)تواقيع الاستدعاء
يتيح توقيع الاستدعاء إمكانية استدعاء نوع كائن مع تحميلات زائدة، وهو مفيد للمكتبات التي تعرض دوال قابلة للاستدعاء مع خصائص.
type Stringify = {
(v: number): string;
(v: boolean): string;
};
const toStr: Stringify = (v: number | boolean) => {
return typeof v === "number" ? v.toFixed(1) : (v ? "true" : "false");
};
console.log(toStr(3));
console.log(toStr(false));التضييق داخل التنفيذ
يجب أن يتعامل التنفيذ مع جميع أشكال التحميل الزائد. استخدم فحوصات in أو اتحادات مميَّزة للتفرّع بأمان.
function area(value: { r: number } | { w: number; h: number }): number {
if ("r" in value) {
return Math.PI * value.r ** 2; // circle
}
return value.w * value.h; // rect
}
console.log(area({ r: 2 }));
console.log(area({ w: 3, h: 4 }));التحميلات الزائدة مقابل الاتحادات
التحميلات الزائدة مقابل الاتحادات:
- توفر التحميلات الزائدة أنواعاً دقيقة للقيم المرجعة لكل استدعاء.
- تحافظ الاتحادات على توقيع واحد، وهي أبسط ولكنها أقل تحديداً.
- اختر التحميلات الزائدة عندما يستفيد المستدعون من أنواع مرجعة دقيقة.
نصائح DX
نصائح:
- حافظ على عدد التحميلات الزائدة صغيراً وواضحاً.
- وثّق الاختلافات في المعاملات والقيم المرجعة.
- فضّل دقة نوع القيمة المرجعة عندما تحسّن تجربة الاستخدام.
فحص التحميل الزائد
فحص سريع: ما النمط الذي يصرّح عن تحميلات الدالة الزائدة بطريقة صحيحة؟
خلاصة
خلاصة: استخدم التحميلات الزائدة للحصول على أنواع دقيقة لكل استدعاء، واستخدم تواقيع الاستدعاء لنمذجة الكائنات القابلة للاستدعاء. ضيّق الأنواع داخل التنفيذ الوحيد لتغطية كل حالة.
الأسئلة الشائعة
هل درس «التحميل الزائد للدوال وتوقيعات الاستدعاء» مجاني؟
نعم — نص درس «التحميل الزائد للدوال وتوقيعات الاستدعاء» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة TypeScript Academy، انتقل إلى CoddyKit PRO. تتضمن دورة TypeScript Academy 3 دروس في المجموع.
ماذا ستتعلم في «التحميل الزائد للدوال وتوقيعات الاستدعاء»؟
صرّح بتوقيعات التحميل الزائد لأشكال الاستدعاء المختلفة، واستخدم توقيعات الاستدعاء داخل أنواع الكائنات لإنشاء واجهات برمجية مرنة. تتمرن على TypeScript Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ TypeScript Academy؟
لا تُشترط خبرة سابقة. TypeScript Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 1 من أصل 3.
كم من الوقت يستغرق درس «التحميل الزائد للدوال وتوقيعات الاستدعاء»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس TypeScript Academy هذا؟
نعم. كل درس في TypeScript Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- التحميل الزائد للدوال وتوقيعات الاستدعاء
- كتابة معامل this؛ void و never
- دوال التأكيد وحواجز الأنواع المعرّفة من المستخدم