Tutorial Express: Instalación de Express

Instalación express y Hola mundo

Express 5 representa la evolución natural del framework web más utilizado en el ecosistema Node.js. Esta nueva versión introduce mejoras significativas en rendimiento, compatibilidad con promesas nativas y una API más moderna que aprovecha las características actuales de JavaScript.

Para comenzar con Express 5, necesitamos crear un proyecto Node.js desde cero y configurar las dependencias necesarias. El proceso de instalación es directo, pero requiere atención a algunos detalles específicos de esta versión.

Creación del proyecto base

Antes de instalar Express, debemos inicializar un proyecto Node.js. Crea un directorio para tu aplicación y ejecuta el comando de inicialización:

mkdir mi-app-express
cd mi-app-express
npm init -y

Este comando genera un archivo package.json con la configuración básica del proyecto. Para aprovechar las características modernas de JavaScript, modifica el archivo para incluir soporte para módulos ES6:

{
  "name": "mi-app-express",
  "version": "1.0.0",
  "type": "module",
  "main": "app.js",
  "scripts": {
    "start": "node app.js",
    "dev": "node --watch app.js"
  }
}

La propiedad "type": "module" permite usar sintaxis de importación moderna (import/export) en lugar de require(). El script dev utiliza la funcionalidad --watch de Node.js para reiniciar automáticamente la aplicación cuando detecte cambios en los archivos.

Instalación de Express 5

Express 5 se instala utilizando npm con una etiqueta específica ya que aún se encuentra en desarrollo activo:

npm install express@5

Verifica que la instalación sea correcta revisando las dependencias en package.json:

{
  "dependencies": {
    "express": "^5.0.0"
  }
}

Primera aplicación Express

Con Express instalado, podemos crear nuestra primera aplicación. Crea un archivo app.js en la raíz del proyecto:

import express from 'express';

const app = express();
const PORT = 3000;

// Ruta básica
app.get('/', (req, res) => {
  res.send('¡Hola mundo con Express 5!');
});

// Iniciar el servidor
app.listen(PORT, () => {
  console.log(`Servidor ejecutándose en http://localhost:${PORT}`);
});

Este código demuestra la estructura fundamental de una aplicación Express. La función express() crea una instancia de la aplicación, mientras que app.get() define una ruta que responde a peticiones HTTP GET.

Ejecutar la aplicación

Para poner en marcha tu aplicación Express, utiliza uno de los scripts definidos anteriormente:

npm run dev

Abre tu navegador y navega a http://localhost:3000. Deberías ver el mensaje "¡Hola mundo con Express 5!" en pantalla. El modo --watch reiniciará automáticamente el servidor cada vez que modifiques el código.

Rutas adicionales y respuestas JSON

Express 5 mantiene la compatibilidad total con la API de Express 4, pero optimiza el manejo de promesas y respuestas asíncronas. Amplía tu aplicación con rutas adicionales:

import express from 'express';

const app = express();
const PORT = 3000;

// Ruta principal
app.get('/', (req, res) => {
  res.send('¡Hola mundo con Express 5!');
});

// Ruta que devuelve JSON
app.get('/api/saludo', (req, res) => {
  res.json({
    mensaje: 'Hola desde Express 5',
    version: '5.0.0',
    timestamp: new Date().toISOString()
  });
});

// Ruta con parámetros
app.get('/usuario/:nombre', (req, res) => {
  const { nombre } = req.params;
  res.json({
    saludo: `¡Hola ${nombre}!`,
    ruta: req.path
  });
});

app.listen(PORT, () => {
  console.log(`Servidor ejecutándose en http://localhost:${PORT}`);
});

Estas rutas demuestran diferentes tipos de respuestas que Express puede manejar: texto plano con res.send(), objetos JSON con res.json(), y el acceso a parámetros de ruta mediante req.params.

Verificación de la instalación

Para confirmar que Express 5 está funcionando correctamente, puedes crear una ruta de diagnóstico que muestre información del sistema:

app.get('/info', (req, res) => {
  res.json({
    express: {
      version: '5.0.0',
      entorno: process.env.NODE_ENV || 'development'
    },
    node: {
      version: process.version,
      plataforma: process.platform
    },
    servidor: {
      puerto: PORT,
      timestamp: new Date().toISOString()
    }
  });
});

Esta ruta proporciona información útil sobre el entorno de ejecución y confirma que tanto Node.js como Express están operando con las versiones esperadas.