آپ متغیرات، پیرامیٹرز اور واپسی کی اقسام کو کیسے نوٹ کرتے ہیں؟

Question

Accepted Answer

آپ ایک کالن کے بعد ایک قسم شامل کرتے ہیں۔ TypeScript بہت سی اقسام کو **اندازہ** لگا سکتا ہے، اس لیے آپ جہاں یہ وضاحت شامل کرتا ہے یا جہاں اندازہ ممکن نہیں ہے وہاں نوٹ کرتے ہیں۔

```ts
// variables — usually let inference work
let count: number = 0;     // explicit
let name = "Ann";          // inferred as string (annotation redundant)

// function parameters — always annotate (can't be inferred)
function greet(name: string, times: number): string {
  return name.repeat(times);
}

// arrays and objects
const ids: number[] = [1, 2, 3];
const user: { name: string; age: number } = { name: "Ann", age: 30 };
```

## واپسی کی اقسام: اندازہ یا نوٹ کریں؟

```ts
function add(a: number, b: number) { return a + b; } // inferred return: number
function load(): Promise<User> { ... }                // explicit — documents the contract
```

واپسی کی اقسام اندازہ لگائی جاتی ہیں، لیکن انہیں برآمد/عوامی افعال پر نوٹ کرنا اچھی عمل ہے: یہ مقصد کو دستاویز کرتا ہے اور *فنکشن کے اندر* غلطیوں کو پکڑتا ہے (اگر آپ نیچے غلط چیز واپس کرتے ہیں، تو غلطی فنکشن کی طرف اشارہ کرتی ہے، اس کے کالرز کی نہیں)۔

## خصوصی صورتیں

```ts
function log(msg: string): void {}     // returns nothing
function fail(): never { throw new Error(); } // never returns normally
const fn: (x: number) => string = ...; // function type annotation
```

## یہ کیوں اہم ہے

انگوٹھے کا اصول: **فنکشن کے دستخط (پیرامیٹرز اور عوامی واپسی کی اقسام) کو واضح طور پر نوٹ کریں، مقامی متغیرات کو اندازہ لگانے دیں۔** یہ کوڈ کو مختصر رکھتے ہوئے فنکشن کی حدود میں معاہدوں کو واضح اور تصدیق شدہ رکھتا ہے۔