Czym są dekoratory i jak się ich używa?

Question

Accepted Answer

**Dekorator** to specjalna deklaracja (`@name`), która dodaje zachowanie lub metadane do klasy, metody, właściwości lub parametru. To funkcja, którą runtime wywołuje z dekorowanym celem, pozwalając ci opakowywać lub opatrywać go deklaratywnie.

```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 otrzymał deskryptor metody i zastąpił go wrapperem — zachowanie dotyczące wielu aspektów (logowanie, cache'owanie, pomiar czasu) bez dotykania ciała metody.

## Gdzie je widać najczęściej: frameworki

```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 są zbudowane wokół dekoratorów do DI, routingu, mapowania ORM i walidacji.

## Dwa warianty (ważne)

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

**Tradycyjne (eksperymentalne)** dekoratory powyżej to te, na których polegają dzisiaj Nest/Angular/TypeORM. Istnieje także nowszy format **TC39 Stage-3 decorators** (TS 5+) z inną sygnaturą, który jest przyszłym standardem — ale większość istniejących frameworków wciąż używa formy tradycyjnej.

## Dlaczego to ważne

Dekoratory umożliwiają czystą, deklaratywną meta-programowanie — podstawę frameworków serwerowych i ORM.

Znajomość zarówno mechanizmu (funkcja opakowująca cel) jak i podziału tradycyjny-vs-standardowy jest niezbędna do pracy w ekosystemie NestJS/Angular.