আপনি কীভাবে ভেরিয়েবল, প্যারামিটার এবং রিটার্ন টাইপগুলিতে annotations যোগ করেন?

Question

Accepted Answer

আপনি একটি কোলনের পরে একটি টাইপ যোগ করেন। TypeScript অনেক টাইপ **অনুমান** করতে পারে, তাই আপনি যেখানে এটি স্পষ্টতা যোগ করে বা যেখানে অনুমান সম্ভব নয় সেখানে annotate করেন।

```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 };
```

## রিটার্ন টাইপ: অনুমান বা annotate?

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

রিটার্ন টাইপগুলি অনুমান করা হয়, তবে সেগুলি রপ্তানি করা/সার্বজনীন ফাংশনগুলিতে annotate করা একটি ভাল অনুশীলন: এটি অভিপ্রায় নথিভুক্ত করে এবং *ফাংশনের ভিতরে* ত্রুটি ধরে ফেলে (যদি আপনি ভুলবশত ভুল কিছু রিটার্ন করেন, তো ত্রুটি ফাংশনের দিকে নির্দেশ করে, এর কলারদের দিকে নয়)।

## বিশেষ ক্ষেত্রসমূহ

```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
```

## কেন এটি গুরুত্বপূর্ণ

থাম্বের নিয়ম: **ফাংশন সিগনেচার (প্যারামিটার এবং সার্বজনীন রিটার্ন টাইপ) স্পষ্টভাবে annotate করুন, স্থানীয় ভেরিয়েবলগুলিকে অনুমান করতে দিন।** এটি কোডকে সংক্ষিপ্ত রাখে যখন ফাংশন সীমানায় চুক্তি স্পষ্ট এবং যাচাইকৃত থাকে।