Tema 9 · Eventos & EventEmitter

9. Arquitectura Orientada a Eventos: EventEmitter y el Patrón Publicador/Suscriptor

Implementa arquitecturas desacopladas basadas en eventos con la clase EventEmitter nativa: suscripciones con .on(), ejecución única con .once() y emisión con .emit().

El Corazón de Node: Arquitectura Orientada a Eventos

La gran mayoría de los módulos nativos de Node.js (como los servidores HTTP, sockets TCP, streams y procesos hijos) heredan internamente de una clase fundamental: EventEmitter del módulo node:events.

Esta clase implementa el patrón de diseño Publicador / Suscriptor (Pub/Sub), permitiendo que distintas partes de un sistema se comuniquen sin acoplarse directamente entre sí.

Métodos Fundamentales de EventEmitter

  • emitter.on(nombreEvento, listener): Registra una función suscriptora que se ejecutará cada vez que el evento sea emitido.
  • emitter.once(nombreEvento, listener): Registra un suscriptor que solo se ejecutará una única vez, autoeliminándose inmediatamente después de su primer disparo.
  • emitter.emit(nombreEvento, ...argumentos): Dispara el evento y ejecuta síncronamente a todos los suscriptores registrados en el orden en que fueron añadidos, pasándoles los argumentos provistos.
  • emitter.off(nombreEvento, listener): Remueve un suscriptor específico para evitar fugas de memoria (memory leaks).

El Evento Crítico 'error'

⚠️ Regla Fundamental en Node.js: Si un EventEmitter emite un evento llamado 'error' y no existe ningún listener registrado para escucharlo (emitter.on('error', ...)), Node.js considerará el fallo como una excepción no controlada, imprimirá la traza completa y abortará inmediatamente el proceso del servidor. ¡Registra siempre un manejador de error en tus emisores!

⚡ Sistema Desacoplado de Registro de Usuarios con EventEmitter

Ejemplo práctico donde el registro de un estudiante dispara alertas, correos y métricas de forma independiente:

user-events.js
Solo lectura
// user-events.js - Patrón Pub/Sub con EventEmitter en Node.js
import { EventEmitter } from 'node:events';

class ServicioUsuarios extends EventEmitter {
  registrar(nombre, email) {
    console.log(`[Base de Datos] Guardando usuario: ${nombre} (${email})...`);
    
    const nuevoUsuario = { id: Date.now(), nombre, email, fecha: new Date() };

    // Emitimos el evento pasando los datos del usuario registrado
    this.emit('usuario:registrado', nuevoUsuario);
    return nuevoUsuario;
  }
}

const servicio = new ServicioUsuarios();

// Suscriptor 1: Módulo de Notificaciones por Correo
servicio.on('usuario:registrado', (usuario) => {
  console.log(`✉️ [Email] Enviando correo de bienvenida a: ${usuario.email}`);
});

// Suscriptor 2: Módulo de Auditoría y Seguridad
servicio.on('usuario:registrado', (usuario) => {
  console.log(`🛡️ [Auditoría] Evento de alta registrado para ID: ${usuario.id}`);
});

// Suscriptor 3: Módulo de Analíticas de Kilopolis (Solo la primera vez)
servicio.once('usuario:registrado', (usuario) => {
  console.log(`🎉 [Métricas] Primer usuario activo de la jornada: ${usuario.nombre}`);
});

// Manejo obligatorio del evento de error
servicio.on('error', (err) => {
  console.error('❌ Error capturado en el emisor:', err.message);
});

// Ejecución
servicio.registrar('Samuel David', '[email protected]');
servicio.registrar('Mariana Gómez', '[email protected]');
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Qué sucede en Node.js si un EventEmitter emite un evento con nombre "error" y no hay ningún listener (on) registrado para él?
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar Node.js & npm Profesional y crear proyectos reales?

Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.