คุณจะใส่คำอธิบายประกอบให้กับตัวแปร พารามิเตอร์ และประเภทการส่งกลับได้อย่างไร

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

## ทำไมจึงสำคัญ

กฎทั่วไป: **ใส่คำอธิบายประกอบให้กับลายเซ็นฟังก์ชัน (พารามิเตอร์และประเภทการส่งกลับแบบสาธารณะ) อย่างชัดเจน ให้ตัวแปรในพื้นที่อนุมาน** วิธีนี้ช่วยให้โค้ดกระชับขึ้น พร้อมทำให้สัญญาในขอบเขตฟังก์ชันชัดเจนและตรวจสอบได้