En el dinámico mundo del desarrollo web, tener una base sólida en el backend es tan crucial como una interfaz de usuario atractiva. Node.js ha emergido como una de las tecnologías más populares y poderosas para construir servidores web de manera eficiente y escalable. Si eres un desarrollador principiante, un diseñador que quiere entender el stack completo o simplemente un curioso del mundo del backend, esta guía completa te llevará de la mano para crear tu primer servidor con Node.js desde cero.
Este artículo es una hoja de ruta práctica que te guiará a través de la configuración del entorno, la escritura del código y el uso de Express.js, el framework de Node.js más popular. Prepárate para escribir tu primer servidor en JavaScript y dar un paso de gigante en tu carrera profesional.
¿Por Qué Node.js es la Elección Ideal para Empezar?
Node.js es un entorno de ejecución de JavaScript del lado del servidor. Su principal ventaja radica en su arquitectura asíncrona y basada en eventos, lo que lo hace extremadamente rápido y eficiente para gestionar muchas conexiones simultáneas. A diferencia de otros lenguajes de servidor, Node.js utiliza un único hilo de ejecución, lo que lo hace ligero y escalable. Además, al usar JavaScript tanto en el frontend como en el backend, se simplifica el aprendizaje y se permite a los desarrolladores trabajar con un solo lenguaje en todo el stack.
Paso 1: Configuración del Entorno y Herramientas Necesarias
Antes de escribir la primera línea de código, necesitas asegurarte de tener las herramientas adecuadas instaladas en tu sistema.
1.1. Instalar Node.js y npm
La forma más sencilla de obtener Node.js es descargándolo desde su página oficial. La instalación incluye npm (Node Package Manager), que es una herramienta indispensable para gestionar las librerías y dependencias de tu proyecto. Para verificar que la instalación fue exitosa, abre tu terminal y ejecuta los siguientes comandos:
node -v
npm -v
Si ves los números de versión, ¡estás listo para el siguiente paso!
1.2. Tu Editor de Código Favorito
Aunque cualquier editor de texto funciona, recomendamos usar un editor diseñado para el desarrollo, como Visual Studio Code (VS Code). Ofrece auto-completado, debugging y una vasta colección de extensiones que harán tu vida de desarrollador mucho más fácil.
Paso 2: El Proyecto Más Sencillo del Mundo: "Hello, World!"
Ahora que tu entorno está listo, es hora de crear tu primer servidor. Vamos a empezar con un ejemplo básico para entender el concepto fundamental de un servidor.
2.1. Iniciar el Proyecto y Crear el Archivo Principal
En tu terminal, navega hasta el directorio donde quieres crear tu proyecto y ejecuta los siguientes comandos:
# Crea una carpeta para tu proyecto
mkdir mi-servidor-node
cd mi-servidor-node
# Inicializa el proyecto con npm
npm init -y
npm init -y crea un archivo package.json que contendrá la información de tu proyecto y sus dependencias.
Ahora, crea un archivo llamado app.js (o index.js, es una convención común) en la carpeta de tu proyecto.
2.2. Escribir el Código del Servidor (Sin Express.js)
En app.js, escribe el siguiente código:
const http = require(‘http’); // Importamos el módulo HTTP de Node.js
const hostname = ‘127.0.0.1’; // La dirección IP de nuestro servidor (localhost)
const port = 3000; // El puerto en el que escuchará el servidor
// Creamos una instancia del servidor
const server = http.createServer((req, res) => {
// Establecemos el código de estado y el tipo de contenido
res.statusCode = 200;
res.setHeader(‘Content-Type’, ‘text/plain’);
// Enviamos la respuesta al cliente
res.end(‘¡Hola, Mundo desde Node.js!’);
});
// El servidor empieza a escuchar en el puerto y la dirección especificados
server.listen(port, hostname, () => {
console.log(‘El servidor se está ejecutando en http://${hostname}:${port}/’);
});
2.3. Ejecutar tu Servidor
Guarda el archivo y, en tu terminal, ejecuta:
node app.js
Verás el mensaje «El servidor se está ejecutando en…» en la consola. Ahora, abre tu navegador y visita http://localhost:3000. Si todo ha ido bien, verás el texto «¡Hola, Mundo desde Node.js!». ¡Felicidades, acabas de crear tu primer servidor!
Paso 3: Simplificando con Express.js (El Framework Estándar)
El módulo HTTP nativo de Node.js es potente, pero para proyectos reales, un framework como Express.js es casi indispensable. Express simplifica la gestión de rutas, peticiones y respuestas, permitiéndote crear servidores mucho más rápido.
3.1. Instalar Express.js
Detén tu servidor (con Ctrl + C en la terminal) e instala Express ejecutando:
npm install express
Esto añadirá Express a tu package.json y creará la carpeta node_modules.
3.2. Escribir el Código con Express.js
Ahora, modifica tu archivo app.js para usar Express:
const express = require(‘express’); // Importamos Express
const app = express(); // Creamos una instancia de Express
const port = 3000;
// Definimos una ruta para la URL raíz (GET /)
app.get(‘/’, (req, res) => {
res.send(‘¡Hola, Mundo con Express.js!’);
});
// Definimos una ruta con un parámetro
app.get(‘/saludo/:nombre’, (req, res) => {
const nombre = req.params.nombre;
res.send(‘Hola, ${nombre}. ¡Bienvenido a Proyectos Apasionantes!’);
});
// El servidor empieza a escuchar en el puerto
app.listen(port, () => {
console.log(‘Servidor Express escuchando en http://localhost:${port}‘);
});
3.3. Ejecutar tu Servidor Express
Ejecuta de nuevo el comando:
node app.js
Abre tu navegador y prueba las siguientes URLs:
-
http://localhost:3000 -
http://localhost:3000/saludo/Ana
Verás cómo Express gestiona las rutas de forma mucho más limpia y sencilla.
Paso 4: Creando una API REST BÁSICA
La mayoría de los servidores no solo envían texto, sino que sirven como una API (Application Programming Interface) para que otras aplicaciones se comuniquen con ellos. Vamos a extender nuestro servidor para crear una API que gestione una lista de tareas.
4.1. Añadir el Middleware de JSON
Para que nuestro servidor pueda procesar datos JSON enviados por los clientes, necesitamos un middleware. Express lo incluye por defecto:
// …
const app = express();
const port = 3000;
// Middleware para parsear JSON
app.use(express.json());
// Array simple para simular una base de datos de tareas
let tareas = [
{ id: 1, titulo: ‘Aprender Node.js’, completada: false },
{ id: 2, titulo: ‘Crear un servidor’, completada: true }
];
// …
4.2. Definir las Rutas de la API
Ahora, añadimos las rutas para las operaciones CRUD (Crear, Leer, Actualizar, Borrar) de nuestra API:
// GET /api/tareas: Obtiene todas las tareas
app.get(‘/api/tareas’, (req, res) => {
res.json(tareas);
});
// GET /api/tareas/:id: Obtiene una tarea por su ID
app.get(‘/api/tareas/:id’, (req, res) => {
const tarea = tareas.find(t => t.id === parseInt(req.params.id));
if (!tarea) {
return res.status(404).send(‘Tarea no encontrada.’);
}
res.json(tarea);
});
// POST /api/tareas: Crea una nueva tarea
app.post(‘/api/tareas’, (req, res) => {
const nuevaTarea = {
id: tareas.length + 1,
titulo: req.body.titulo,
completada: false
};
tareas.push(nuevaTarea);
res.status(201).json(nuevaTarea);
});
// PUT /api/tareas/:id: Actualiza una tarea
app.put(‘/api/tareas/:id’, (req, res) => {
const tarea = tareas.find(t => t.id === parseInt(req.params.id));
if (!tarea) {
return res.status(404).send(‘Tarea no encontrada.’);
}
tarea.titulo = req.body.titulo || tarea.titulo;
tarea.completada = req.body.completada !== undefined ? req.body.completada : tarea.completada;
res.json(tarea);
});
// DELETE /api/tareas/:id: Borra una tarea
app.delete(‘/api/tareas/:id’, (req, res) => {
const tarea = tareas.find(t => t.id === parseInt(req.params.id));
if (!tarea) {
return res.status(404).send(‘Tarea no encontrada.’);
}
tareas = tareas.filter(t => t.id !== parseInt(req.params.id));
res.status(204).send(); // 204 No Content
});
// …
Con estas rutas, tu servidor ya es una API funcional que puedes probar con herramientas como Postman o directamente desde tu navegador (para las peticiones GET).
Conclusión: Tu Viaje en el Backend acaba de Empezar
Has aprendido a configurar un entorno de Node.js, a crear un servidor básico con el módulo HTTP y, lo más importante, a construir una API REST completa con Express.js. Este es un conocimiento fundamental que te abrirá las puertas al mundo del desarrollo backend.
El siguiente paso es profundizar en temas como la gestión de bases de datos (con MongoDB o PostgreSQL), la autenticación de usuarios y la seguridad, que son pilares esenciales para cualquier proyecto web. En Proyectos Apasionantes, estamos listos para acompañarte en este emocionante viaje, ofreciéndote no solo guías prácticas, sino también servicios de desarrollo web a medida para hacer realidad tus proyectos más ambiciosos.
