Tema 12 · WebSockets en Vivo

12. Comunicación Bidireccional en Tiempo Real con WebSockets y Socket.io

Integra un servidor Socket.io sobre el servidor HTTP de Express, gestiona salas privadas (rooms), difunde eventos en tiempo real y autentica sockets con tokens JWT.

Tiempo Real con WebSockets y Socket.io en Express

Las peticiones HTTP son unidireccionales y efímeras (el cliente pregunta, el servidor responde y la conexión se cierra). Para chats, notificaciones en vivo, paneles de control colaborativos o seguimiento GPS, el protocolo WebSocket mantiene un canal TCP bidireccional y persistente con una sobrecarga de cabeceras casi nula.

1. Integración con el Servidor HTTP Nativo de Node.js

Dado que Socket.io debe realizar el apretón de manos (Handshake / Upgrade) a nivel de transporte HTTP, no se acopla directamente a app de Express, sino al servidor http.createServer(app).

2. Conceptos Esenciales de Socket.io

io.emit vs socket.emit

socket.emit() envía un mensaje exclusivamente al cliente emisor; socket.broadcast.emit() a todos excepto a él; y io.emit() a todos los clientes conectados.

Salas Privadas (Rooms)

Permiten segmentar clientes (ej. socket.join('pedido_1024')) para emitir eventos dirigidos sólo a los interesados con io.to('pedido_1024').emit(...).

Middleware de Autenticación

Socket.io permite registrar middlewares como io.use((socket, next) => {}) para validar el token JWT antes de permitir la conexión.

⚡ Servidor Express + Socket.io con Autenticación JWT y Rooms

Montaje de servidor HTTP compartido con canal WebSocket seguro.

socketServer.js
Solo lectura
import http from 'http';
import express from 'express';
import { Server } from 'socket.io';
import { TokenService } from './tokenService.js';

const app = express();
const server = http.createServer(app);

// 1. INICIALIZAR SOCKET.IO SOBRE EL SERVIDOR HTTP
const io = new Server(server, {
  cors: {
    origin: process.env.CLIENT_ORIGIN || 'http://localhost:5173',
    methods: ['GET', 'POST'],
    credentials: true,
  },
});

// 2. MIDDLEWARE DE AUTENTICACIÓN PARA SOCKETS
io.use((socket, next) => {
  const token = socket.handshake.auth.token || socket.handshake.headers['authorization'];

  if (!token) {
    return next(new Error('Autenticación requerida: token no suministrado.'));
  }

  try {
    const cleanToken = token.startsWith('Bearer ') ? token.slice(7) : token;
    const user = TokenService.verifyAccessToken(cleanToken);
    socket.user = user; // Inyecta datos del usuario en la instancia del socket
    next();
  } catch (err) {
    next(new Error('Token de autenticación de socket inválido o expirado.'));
  }
});

// 3. GESTIÓN DE EVENTOS DE CONEXIÓN
io.on('connection', (socket) => {
  console.log(`[Socket] Cliente conectado: ${socket.user.email} (ID: ${socket.id})`);

  // Unirse a una sala específica (ej: canal de notificaciones personales)
  socket.join(`user_${socket.user.sub}`);

  // Manejar evento de unirse a una sala de chat o seguimiento de pedido
  socket.on('unirse_sala', (salaId) => {
    socket.join(salaId);
    console.log(`[Socket] ${socket.user.email} se unió a la sala: ${salaId}`);
  });

  // Escuchar mensaje entrante y reenviarlo sólo a los miembros de la sala
  socket.on('enviar_mensaje', ({ salaId, texto }) => {
    io.to(salaId).emit('nuevo_mensaje', {
      emisor: socket.user.email,
      texto,
      fecha: new Date().toISOString(),
    });
  });

  // Notificar desconexión
  socket.on('disconnect', (reason) => {
    console.log(`[Socket] Desconectado: ${socket.user.email} (${reason})`);
  });
});

export { app, server, io };
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Por qué al configurar Socket.io con Express se utiliza http.createServer(app) en lugar de pasar directamente la instancia app a la clase Server?
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar Express.js: Framework Backend & APIs Empresariales 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.