AxoloDevDiseñando hoy para el mañana
DesarrolloBlog / AxoloDev

Guía Rápida de Express para Crear un Backend con Node.js

Aprende los fundamentos de Express construyendo tu primer backend en Node.js: rutas, middlewares, CORS y Nodemon.

6 min de lectura
Guía Rápida de Express para Crear un Backend con Node.js

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.

flowchartFlujo de una solicitud en Express
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.

sh
mkdir mi-proyecto
cd mi-proyecto
npm init -y

Posteriormente, instala Express:

sh
npm install express

Crea un archivo index.js, que será el archivo principal de tu proyecto.

txt
mi-proyecto/
│
├── node_modules/
├── package.json
└── index.js

Hola Mundo con Express

Este es un ejemplo simple para iniciar un servidor con Express:

javascript
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:

sh
node index.js

En 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.

Ilustración de una computadora conectada a un servidor backend construido con Node.js y Express
Ilustración de una computadora conectada a un servidor backend construido con Node.js y Express

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:

javascript
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
javascript
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:

javascript
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.

flowchartCiclo de vida de una solicitud con middlewares
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 response

Para aplicarlos de manera global, basta con usar la función use().

javascript
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.

javascript
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.

javascript
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.

flowchartEjemplo de solicitud CORS
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 respuesta

Este 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.

sh
npm install cors
javascript
const cors = require('cors');

app.use(cors());

También puedes agregar opciones avanzadas, como los dominios, métodos y headers permitidos.

javascript
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.

sh
npm install --save-dev nodemon

Ahora puedes iniciar el servidor con el comando:

sh
npx nodemon index.js

Puedes crear un script en el archivo package.json.

json
"scripts": {
  "start": "node index.js",
  "dev": "nodemon index.js"
}

De esta manera, solo es necesario ejecutar:

sh
npm run dev

Conclusió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.

Recursos

Temas de este artículo

# Node.js# Express# Backend# JavaScript
Sigue explorando

Hay más por descubrir.

Explora más ideas, tutoriales y proyectos en el blog de AxoloDev.

Explorar el blog
Enlace copiado