Decorators คืออะไร และใช้งานอย่างไร?

Question

Accepted Answer

**Decorator** คือการประกาศพิเศษ (`@name`) ที่เพิ่มพฤติกรรมหรือ metadata ให้กับคลาส เมธอด พร็อพเพอร์ตี้ หรือพารามิเตอร์ เป็นฟังก์ชันที่ runtime เรียกใช้กับเป้าหมายที่ถูก decorated ซึ่งให้คุณสามารถห่อหรือประกาศให้คุณลักษณะต่างๆ ได้แบบ declarative

```ts
// A simple method decorator that logs calls
function log(target: any, key: string, desc: PropertyDescriptor) {
  const original = desc.value;
  desc.value = function (...args: any[]) {     // wrap the original method
    console.log(`calling ${key} with`, args);
    return original.apply(this, args);
  };
}

class Service {
  @log
  fetch(id: number) { return { id }; }
}
new Service().fetch(1); // logs "calling fetch with [1]" then runs
```

Decorator ได้รับ method descriptor และแทนที่มันด้วย wrapper — cross-cutting behavior (logging, caching, timing) โดยไม่ต้องเปลี่ยนแปลง method body

## ที่ที่คุณเห็นมากที่สุด: frameworks

```ts
@Controller("users")          // NestJS — declares a route controller
export class UsersController {
  @Get(":id")                 // maps GET /users/:id
  findOne(@Param("id") id: string) { return id; } // param decorator injects the route param
}

@Entity()                     // TypeORM — maps a class to a DB table
class User { @Column() name: string; }
```

NestJS, Angular, TypeORM, และ class-validator ถูกสร้างขึ้นโดยใช้ decorators สำหรับ DI, routing, ORM mapping, และ validation

## สองรูปแบบ (สำคัญ)

```json
{ "experimentalDecorators": true, "emitDecoratorMetadata": true }
```

**Legacy (experimental) decorators** ข้างต้นคือสิ่งที่ Nest/Angular/TypeORM ใช้อยู่ในปัจจุบัน มีอีก **TC39 Stage-3 decorators** ที่ใหม่กว่า (TS 5+) ที่มี signature ต่างกัน ซึ่งเป็นมาตรฐานในอนาคต — แต่ frameworks ที่มีอยู่ส่วนใหญ่ยังคงใช้รูปแบบ legacy

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

Decorators ช่วยให้สามารถทำ clean, declarative meta-programming — เป็นกระดูกสันหลังของ server frameworks และ ORM

การรู้ทั้งกลไก (ฟังก์ชันที่ห่อเป้าหมาย) และการแบ่งแยก legacy-vs-standard เป็นสิ่งจำเป็นสำหรับการทำงานใน NestJS/Angular ecosystem