Qu'est-ce que les décorateurs et comment sont-ils utilisés?

Question

Accepted Answer

Un **décorateur** est une déclaration spéciale (`@name`) qui ajoute un comportement ou des métadonnées à une classe, une méthode, une propriété ou un paramètre. C'est une fonction que le runtime appelle avec la cible décorée, vous permettant de l'envelopper ou de l'annoter de manière déclarative.

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

Le décorateur a reçu le descripteur de méthode et l'a remplacé par un wrapper — comportement transversal (logging, caching, timing) sans toucher au corps de la méthode.

## Où vous les voyez le plus : les 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 et class-validator sont construits autour des décorateurs pour l'injection de dépendances, le routage, la cartographie ORM et la validation.

## Deux saveurs (important)

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

Les décorateurs **legacy (expérimentaux)** ci-dessus sont ceux sur lesquels Nest/Angular/TypeORM s'appuient aujourd'hui. Il y a aussi les décorateurs **TC39 Stage-3** plus récents (TS 5+) avec une signature différente, qui sont la norme future — mais la plupart des frameworks existants utilisent toujours la forme legacy.

## Pourquoi c'est important

Les décorateurs permettent une meta-programmation propre et déclarative — l'épine dorsale des frameworks serveur et des ORM.

Connaître à la fois le mécanisme (une fonction enrobant une cible) et la scission legacy-vs-standard est essentiel pour travailler dans l'écosystème NestJS/Angular.