Conceptos básicos de Express

Q: ¿Express 5 está listo para producción?

Sí, en Node 24 LTS. Es la versión principal latest actual de npm. Migra de Express 4 usando los patrones de la guía de migración oficial en Migración a Express 5.

Q: ¿Debo usar app.listen o http.createServer?

app.listen está bien para la mayoría de las aplicaciones. Usa createServer(app) cuando necesites acceso directo al servidor subyacente para actualizaciones de WebSocket o ajuste de tiempos de espera.

Q: ¿Cómo estructuro una aplicación Express grande?

Routers por dominio (/users, /orders), servicios para lógica de negocio, app.ts y server.ts separados. Consulta Mejores prácticas de Express.

Q: ¿Express soporta ESM?

Sí. Establece "type": "module" en package.json y usa import express from "express".

10 ejemplos para construir tu primera API con Express 5: 7 básicos y 3 intermedios.

Prerrequisitos

mkdir express-api && cd express-api
npm init -y
npm pkg set type=module
npm install express@5
npm install -D typescript@5.6 tsx @types/express @types/node

Para el orden del middleware y el endurecimiento de la seguridad, consulta Orden del Middleware y Middleware de Seguridad.

Ejemplos básicos

1. Servidor "Hola Mundo"

import express from "express";
 
const app = express();
const port = 3000;
 
app.get("/", (_req, res) => {
  res.send("Hola desde Express 5\n");
});
 
app.listen(port, () => {
  console.log(`http://localhost:${port}`);
});

app es una función que envuelve http.createServer de Node
res.send() establece Content-Type automáticamente según la carga útil
Express 5 requiere Node 18+; usa Node 24 LTS en producción

2. Análisis de cuerpo JSON

import express from "express";
 
const app = express();
app.use(express.json({ limit: "1mb" }));
 
app.post("/users", (req, res) => {
  const { name, email } = req.body;
  res.status(201).json({ id: 1, name, email });
});

express.json() debe registrarse antes de las rutas que leen req.body
Establece limit para prevenir ataques de carga útil grande
Fastify incluye análisis JSON por defecto con validación de esquema

3. Parámetros de ruta

import express from "express";
 
const app = express();
 
app.get("/users/:id", (req, res) => {
  const { id } = req.params;
  res.json({ id, name: "Ada Lovelace" });
});

req.params contiene segmentos de ruta con nombre
Express 5 cambió la sintaxis de enrutamiento con comodines; consulta Migración a Express 5
Valida el formato de id en el manejador o en un middleware de validación

4. Cadenas de consulta

import express from "express";
 
const app = express();
 
app.get("/search", (req, res) => {
  const q = req.query.q as string | undefined;
  const page = Number(req.query.page ?? 1);
  res.json({ q, page, results: [] });
});

req.query se analiza automáticamente
Convierte los valores de consulta en TypeScript; llegan como cadenas o arrays
Usa una librería de validación (Zod) en el límite para APIs de producción

5. Router para rutas modulares

import express, { Router } from "express";
 
const app = express();
const usersRouter = Router();
 
usersRouter.get("/", (_req, res) => {
  res.json([{ id: 1, name: "Ada" }]);
});
 
usersRouter.get("/:id", (req, res) => {
  res.json({ id: req.params.id });
});
 
app.use("/users", usersRouter);

Router es una mini-aplicación con su propia pila de middleware
Monta routers en prefijos de ruta para organizar APIs grandes
Los módulos de NestJS cumplen un propósito de agrupación similar con DI

6. Middleware para registro de solicitudes

import express from "express";
 
const app = express();
 
app.use((req, _res, next) => {
  console.log(`${req.method} ${req.url}`);
  next();
});
 
app.get("/health", (_req, res) => {
  res.json({ status: "ok" });
});

El middleware se ejecuta en el orden de registro
Llama a next() para pasar el control al siguiente manejador
Consulta Patrón de Middleware para el patrón subyacente

7. Servir archivos estáticos

import express from "express";
import { join } from "node:path";
 
const app = express();
 
app.use("/static", express.static(join(import.meta.dirname, "public")));

express.static sirve archivos desde un directorio
Coloca el middleware estático antes de las rutas de la API o usa un prefijo de ruta dedicado
En producción, nginx o un CDN suelen servir los activos estáticos en su lugar

Ejemplos intermedios

8. Manejadores de ruta asíncronos (Express 5)

import express from "express";
 
const app = express();
 
app.get("/users/:id", async (req, res) => {
  const user = await findUser(req.params.id);
  if (!user) {
    res.status(404).json({ error: "No encontrado" });
    return;
  }
  res.json(user);
});
 
async function findUser(id: string) {
  if (id === "999") return null;
  return { id, name: "Ada" };
}

Express 5 reenvía automáticamente las promesas rechazadas al middleware de errores
Express 4 requería express-async-errors o envoltorios manuales try/catch
Siempre regresa después de enviar respuestas de error para evitar el doble envío

9. Middleware de errores

import express, { type Request, type Response, type NextFunction } from "express";
 
const app = express();
 
app.get("/fail", () => {
  throw new Error("Algo se rompió");
});
 
app.use((err: Error, _req: Request, res: Response, _next: NextFunction) => {
  console.error(err);
  res.status(500).json({ error: "Error interno del servidor" });
});

El middleware de errores tiene 4 parámetros: (err, req, res, next)
Regístralo después de todas las rutas
Nunca expongas rastros de pila a los clientes en producción

10. Configuración basada en el entorno

import express from "express";
 
const app = express();
const port = Number(process.env.PORT ?? 3000);
const isDev = process.env.NODE_ENV !== "production";
 
if (isDev) {
  app.use((req, _res, next) => {
    console.log(`[dev] ${req.method} ${req.path}`);
    next();
  });
}
 
app.get("/health", (_req, res) => {
  res.json({ env: process.env.NODE_ENV ?? "development" });
});
 
app.listen(port);

Usa PORT del entorno (Heroku, Railway, K8s lo configuran)
Protege el middleware de depuración detrás de NODE_ENV
Consulta Conceptos básicos de configuración para la validación de esquemas

Preguntas frecuentes

¿Express 5 está listo para producción?

Sí, en Node 24 LTS. Es la versión principal latest actual de npm. Migra de Express 4 usando los patrones de la guía de migración oficial en Migración a Express 5.

¿Express vs Fastify para un nuevo proyecto?

Express si la familiaridad del equipo y el tamaño del ecosistema son lo más importante. Fastify si el rendimiento y la validación de esquemas JSON son prioridades. Consulta ADR Fastify vs Express.

¿Debo usar `app.listen` o `http.createServer`?

app.listen está bien para la mayoría de las aplicaciones. Usa createServer(app) cuando necesites acceso directo al servidor subyacente para actualizaciones de WebSocket o ajuste de tiempos de espera.

¿Cómo estructuro una aplicación Express grande?

Routers por dominio (/users, /orders), servicios para lógica de negocio, app.ts y server.ts separados. Consulta Mejores prácticas de Express.

¿Express soporta ESM?

Sí. Establece "type": "module" en package.json y usa import express from "express".

Relacionado

Orden del Middleware - secuencia de registro
Manejo de errores en Express - errores asíncronos y síncronos
Middleware de seguridad - helmet, cors, límites de tasa
Conceptos básicos de Fastify - alternativa de rendimiento
Mejores prácticas de Express - lista de verificación de la sección

Versiones de la pila: Esta página fue escrita para Node.js 24.18.0 (LTS activa), npm 10+, TypeScript 5.6+, Express 5, Fastify 5 y NestJS 11.

Prerrequisitos

mkdir express-api && cd express-api
npm init -y
npm pkg set type=module
npm install express@5
npm install -D typescript@5.6 tsx @types/express @types/node

Para el orden del middleware y el endurecimiento de la seguridad, consulta Orden del Middleware y Middleware de Seguridad.

Ejemplos básicos

1. Servidor "Hola Mundo"

import express from "express";
 
const app = express();
const port = 3000;
 
app.get("/", (_req, res) => {
  res.send("Hola desde Express 5\n");
});
 
app.listen(port, () => {
  console.log(`http://localhost:${port}`);
});

app es una función que envuelve http.createServer de Node
res.send() establece Content-Type automáticamente según la carga útil
Express 5 requiere Node 18+; usa Node 24 LTS en producción

2. Análisis de cuerpo JSON

import express from "express";
 
const app = express();
app.use(express.json({ limit: "1mb" }));
 
app.post("/users", (req, res) => {
  const { name, email } = req.body;
  res.status(201).json({ id: 1, name, email });
});

express.json() debe registrarse antes de las rutas que leen req.body
Establece limit para prevenir ataques de carga útil grande
Fastify incluye análisis JSON por defecto con validación de esquema

3. Parámetros de ruta

import express from "express";
 
const app = express();
 
app.get("/users/:id", (req, res) => {
  const { id } = req.params;
  res.json({ id, name: "Ada Lovelace" });
});

req.params contiene segmentos de ruta con nombre
Express 5 cambió la sintaxis de enrutamiento con comodines; consulta Migración a Express 5
Valida el formato de id en el manejador o en un middleware de validación

4. Cadenas de consulta

import express from "express";
 
const app = express();
 
app.get("/search", (req, res) => {
  const q = req.query.q as string | undefined;
  const page = Number(req.query.page ?? 1);
  res.json({ q, page, results: [] });
});

req.query se analiza automáticamente
Convierte los valores de consulta en TypeScript; llegan como cadenas o arrays
Usa una librería de validación (Zod) en el límite para APIs de producción

5. Router para rutas modulares

import express, { Router } from "express";
 
const app = express();
const usersRouter = Router();
 
usersRouter.get("/", (_req, res) => {
  res.json([{ id: 1, name: "Ada" }]);
});
 
usersRouter.get("/:id", (req, res) => {
  res.json({ id: req.params.id });
});
 
app.use("/users", usersRouter);

Router es una mini-aplicación con su propia pila de middleware
Monta routers en prefijos de ruta para organizar APIs grandes
Los módulos de NestJS cumplen un propósito de agrupación similar con DI

6. Middleware para registro de solicitudes

import express from "express";
 
const app = express();
 
app.use((req, _res, next) => {
  console.log(`${req.method} ${req.url}`);
  next();
});
 
app.get("/health", (_req, res) => {
  res.json({ status: "ok" });
});

El middleware se ejecuta en el orden de registro
Llama a next() para pasar el control al siguiente manejador
Consulta Patrón de Middleware para el patrón subyacente

7. Servir archivos estáticos

import express from "express";
import { join } from "node:path";
 
const app = express();
 
app.use("/static", express.static(join(import.meta.dirname, "public")));

express.static sirve archivos desde un directorio
Coloca el middleware estático antes de las rutas de la API o usa un prefijo de ruta dedicado
En producción, nginx o un CDN suelen servir los activos estáticos en su lugar

Ejemplos intermedios

8. Manejadores de ruta asíncronos (Express 5)

import express from "express";
 
const app = express();
 
app.get("/users/:id", async (req, res) => {
  const user = await findUser(req.params.id);
  if (!user) {
    res.status(404).json({ error: "No encontrado" });
    return;
  }
  res.json(user);
});
 
async function findUser(id: string) {
  if (id === "999") return null;
  return { id, name: "Ada" };
}

Express 5 reenvía automáticamente las promesas rechazadas al middleware de errores
Express 4 requería express-async-errors o envoltorios manuales try/catch
Siempre regresa después de enviar respuestas de error para evitar el doble envío

9. Middleware de errores

import express, { type Request, type Response, type NextFunction } from "express";
 
const app = express();
 
app.get("/fail", () => {
  throw new Error("Algo se rompió");
});
 
app.use((err: Error, _req: Request, res: Response, _next: NextFunction) => {
  console.error(err);
  res.status(500).json({ error: "Error interno del servidor" });
});

El middleware de errores tiene 4 parámetros: (err, req, res, next)
Regístralo después de todas las rutas
Nunca expongas rastros de pila a los clientes en producción

10. Configuración basada en el entorno

import express from "express";
 
const app = express();
const port = Number(process.env.PORT ?? 3000);
const isDev = process.env.NODE_ENV !== "production";
 
if (isDev) {
  app.use((req, _res, next) => {
    console.log(`[dev] ${req.method} ${req.path}`);
    next();
  });
}
 
app.get("/health", (_req, res) => {
  res.json({ env: process.env.NODE_ENV ?? "development" });
});
 
app.listen(port);

Usa PORT del entorno (Heroku, Railway, K8s lo configuran)
Protege el middleware de depuración detrás de NODE_ENV
Consulta Conceptos básicos de configuración para la validación de esquemas

Preguntas frecuentes

¿Express 5 está listo para producción?

Sí, en Node 24 LTS. Es la versión principal latest actual de npm. Migra de Express 4 usando los patrones de la guía de migración oficial en Migración a Express 5.

¿Express vs Fastify para un nuevo proyecto?

Express si la familiaridad del equipo y el tamaño del ecosistema son lo más importante. Fastify si el rendimiento y la validación de esquemas JSON son prioridades. Consulta ADR Fastify vs Express.

¿Debo usar `app.listen` o `http.createServer`?

¿Cómo estructuro una aplicación Express grande?

Routers por dominio (/users, /orders), servicios para lógica de negocio, app.ts y server.ts separados. Consulta Mejores prácticas de Express.

¿Express soporta ESM?

Sí. Establece "type": "module" en package.json y usa import express from "express".

Relacionado

Orden del Middleware - secuencia de registro
Manejo de errores en Express - errores asíncronos y síncronos
Middleware de seguridad - helmet, cors, límites de tasa
Conceptos básicos de Fastify - alternativa de rendimiento
Mejores prácticas de Express - lista de verificación de la sección

Versiones de la pila: Esta página fue escrita para Node.js 24.18.0 (LTS activa), npm 10+, TypeScript 5.6+, Express 5, Fastify 5 y NestJS 11.

Conceptos básicos de Express

Buscar en la documentación

Conceptos básicos de Express