Çfarë është EventEmitter dhe si përdoret?

Question

Accepted Answer

**EventEmitter** është një klasë bërthamore e Node që zbaton modelin **publish/subscribe**: objektet emetojnë ngjarje të emëruara, dhe dëgjuesit e regjistruar për ato ngjarje ekzekutohen kur ato ndodhin. Shumë nga API-ja e vetë Node (streams, HTTP servers, process) është ndërtuar mbi të.

## Përdorimi bazik

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

Modeli: `on(event, listener)` abonohet; `emit(event, ...args)` aktivizon të gjithë dëgjuesit për atë ngjarje në mënyrë sinkrone, duke kaluar argumentet.

## Zgjerimi i EventEmitter për klasat tuaja

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

Kjo e shkëput emetuesin nga dëgjuesit e tij — `OrderService` nuk e di ose nuk i intereson kush po dëgjon, kështu që mund të shtoni reagime (email, analytics, logging) pa e ndryshuar atë.

## Metoda të dobishme

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

## Dy mangësi të rëndësishme

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

## Ku përdoret në vetë Node

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

## Pse është e rëndësishme

EventEmitter është themeli i arkitekturës event-driven të Node — kuptimi i tij shpjegon se si funksionojnë streams, servers dhe objekti process (ato janë të gjitha emeterues), dhe është mjeti standard për komunikim të decoupled, të bazuar në ngjarje në kodin tuaj.

Njohuritë e API-ve `on`/`emit`/`once`/`off`, rreziku i rrjedhjeve të memorjes nga dëgjuesit e hequr dhe ngjalja e veçantë `error` e shkaktuar nga ataku është thelbësore si për përdorimin e duhur të API-ve të Node ashtu edhe për ndërtimin e sistemeve të qëndrueshme event-driven.