الدوال

Functions

مفهوم ~17 دقيقة

الدوال — Functions

الدالة هي عقد صغير: ما الذي تحتاجه؟ وماذا ترجع؟ في TypeScript نكتب أنواع المعاملات، وغالباً نكتب نوع القيمة المرجعة للدوال المهمة. هذا يجعل الخطأ واضحاً عندما تغير التنفيذ. إذا قلت إن الدالة ترجع string ثم أرجعت رقماً، سينبهك TypeScript.

لا تجعل الدالة تفعل كل شيء. دالة تحسب، ودالة تنسق، ودالة تطبع. هذا الفصل البسيط بين المسؤوليات يجعل الاختبار أسهل. دالة مثل formatMinutes(minutes: number): string أفضل من خلط الحساب والطباعة والمنطق داخل مكان واحد.

مثال عملي

index.ts

function formatMinutes(minutes: number): string {
  return `${minutes} minutes`;
}

function add(a: number, b: number): number {
  return a + b;
}

const total = add(20, 25);
console.log(formatMinutes(total));

Output:

لاحظ أن formatMinutes لا تطبع. هي ترجع نصاً. هذا يجعلها قابلة للاستخدام في console أو UI أو اختبار.

قيمة الإرجاع

إذا كانت الدالة لا ترجع شيئاً، نوعها void. لا تكثر من void في منطقك الأساسي؛ الدوال التي ترجع قيمة أسهل في الاختبار والتكوين.

تحدي — Challenge

function add(a: number, b: number): number {
  /* TODO */ return 0;
}

console.log(`total=${add(3, 4)}`);