name(arg: T): R تعليقات أنواع الدوال

آخر تحديث: 2026-10-22

name(arg: T): R تعليقات أنواع الدوال

توضّح تعليقات الدوال أنواعَ المعاملات وقيمة الإرجاع: يرى المستدعي بنظرة واحدة «ماذا يمرر وماذا يحصل عليه»، وتمرير نوع خاطئ يُمنع في وقت الترجمة مباشرة. وبدون تعليقات يمكن لـ TS الاعتماد على الاستدلال كشبكة أمان، لكن التعليق الصريح هو الأدب الأساسي للواجهات البرمجية العامة.

ℹ️ معلومة يحوّل المحرر لغة TypeScript إلى JavaScript ثم يشغّلها (بدون فحص أنواع)؛ راجع ناتج كل مثال لنتيجة فحص الأنواع.

📝 الصيغة

// أجرة الشحن = أساسية + إضافة عن كل كيلوغرام
function shippingFee(weightKg: number, express: boolean): number {
  return 8 + weightKg * (express ? 3.5 : 1.5);
}

const calc: (w: number, express: boolean) => number = shippingFee;

// لا قيمة إرجاع ذات معنى → void
function notify(msg: string): void {
  console.log(msg);
}

⚙️ المعاملات

القيمة المُعادة：يُكتب نوع قيمة الإرجاع بعد قائمة المعاملات (: number)، ويتحقق المترجم من توافق كل return معه؛ وإذا أُغفل استُنتج من جسم الدالة.

▶ مثال

عدّل الكود أدناه واضغط «جرّب» لرؤية نتيجة التحويل:

الناتج：

عادي: 11
سريع: 15

(مخرجات التشغيل بعد التحويل؛ shippingFee(2, "yes") ستعطي خطأ ترجمة — المعامل الثاني يجب أن يكون boolean)

💡 نقاط مهمة

🏷️ الدوال والأصناف ذات صلة

💡 حالات ذات صلة

📚 دروس ذات صلة

❓ أسئلة شائعة

فريق Web-Tutorial التقني

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

من نحن