كيف تكتب الدوال، بما في ذلك المعاملات الاختيارية والافتراضية؟

Question

Accepted Answer

تكتب المعاملات وقيمة الإرجاع، و TypeScript يدعم المعاملات الاختيارية والافتراضية ومعاملات rest.

```ts
// basic
function add(a: number, b: number): number { return a + b; }

// optional parameter (?) — must come after required ones
function greet(name: string, title?: string): string {
  return title ? `${title} ${name}` : name; // title is string | undefined
}

// default parameter — implies optional
function inc(n: number, by: number = 1): number { return n + by; }

// rest parameter — typed as an array
function sum(...nums: number[]): number {
  return nums.reduce((a, n) => a + n, 0);
}
```

## Function type expressions

يمكنك وصف *signature* الدالة كنوع — مفيد للـ callbacks والمتغيرات التي تحتفظ بالدوال:

```ts
type BinaryOp = (a: number, b: number) => number;
const multiply: BinaryOp = (a, b) => a * b; // params inferred from BinaryOp

// callback parameter
function apply(op: (x: number) => number, val: number) { return op(val); }
```

## Overloads (multiple signatures)

```ts
function parse(x: string): number;
function parse(x: number): string;
function parse(x: any): any { return typeof x === "string" ? +x : String(x); }
```

## لماذا يهم هذا

كتابة الدوال بدقة هي جوهر قيمة TypeScript — يحصل المستدعون على معاملات مفحوصة وأنواع إرجاع معروفة، والمعاملات الاختيارية والافتراضية تمثل المرونة في العالم الحقيقي، وأسماء الدوال النوعية تجعل الكود من الرتبة الأعلى (callbacks وقادة الأحداث والـ middleware) موثقة ذاتيًا وآمنة.