13. Enrutamiento Modular en Express: express.Router, Parámetros (:id) y Query Strings
Organiza proyectos escalables dividiendo rutas con express.Router(), capturando parámetros de ruta con req.params y filtros con req.query.
La Necesidad del Enrutamiento Modular
Cuando una aplicación web crece, colocar todas las rutas en un solo archivo server.js crea un "código espagueti" inmantenible de cientos de líneas.
La solución estándar en Express es express.Router(), que permite crear miniapps o módulos de rutas aislados por recurso (ej. usuarios, cursos, pagos) y montarlos en la aplicación principal con un prefijo común.
Captura de Datos: params vs query vs body
En Express, la información del cliente llega a través de tres propiedades distintas de req:
req.params (Parámetros de Ruta)
Para identificar un recurso específico por su ID o slug.
GET /api/cursos/:idEjemplo:
/api/cursos/42 ➔ req.params.id === '42'
req.query (Query Strings)
Para filtrar, ordenar, buscar y paginar listados.
GET /api/cursos?nivel=pro&limite=10➔
req.query.nivel === 'pro'
req.body (Payload JSON)
Para crear o actualizar entidades complejas en POST/PUT.
POST /api/cursos➔ Objeto parseado por
express.json()
Separación MVC: Rutas vs Controladores
Una buena práctica de arquitectura consiste en separar la definición de rutas (qué URL y verbo) de la lógica de negocio (el controlador que consulta la base de datos):
// src/routes/cursos.routes.js
import { Router } from 'express';
import { listarCursos, obtenerCursoPorId } from '../controllers/cursos.controller.js';
const router = Router();
router.get('/', listarCursos);
router.get('/:id', obtenerCursoPorId);
export default router;
⚡ Router Modular con Parámetros Dinámicos y Filtros Query
Módulo de rutas completo con express.Router(), filtros de búsqueda y validación de IDs:
// src/routes/cursos.routes.js - Router Modular en Express
import { Router } from 'express';
const router = Router();
// Base de datos simulada en memoria
const cursosDb = [
{ id: 1, slug: 'nodejs-profesional', titulo: 'Node.js & npm Profesional', nivel: 'intermedio', alumnos: 320 },
{ id: 2, slug: 'tailwind-css', titulo: 'Tailwind CSS Moderno', nivel: 'basico', alumnos: 540 },
{ id: 3, slug: 'docker-contenedores', titulo: 'Docker & Microservicios', nivel: 'avanzado', alumnos: 190 }
];
// 1. GET / - Listado con soporte para filtros por query string: ?nivel=avanzado&buscar=docker
router.get('/', (req, res) => {
const { nivel, buscar } = req.query;
let resultados = [...cursosDb];
if (nivel) {
resultados = resultados.filter(c => c.nivel.toLowerCase() === String(nivel).toLowerCase());
}
if (buscar) {
resultados = resultados.filter(c => c.titulo.toLowerCase().includes(String(buscar).toLowerCase()));
}
res.json({
total: resultados.length,
filtrosAplicados: { nivel: nivel || null, buscar: buscar || null },
datos: resultados
});
});
// 2. GET /:id - Obtención por parámetro dinámico
router.get('/:id', (req, res) => {
const cursoId = parseInt(req.params.id, 10);
if (isNaN(cursoId)) {
return res.status(400).json({ error: 'El parámetro ID debe ser un número entero válido' });
}
const curso = cursosDb.find(c => c.id === cursoId);
if (!curso) {
return res.status(404).json({ error: `Curso con ID ${cursoId} no encontrado` });
}
res.json(curso);
});
export default router;
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lecciónSi un cliente realiza una petición a "GET /api/productos/99?descuento=true", ¿cómo se accede al valor "99" y al valor "true" en Express?
¿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.