Apa itu dekorator dan bagaimana cara menggunakannya?

Question

Accepted Answer

**Dekorator** adalah deklarasi khusus (`@name`) yang menambahkan perilaku atau metadata ke kelas, metode, properti, atau parameter. Ini adalah fungsi yang dipanggil runtime dengan target yang didekorasi, memungkinkan Anda membungkus atau memberi anotasi secara deklaratif.

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

Dekorator menerima deskriptor metode dan menggantinya dengan wrapper — perilaku lintas potongan (logging, caching, timing) tanpa menyentuh badan metode.

## Tempat Anda paling sering melihatnya: framework

```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, dan class-validator dibangun di sekitar dekorator untuk DI, routing, pemetaan ORM, dan validasi.

## Dua varian (penting)

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

**Dekorator warisan (eksperimental)** di atas adalah apa yang diandalkan Nest/Angular/TypeORM saat ini. Ada juga **dekorator TC39 Stage-3** yang lebih baru (TS 5+) dengan tanda tangan yang berbeda, yang merupakan standar masa depan — tetapi sebagian besar framework yang ada masih menggunakan bentuk warisan.

## Mengapa ini penting

Dekorator memungkinkan meta-programming yang bersih dan deklaratif — tulang punggung framework server dan ORM.

Mengetahui mekanisme (fungsi yang membungkus target) dan pembagian warisan-versus-standar sangat penting untuk bekerja di ekosistem NestJS/Angular.