Cad is EventEmitter ann agus conas a úsáidtear é?

Question

Accepted Answer

**EventEmitter** is rang bhunúsach Node a bhíonn i bhfeidhm an phátrúin **publish/subscribe**: astaíonn oibiachtanna imeachtaí ainmnithe, agus ritheann éisteoirí a bhíonn cláraithe do na himeachtaí sin nuair a dhéanann siad soilsiú. Tógtha ar bhunús mó de API Node féin (sruthanna, fhreastalaí HTTP, próiseas) air.

## Úsáid bhunúsach

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

An pátrún: `on(event, listener)` a thaifeadadh; `emit(event, ...args)` a bhíonn ag soilsiú do gach éisteoir don imeacht sin go sioncronach, agus na hargóintí á bhfoluain.

## EventEmitter a shíneadh le do ghréine a bhí i do chúrsa

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

Seo a dhíchumasc an astaer ó na éisteoirí – níl `OrderService` ann ach go bhfuil fhios aici cé atá ag éisteacht nó nach bhfuil, agus is féidir leat gníomhartha (ríomhphost, anailís, logáil) a chur leis gan a bheith ag athrú.

## Modhanna úsáideach

```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");
```

## Dhá bhréag thábhachtach

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

## Áit a úsáidtear é i Node féin

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

## Cén fáth a bhíonn tábhacht ann

EventEmitter is bunús ailtireachta dhríofa ar imeachtaí Node — tugann tuiscint air fúithi conas a bhíonn sruthanna, freastalaí, agus an próiseas ag obair (astaer iad go léir), agus is an ghréine caighdeánach é do chumann dhíchumasc, dhríofa ar imeachtaí i do chód féin.

A bheith ar eolas an `on`/`emit`/`once`/`off` API, an baol cailliúnaí cuimhne ó éisteoirí nach bhfuarthas ar shiúl, agus an imeacht speisialta `error` a bhíonn ag crascadh riachtanach don úsáid API Node a dhéanamh i gceart agus córais dhríofa ar imeachtaí a fhorbirt ar bhealach is fearr.