¿Qué son los decoradores y cómo se usan?

Question

Accepted Answer

Un **decorador** es una declaración especial (`@name`) que añade comportamiento o metadatos a una clase, método, propiedad o parámetro. Es una función que el runtime invoca con el objetivo decorado, lo que te permite envolverlo o anotarlo de forma declarativa.

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

El decorador recibió el descriptor del método y lo reemplazó por un envoltorio (wrapper): comportamiento transversal (logging, caché, medición de tiempos) sin tocar el cuerpo del método.

## Donde más los ves: los 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 y class-validator están construidos en torno a los decoradores para inyección de dependencias, enrutamiento, mapeo de ORM y validación.

## Dos variantes (importante)

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

Los decoradores **heredados (experimentales)** de arriba son los que Nest/Angular/TypeORM usan hoy en día. También existen los más nuevos **decoradores de la propuesta Stage-3 de TC39** (TS 5+) con una firma distinta, que son el estándar futuro; pero la mayoría de los frameworks existentes siguen usando la forma heredada.

## Por qué es importante

Los decoradores habilitan una metaprogramación limpia y declarativa: la columna vertebral de los frameworks de servidor y los ORM.

Conocer tanto el mecanismo (una función que envuelve un objetivo) como la división entre la forma heredada y la estándar es esencial para trabajar en el ecosistema de NestJS/Angular.