Express es uno de los frameworks más utilizados para desarrollar aplicaciones backend con Node.js. Gracias a su diseño minimalista, permite crear servidores web y APIs REST de forma sencilla, manteniendo la flexibilidad suficiente para proyectos pequeños o aplicaciones de gran escala.
En este artículo construiremos un servidor básico mientras repasamos los conceptos más importantes de Express. Al finalizar, tendrás una base sólida para comenzar a desarrollar tus propias APIs.
flowchart LR
A["Cliente"] -->|"Solicitud HTTP"| B["Express"]
B --> C["Middlewares"]
C --> D["Ruta / Controlador"]
D --> E["Respuesta HTTP"]
E --> F["Cliente recibe datos"]
classDef primary fill:#020617,stroke:#00A896,color:#ffffff,stroke-width:2px
classDef secondary fill:#0f172a,stroke:#64748b,color:#ffffff
class B,C,D primary
class A,E,F secondary¿Por qué usar Express?
Express ofrece una estructura clara para gestionar rutas, solicitudes HTTP y middlewares, permitiendo que los desarrolladores se enfoquen en la lógica de la aplicación. Al trabajar junto con Node.js, es posible crear aplicaciones full-stack utilizando el mismo lenguaje: JavaScript. Esto no solo acelera el desarrollo, sino que también facilita la curva de aprendizaje para quienes ya tienen experiencia en el frontend.
Instalación
Asegúrate de tener instalado Node.js (versión LTS recomendada) junto con NPM.
Para comenzar con el desarrollo del servidor, crearemos una carpeta para el proyecto e iniciaremos NPM.
mkdir mi-proyecto
cd mi-proyecto
npm init -yPosteriormente, instala Express:
npm install expressCrea un archivo index.js, que será el archivo principal de tu proyecto.
mi-proyecto/
│
├── node_modules/
├── package.json
└── index.jsHola Mundo con Express
Este es un ejemplo simple para iniciar un servidor con Express:
const express = require('express');
const app = express();
app.get('/', (req, res) => {
res.send('¡Hola Mundo desde Express!');
});
app.listen(3000, () => {
console.log('Servidor escuchando en http://localhost:3000');
});Corre el servidor que acabamos de crear con:
node index.jsEn el ejemplo anterior, básicamente se importa Express y se crea una instancia del mismo. Posteriormente, se registra una ruta con el método get, cuya función es enviar el texto “¡Hola Mundo desde Express!”. La última sentencia indica que el servidor estará atento a las solicitudes en el puerto 3000.

Rutas en Express
En Express, las rutas definen cómo la aplicación responde a las solicitudes HTTP en URLs específicas. Puedes crear una ruta con la siguiente sintaxis:
app.METODO('/ruta', (req, res) => {
// Lógica de la ruta
});Express acepta distintos métodos HTTP, como:
- GET: Recuperar datos.
- POST: Crear nuevos datos.
- PUT: Actualizar datos existentes.
- DELETE: Eliminar datos.
Además de un método especial, all(), que recibe todos los métodos HTTP, puedes determinar a qué método pertenece una solicitud con el objeto req.method.
El objeto req contiene toda la información de la solicitud, como los headers, el body, las queries o los parámetros de ruta. Estos pueden consultarse con los objetos req.headers, req.body, req.query y req.params, respectivamente. Ten en cuenta que req.body requiere un middleware adecuado para procesar el cuerpo de la solicitud. Consulta la documentación oficial de Express para mayor información.
Puedes crear un parámetro de ruta únicamente agregando dos puntos (:) seguidos del parámetro.
| Objeto | Descripción |
|---|---|
req.params |
Parámetros de la URL |
req.query |
Parámetros de consulta |
req.body |
Cuerpo de la petición |
req.headers |
Encabezados HTTP |
app.METODO('/RUTA/:PARAMETRO', FUNCION1);El objeto res contiene todo lo necesario para enviar una respuesta del servidor. Consulta la documentación oficial de Express para mayor información.
Ejemplo de una API REST simple:
app.get('/usuarios', (req, res) => {
res.status(200).send('Lista de usuarios');
});
app.post('/usuarios', (req, res) => {
res.status(201).send('Usuario creado');
});
app.put('/usuarios/:id', (req, res) => {
res.status(200).send(`Usuario ${req.params.id} actualizado`);
});
app.delete('/usuarios/:id', (req, res) => {
res.status(200).send(`Usuario ${req.params.id} eliminado`);
});Middlewares
Los middlewares son funciones que se ejecutan durante el ciclo de vida de una solicitud, permitiendo modificar la información de la solicitud (req) y la respuesta (res), o ejecutar lógica antes de que las rutas gestionen la solicitud. Estos se pueden aplicar a rutas específicas, a enrutadores o de manera global.
flowchart TD
A["Solicitud HTTP"] --> B["Middleware global"]
B -->|"next()"| C["Middleware de ruta"]
C -->|"next()"| D["Controlador"]
D --> E["Respuesta HTTP"]
B -.->|"Respuesta anticipada"| E
C -.->|"Respuesta anticipada"| E
classDef primary fill:#020617,stroke:#00A896,color:#ffffff,stroke-width:2px
classDef secondary fill:#0f172a,stroke:#64748b,color:#ffffff
classDef response fill:#065f46,stroke:#00A896,color:#ffffff
class B,C,D primary
class A secondary
class E responsePara aplicarlos de manera global, basta con usar la función use().
app.use((req, res, next) => {
// Lógica del middleware
next();
});Para agregarlos a una ruta, solo basta con enlistarlos previamente a la función principal de la ruta.
app.METODO('/ruta', FUNCION1, FUNCION2);El argumento next es una función que indica que la lógica de la petición continúa en la siguiente función de la lista de funciones de la ruta.
Para procesar información en formato JSON, se puede ocupar el middleware express.json(), que interpreta los cuerpos de las solicitudes con el encabezado Content-Type: application/json y deja el contenido procesado disponible en req.body.
app.use(express.json());Manejo de CORS
CORS (Cross-Origin Resource Sharing) es un mecanismo que controla cómo los recursos de un servidor pueden ser accedidos desde orígenes diferentes al propio. Por motivos de seguridad, los navegadores restringen el acceso a respuestas entre orígenes distintos mediante la política del mismo origen, salvo que el servidor lo permita mediante los encabezados CORS adecuados.
sequenceDiagram
participant N as Navegador
participant E as API Express
Note over N,E: Ejemplo de solicitud que requiere preflight
N->>E: OPTIONS /usuarios
E-->>N: Origen, métodos y headers permitidos
Note over N: Verifica los permisos CORS
N->>E: POST /usuarios (JSON)
E-->>N: 201 Created + headers CORS
Note over N: JavaScript puede acceder a la respuestaEste ejemplo muestra una solicitud que requiere una comprobación previa (preflight). No todas las solicitudes CORS necesitan una petición OPTIONS antes de la solicitud principal.
npm install corsconst cors = require('cors');
app.use(cors());También puedes agregar opciones avanzadas, como los dominios, métodos y headers permitidos.
app.use(cors({
origin: 'http://mi-dominio.com',
methods: ['GET', 'POST'],
allowedHeaders: ['Content-Type', 'Authorization']
}));Uso de Nodemon para el Desarrollo
Nodemon reinicia automáticamente tu servidor cada vez que guardas cambios en el código, ahorrándote tiempo durante el desarrollo.
Para usarlo, es necesario instalar el paquete nodemon como dependencia de desarrollo.
npm install --save-dev nodemonAhora puedes iniciar el servidor con el comando:
npx nodemon index.jsPuedes crear un script en el archivo package.json.
"scripts": {
"start": "node index.js",
"dev": "nodemon index.js"
}De esta manera, solo es necesario ejecutar:
npm run devConclusión
A lo largo de este artículo construimos un servidor básico utilizando Express y revisamos algunos de sus conceptos fundamentales: rutas, middlewares, CORS y herramientas para desarrollo, como Nodemon.
A partir de esta base, ya puedes comenzar a desarrollar APIs REST más completas, integrar bases de datos o implementar sistemas de autenticación.
