डेकोरेटर क्या हैं और उनका उपयोग कैसे किया जाता है?

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

डेकोरेटर ने विधि वर्णनकर्ता को प्राप्त किया और इसे एक रैपर से बदल दिया — क्रॉस-कटिंग व्यवहार (लॉगिंग, कैशिंग, टाइमिंग) विधि बॉडी को छुए बिना।

## जहां आप उन्हें सबसे अधिक देखते हैं: 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, और class-validator DI, रूटिंग, ORM मैपिंग, और सत्यापन के लिए डेकोरेटर के चारों ओर बनाए गए हैं।

## दो स्वाद (महत्वपूर्ण)

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

**विरासत (प्रायोगिक)** डेकोरेटर ऊपर वे हैं जिन पर Nest/Angular/TypeORM आज निर्भर करते हैं। **TC39 Stage-3 डेकोरेटर** (TS 5+) का एक नया संस्करण भी है जिसमें एक अलग हस्ताक्षर है, जो भविष्य का मानक है — लेकिन अधिकांश मौजूदा frameworks अभी भी विरासत रूप का उपयोग करते हैं।

## इसका महत्व क्यों है

डेकोरेटर स्वच्छ, घोषणात्मक मेटा-प्रोग्रामिंग को सक्षम करते हैं — सर्वर frameworks और ORMs की रीढ़।

मैकेनिज्म (एक लक्ष्य को लपेटने वाला फ़ंक्शन) और विरासत-बनाम-मानक विभाजन दोनों को जानना NestJS/Angular पारिस्थितिकी तंत्र में काम करने के लिए आवश्यक है।