EventEmitter کیا ہے اور اسے کیسے استعمال کریں؟

Question

Accepted Answer

**EventEmitter** Node کی ایک بنیادی کلاس ہے جو **publish/subscribe** نمونہ کو نافذ کرتی ہے: اشیاء نام والے واقعات کو جاری کرتے ہیں، اور ان واقعات کے لیے رجسٹرڈ سامعین جب وہ طلب کریں تو چلتے ہیں۔ Node کا اپنا 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` کو یہ نہیں معلوم یا فرق نہیں پڑتا کہ کون سن رہا ہے، تو آپ اسے تبدیل کیے بغیر ردعمل (ای میل، تجزیہ، 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");
```

## دو اہم احتیاط

```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!).
```

## Node میں اس کا استعمال کہاں ہوتا ہے

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

## یہ کیوں اہم ہے

EventEmitter Node کی event-driven تعمیر کی بنیاد ہے — اسے سمجھنا بتاتا ہے کہ streams، servers، اور process object کیسے کام کرتے ہیں (یہ تمام emitters ہیں)، اور یہ آپ کے اپنے کوڈ میں decoupled، event-based رابطے کے لیے معیاری ہے۔

`on`/`emit`/`once`/`off` API، غیر ہٹائے گئے سامعین سے memory leak کے خطرے، اور خاص crash سے متعلق `error` واقعے کو جاننا Node کے APIs کو درست طریقے سے استعمال کرنے اور قابل فہم event-driven systems بنانے کے لیے ضروری ہے۔