X'inhu EventEmitter u kif jintuża?

Question

Accepted Answer

**EventEmitter** hija klassi ċentrali ta' Node li timplimenta l-mudell **publish/subscribe**: l-oġġetti jitollu avvenimenti nominati, u l-istlieti reġistrati għal dawk l-avvenimenti jitħarrġu meta jikkapitaw. Ħafna mill-API ta' Node nifsu (streams, HTTP servers, process) huma mibnija fuqu.

## Użu bażiku

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

Il-mudell: `on(event, listener)` jissonskribi; `emit(event, ...args)` ittrig il-listeners kollha għall-avveniment dak b'mod sinkronu, u tgħaddi l-argumenti.

## Estensjoni ta' EventEmitter għall-klassiet tiegħek

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

Dan jissoqqaf l-emitter mil-listeners tiegħu — `OrderService` ma jafx u ma jimpurtax min qed istgħu jsigħu, allura tista' tħalli reazzjonijiet (email, analytics, logging) mingħajr ma tbiddil il-kodiċi tiegħu.

## Metodi ta' fayda

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

## Żewġ gotchas importanti

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

## Fejn jintuża fil-Node nifsu

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

## Għaliex dan importanti

EventEmitter hija l-fondazzjoni tal-arkitettura ta' Node bbażata fuq-avvenimenti — il-fehim tiegħu jixraq kif streams, servers, u l-oġġett process jaħdmu (kollha huma emitters), u dan l-għodda standard għall-komunikazzjoni bbażata fuq-avvenimenti separata fil-kodiċi tiegħek.

Il-għarfien tal-API `on`/`emit`/`once`/`off`, ir-riskju ta' memory-leak mill-listeners li ma ntlebgħux, u l-avveniment spečjali `error` li jikkawża crash hija essenzjali biex tuża l-APIs ta' Node kif suppost u biex tinbena sistemi bbażati fuq-avvenimenti li jistgħu jintennew.