Co jsou dekorátory a jak se používají?

Question

Accepted Answer

**Dekorátor** je speciální deklarace (`@name`), která přidává chování nebo metadata třídě, metodě, vlastnosti nebo parametru. Je to funkce, kterou runtime zavolá s dekorovaným cílem, která vám umožňuje jej deklarativně obalit nebo opatřit poznámkou.

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

Dekorátor obdržel popis metody a nahradil jej wrapperem — cross-cutting chování (logování, caching, časování) bez dotyku těla metody.

## Kde je vidíte nejčastěji: frameworky

```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 a class-validator jsou postaveny kolem dekorátorů pro DI, směrování, mapování ORM a validaci.

## Dvě varianty (důležité)

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

**Starší (experimentální)** dekorátory výše jsou ty, na které se dnes Nest/Angular/TypeORM spoléhají. Existují také novější **TC39 Stage-3 dekorátory** (TS 5+) s jinou signaturou, která je budoucí standard — ale většina stávajících frameworků stále používá starou formu.

## Proč to důležité

Dekorátory umožňují čisté, deklarativní meta-programování — páteř serverových frameworků a ORM.

Znalost jak mechanismu (funkce obalující cíl), tak rozdílu mezi starým a standardem je nezbytná pro práci v ekosystému NestJS/Angular.