Ce sunt decoratorii și cum se folosesc?

Question

Accepted Answer

Un **decorator** este o declarație specială (`@name`) care adaugă comportament sau metadate unei clase, metode, proprietăți sau parametru. Este o funcție pe care runtime-ul o apelează cu ținta decorată, permițându-ți să o împachetezi sau să o anotezi declarativ.

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

Decoratorul a primit descriptorul metodei și l-a înlocuit cu un wrapper — comportament cross-cutting (logging, caching, timing) fără a modifica corpul metodei.

## Unde i se vede cel mai mult: 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 și class-validator sunt construite în jurul decoratorilor pentru DI, routing, mapare ORM și validare.

## Două variante (important)

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

**Decoratorii legacy (experimentali)** de mai sus sunt cei pe care Nest/Angular/TypeORM se bazează astazi. Există și **decoratorii TC39 Stage-3** mai noi (TS 5+) cu o semnătură diferită, care sunt standardul viitor — dar cele mai multe framework-uri existente încă folosesc forma legacy.

## De ce conteaza

Decoratorii permit meta-programare curată și declarativă — coloana vertebrală a framework-urilor server și ORM-urilor.

Cunoacuta atât mecanismul (o funcție care împachetează o țintă) cât și diferența legacy-vs-standard este esențială pentru lucrul în ecosistemul NestJS/Angular.