デコレーターとは何で、どのように使われますか?

Question

Accepted Answer

**デコレーター**は、クラス、メソッド、プロパティ、またはパラメーターに振る舞いやメタデータを追加する特別な宣言(`@name`)です。これはデコレートされた対象を引数としてランタイムが呼び出す関数であり、宣言的に対象をラップしたり注釈を付けたりできます。

```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 マッピング、バリデーションのためにデコレーターを中心に構築されています。

## 2つの種類(重要)

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

上記の**レガシー(実験的)**デコレーターは、現在 Nest/Angular/TypeORM が依存しているものです。また、異なるシグネチャを持つ、より新しい **TC39 Stage-3 デコレーター**(TS 5+)もあり、これが将来の標準ですが、既存のフレームワークのほとんどは依然としてレガシー形式を使っています。

## なぜ重要なのか

デコレーターはクリーンで宣言的なメタプログラミングを可能にします。これはサーバーフレームワークや ORM の屋台骨です。

その仕組み(対象をラップする関数)と、レガシー対標準の分岐の両方を理解することは、NestJS/Angular エコシステムで作業するために不可欠です。