Cómo Capturar Parámetros de URL en Node.js y Express

En Express, hay varios métodos para capturar parámetros de una URL:

Parámetros de ruta (route params)
Parámetros de consulta (query params)
Parámetros de cuerpo (body params)

Configuración Inicial del Proyecto

Instalación de Dependencias

bash

# Crear un nuevo proyecto
mkdir url-params-demo
cd url-params-demo

Inicializar proyecto

bash

npm init -y

Instalar Express

bash

npm install express

Estructura Básica del Proyecto

bash

url-params-demo/
│
├── server.js
└── package.json

Tipos de Parámetros

1Parámetros de Ruta (Route Params):

Los parámetros de ruta son segmentos dinámicos en una URL que se definen utilizando el prefijo : en la ruta. Estos parámetros permiten capturar información específica de la URL, facilitando el manejo de rutas y la personalización de las respuestas en tus aplicaciones. Por ejemplo:

javascript

const express = require('express');
const app = express();

// Ejemplo básico de parámetro de ruta
app.get('/usuarios/:id', (req, res) => {
const usuarioId = req.params.id;
res.send(`Detalles del usuario con ID: ${usuarioId}`);
});

// Múltiples parámetros de ruta
app.get('/usuarios/:categoria/:id', (req, res) => {
const { categoria, id } = req.params;
res.send(`Categoría: ${categoria}, ID: ${id}`);
});

// Parámetros opcionales con expresión regular
app.get('/producto/:nombre?', (req, res) => {
const nombre = req.params.nombre || 'Producto no especificado';
res.send(`Nombre del producto: ${nombre}`);
});

2Parámetros de Consulta (Query Params):

Los parámetros de consulta se encuentran después del ? en la URL.

javascript

app.get('/buscar', (req, res) => {
// Obtener parámetros de consulta
const { termino, pagina = 1, limite = 10 } = req.query;

res.json({
  termino,
  pagina: Number(pagina),
  limite: Number(limite),
  resultados: [
    // Lógica de búsqueda aquí
  ]
});
});

// Ejemplo de URL: 
// /buscar?termino=nodejs&pagina=2&limite=20

3Parámetros de Cuerpo (Body Params):

Para capturar parámetros enviados en el cuerpo de una solicitud POST.

javascript

const express = require('express');
const bodyParser = require('body-parser');

const app = express();
app.use(express.json()); // Middleware para parsear JSON
app.use(express.urlencoded({ extended: true })); // Para datos de formulario

app.post('/usuarios', (req, res) => {
const { nombre, email, edad } = req.body;

// Validación de datos
if (!nombre || !email) {
  return res.status(400).json({ error: 'Datos incompletos' });
}

res.status(201).json({
  mensaje: 'Usuario creado',
  usuario: { nombre, email, edad }
});
});

Validación Avanzada de Parámetros

Validación con Middleware Personalizado

javascript

// Middleware de validación para ID de usuario
const validarIdUsuario = (req, res, next) => {
const { id } = req.params;

if (!/^d+$/.test(id)) {
  return res.status(400).json({ 
    error: 'ID de usuario inválido' 
  });
}

next();
};

app.get('/usuarios/:id', validarIdUsuario, (req, res) => {
const usuarioId = req.params.id;
// Lógica de recuperación de usuario
});

Validación con Bibliotecas (Joi)

javascript

const Joi = require('joi');

const esquemaUsuario = Joi.object({
nombre: Joi.string().min(3).max(30).required(),
email: Joi.string().email().required(),
edad: Joi.number().min(18).max(100)
});

app.post('/usuarios', (req, res) => {
const { error, value } = esquemaUsuario.validate(req.body);

if (error) {
  return res.status(400).json({ 
    error: error.details[0].message 
  });
}

// Procesar usuario válido
res.status(201).json(value);
});

Mejores Prácticas

Siempre valida y sanea los parámetros de entrada
Usa middleware para validaciones complejas
Proporciona valores predeterminados para parámetros opcionales
Maneja errores de manera consistente
Usa bibliotecas de validación para esquemas complejos

Ejemplo Completo de Aplicación

javascript

const express = require('express');
const app = express();
const PORT = process.env.PORT || 3000;

// Middleware
app.use(express.json());

// Base de datos simulada
const usuarios = [
{ id: 1, nombre: 'Juan', email: 'juan@example.com' },
{ id: 2, nombre: 'María', email: 'maria@example.com' }
];

// Rutas con diferentes tipos de parámetros
app.get('/usuarios', (req, res) => {
const { limite = 10, pagina = 1 } = req.query;
res.json(usuarios.slice(0, Number(limite)));
});

app.get('/usuarios/:id', (req, res) => {
const id = Number(req.params.id);
const usuario = usuarios.find(u => u.id === id);

if (!usuario) {
  return res.status(404).json({ error: 'Usuario no encontrado' });
}

res.json(usuario);
});

app.listen(PORT, () => {
console.log(`Servidor corriendo en puerto ${PORT}`);
});