EventEmitter भनेको के हो र यो कसरी प्रयोग गरिन्छ?

Question

Accepted Answer

**EventEmitter** Node को एक मूल वर्ग हो जो **publish/subscribe** प्याटर्न लागू गर्छ: वस्तुहरूले नाम गरिएका घटनाहरू उत्सर्जित गर्छन्, र ती घटनाहरूको लागि दर्ता गरिएका श्रोताहरू तिनीहरू फायर हुँदा चल्छन्। नोडको आफ्नै API को अधिकांश (streams, HTTP servers, process) यसमा निर्मित छ।

## आधारभूत प्रयोग

```js
import { EventEmitter } from "events";

const emitter = new EventEmitter();

// SUBSCRIBE: register a listener for an event
emitter.on("order", (order) => {
  console.log(`Processing order ${order.id}`);
});

// PUBLISH: emit the event (with optional data)
emitter.emit("order", { id: 123 }); // → "Processing order 123"
```

प्याटर्न: `on(event, listener)` सदस्यता लिन्छ; `emit(event, ...args)` त्यो घटनाको सबै श्रोताहरूलाई सिंक्रोनसली ट्रिगर गर्छ, तर्कहरू पास गर्छ।

## आपनो स्वयंको वर्गहरूको लागि EventEmitter विस्तार गर्दै

```js
class OrderService extends EventEmitter {
  placeOrder(order) {
    // ...save the order...
    this.emit("order:created", order);  // notify anyone interested
  }
}

const service = new OrderService();
service.on("order:created", (o) => sendEmail(o));   // decoupled listeners
service.on("order:created", (o) => updateAnalytics(o));
service.placeOrder({ id: 1 }); // both listeners run
```

यसले emitter लाई यसको श्रोताहरूबाट अलग गर्छ — `OrderService` जान्दैन वा कसले सुन्दैछ भन्ने बारेमा चिन्ता गर्दैन, त्यसैले तपाइँ यसलाई परिमार्जन नगरी प्रतिक्रियाहरू (email, analytics, logging) जोड्न सक्नुहुन्छ।

## उपयोगी विधिहरू

```js
emitter.once("ready", fn);          // listener runs only ONCE, then auto-removes
emitter.off("order", fn);           // remove a listener (prevent leaks)
emitter.emit("error", new Error()); // "error" is special — throws if no listener!
emitter.listenerCount("order");
```

## दुई महत्त्वपूर्ण gotchas

```text
⚠️ Memory leaks: forgetting to remove listeners (use off/once). Node warns at >10
   listeners on one event ("possible EventEmitter memory leak").
⚠️ The "error" event: if emitted with no listener, Node THROWS and may crash —
   always attach an error listener to emitters that can error (streams!).
```

## नोड आफैमा कहाँ प्रयोग गरिन्छ

```text
streams (data, end, error events), http.Server (request event),
process (SIGTERM, exit), sockets — all are EventEmitters.
```

## यो किन महत्त्वपूर्ण छ

EventEmitter Node को घटना-संचालित आर्किटेक्चरको आधार हो — यसलाई बुझ्दा यो व्याख्या गर्छ कि streams, servers, र process object कसरी काम गर्छन् (ती सबै emitters हुन्), र यो आपनो कोडमा अपयुक्त, घटना-आधारित संचारको लागि मानक उपकरण हो।

`on`/`emit`/`once`/`off` API, हटाइएन श्रोताहरूबाट memory-leak को जोखिम, र विशेष crash-कारण `error` घटनाको ज्ञान Node को APIs सही तरिकाले प्रयोग गर्न र रखरखाव योग्य घटना-संचालित प्रणाली निर्माण गर्नको लागि आवश्यक छ।