Что такое декораторы и как их использовать?

Question

Accepted Answer

**Декоратор** — это специальное объявление (`@name`), которое добавляет поведение или метаданные к классу, методу, свойству или параметру. Это функция, которую runtime вызывает с декорируемой целью, позволяя вам оборачивать или аннотировать её декларативно.

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

Декоратор получил дескриптор метода и заменил его на обёртку — сквозное поведение (логирование, кэширование, подсчёт времени) без изменения тела метода.

## Где вы их встречаете больше всего: фреймворки

```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 и class-validator построены вокруг декораторов для DI, маршрутизации, ORM-маппинга и валидации.

## Две разновидности (важно)

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

**Устаревшие (экспериментальные)** декораторы выше — это то, на что полагаются Nest/Angular/TypeORM сегодня. Есть также более новые **TC39 Stage-3 декораторы** (TS 5+) с другой сигнатурой, которые являются будущим стандартом — но большинство существующих фреймворков всё ещё используют устаревшую форму.

## Почему это важно

Декораторы позволяют чистое, декларативное мета-программирование — основу серверных фреймворков и ORM.

Знание как механизма (функция, оборачивающая цель), так и различия между устаревшей и стандартной версией критично для работы в экосистеме NestJS/Angular.