Tema 12 · Express & Middlewares

12. Introducción a Express.js: Creación de Apps, Ciclo de Vida y Middlewares

Descubre el framework web estándar de Node.js: inicialización, la función next(), middlewares de aplicación, middlewares de terceros y flujo de petición.

¿Por qué Express.js es el Estándar de la Industria?

Escribir un servidor HTTP nativo con node:http requiere decenas de líneas de código repetitivo para parsear JSON, extraer parámetros de URL y gestionar cabeceras.

Express.js es un framework minimalista, flexible y no dogmático que envuelve la API nativa de Node.js, ofreciendo un sistema de enrutamiento expresivo y una potente arquitectura de middlewares.

npm install express
Ciclo de Vida de Petición HTTP en Express y Middlewares

Diagrama 3: La tubería secuencial de middlewares en Express.js: desde la llegada del request hasta el envío del JSON.

¿Qué es Realmente un Middleware?

En Express, un middleware no es más que una función intermediaria que se ejecuta secuencialmente durante el ciclo de vida de una petición HTTP. Recibe tres parámetros esenciales:

function miMiddleware(req, res, next) {
  // 1. Puede inspeccionar o enriquecer req (ej. autenticar token)
  // 2. Puede finalizar la petición si algo está mal (res.status(401).json(...))
  // 3. O pasa el testigo al siguiente eslabón de la cadena:
  next();
}
⚠️ Regla Sagrada de los Middlewares:
Todo middleware debe hacer una de dos cosas: o bien envía una respuesta al cliente (ej. res.json()), o bien invoca a next(). Si olvidas invocar a next() y no respondes, el cliente se quedará colgado esperando.

Los Tres Tipos Clave de Middlewares

  • Middlewares Incorporados: express.json() (parsea el cuerpo JSON entrante y puebla req.body) y express.static('public') (sirve archivos estáticos como imágenes y CSS).
  • Middlewares de Terceros: cors() (permite llamadas desde otros dominios frontend) y morgan() (imprime logs coloreados de cada petición en la consola).
  • Middlewares a Nivel de Ruta: Se aplican selectivamente a rutas específicas (ej. app.post('/api/admin', requireAuth, controller)).

⚡ Aplicación Express Básica con Tubería de Middlewares y Logger Casero

Servidor Express configurado con express.json, middleware de registro y rutas básicas:

express-basic.js
Solo lectura
// express-basic.js - Servidor Express con Tubería de Middlewares
import express from 'express';

const app = express();
const PORT = 3000;

// 1. Middleware Incorporado: Parsea bodies con Content-Type: application/json
app.use(express.json());

// 2. Middleware Personalizado a Nivel de Aplicación: Logger con tiempo de respuesta
app.use((req, res, next) => {
  const inicio = Date.now();
  
  // Escuchamos el evento finish del response
  res.on('finish', () => {
    const duracion = Date.now() - inicio;
    console.log(`[${req.method}] ${req.originalUrl} ➔ ${res.statusCode} (${duracion}ms)`);
  });

  next(); // ¡Indispensable pasar al siguiente middleware!
});

// 3. Ruta Principal (GET)
app.get('/', (req, res) => {
  res.json({
    plataforma: 'Kilopolis Academia',
    framework: 'Express.js 4.x',
    estado: 'Operacional'
  });
});

// 4. Ruta con Recepción de Datos en req.body (POST)
app.post('/api/mensajes', (req, res) => {
  const { texto, autor } = req.body;

  if (!texto || !autor) {
    return res.status(400).json({ error: 'Campos "texto" y "autor" son obligatorios' });
  }

  res.status(201).json({
    mensaje: 'Publicación creada con éxito',
    item: { id: Date.now(), texto, autor }
  });
});

app.listen(PORT, () => {
  console.log(`🚀 Servidor Express escuchando en http://localhost:${PORT}`);
});
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
En Express.js, ¿qué función cumple el tercer parámetro "next" dentro de un middleware?
🦉
¿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.