Che cos'è l'EventEmitter e come si usa?

Question

Accepted Answer

**EventEmitter** è una classe core di Node che implementa il pattern **publish/subscribe**: gli oggetti emettono eventi denominati, e i listener registrati per quegli eventi vengono eseguiti quando si verificano. Gran parte della stessa API di Node (stream, server HTTP, process) è costruita su di essa.

## Utilizzo di base

```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 pattern: `on(event, listener)` si iscrive; `emit(event, ...args)` attiva tutti i listener per quell'evento in modo sincrono, passando gli argomenti.

## Estendere EventEmitter per le tue classi

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

Questo disaccoppia l'emitter dai suoi listener — `OrderService` non sa né gli importa chi sta ascoltando, quindi puoi aggiungere reazioni (email, analitiche, logging) senza modificarlo.

## Metodi utili

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

## Due importanti insidie

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

## Dove viene utilizzato in Node stesso

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

## Perché è importante

EventEmitter è la base dell'architettura event-driven di Node — comprenderla spiega come funzionano stream, server e l'oggetto process (sono tutti emitter), ed è lo strumento standard per la comunicazione disaccoppiata e basata su eventi nel tuo codice.

Conoscere l'API `on`/`emit`/`once`/`off`, il rischio di memory leak dai listener non rimossi e lo speciale evento `error` che causa crash è essenziale sia per utilizzare correttamente le API di Node che per costruire sistemi event-driven mantenibili.