Tema 11 · Servidor HTTP Nativo

11. Servidor HTTP Nativo con el Módulo http: Request, Response y Códigos de Estado

Construye un servidor web desde cero sin librerías externas utilizando node:http, procesando URLs, cabeceras HTTP, verbos y respuestas JSON nativas.

Creación de Servidores sin Dependencias Externas

Antes de saltar a frameworks como Express, Fastify o NestJS, todo programador de Node.js debe comprender cómo funciona la capa de red nativa mediante el módulo node:http.

El método central es http.createServer(callback), el cual se suscribe al evento de red 'request' y recibe dos objetos vitales por cada cliente entrante: req (Request) y res (Response).

El Objeto req (IncomingMessage)

Representa la solicitud del cliente y es en realidad un Readable Stream:

  • req.method: El verbo HTTP utilizado ('GET', 'POST', 'PUT', 'DELETE').
  • req.url: La ruta solicitada (ej. '/api/usuarios?activo=true').
  • req.headers: Objeto con las cabeceras HTTP en minúsculas (ej. req.headers['authorization'] o req.headers['content-type']).
  • Cuerpo de la Petición (Payload): Debido a que req es un stream, para leer un JSON enviado por POST se deben concatenar los chunks que llegan en el evento 'data' hasta el evento 'end'.

El Objeto res (ServerResponse)

Representa el canal de respuesta hacia el navegador y es un Writable Stream:

  • res.statusCode: Establece el código de estado HTTP (200 OK, 201 Created, 400 Bad Request, 404 Not Found, 500 Error).
  • res.setHeader(name, value): Define cabeceras de respuesta como Content-Type: application/json o Access-Control-Allow-Origin.
  • res.writeHead(status, headers): Envía el código y cabeceras en un solo paso.
  • res.end(data): Cierra la conexión y envía el cuerpo final. ¡Si olvidas llamar a res.end(), el navegador se quedará cargando indefinidamente hasta dar timeout!

⚡ Servidor HTTP Nativo con Enrutador Básico y Respuestas JSON

Servidor web completo en Node.js puro sin dependencias externas de npm:

native-server.js
Solo lectura
// native-server.js - Servidor HTTP Nativo con node:http
import http from 'node:http';

const PORT = 3000;

const servidor = http.createServer((req, res) => {
  const { method, url } = req;
  console.log(`[HTTP] ${method} ${url}`);

  // Cabeceras estándar para devolver JSON
  res.setHeader('Content-Type', 'application/json; charset=utf-8');

  // Enrutamiento manual básico
  if (url === '/' && method === 'GET') {
    res.statusCode = 200;
    return res.end(JSON.stringify({
      mensaje: '¡Bienvenido a la API Nativa de Kilopolis!',
      version: '1.0.0',
      timestamp: new Date().toISOString()
    }));
  }

  if (url === '/api/cursos' && method === 'GET') {
    res.statusCode = 200;
    const cursos = [
      { id: 1, titulo: 'Node.js & npm', nivel: 'Intermedio' },
      { id: 2, titulo: 'Tailwind CSS', nivel: 'Todos los niveles' }
    ];
    return res.end(JSON.stringify(cursos));
  }

  if (url === '/api/contacto' && method === 'POST') {
    let body = '';
    
    // Leemos el payload del stream entrante
    req.on('data', chunk => { body += chunk; });
    req.on('end', () => {
      try {
        const datos = JSON.parse(body);
        res.statusCode = 201;
        return res.end(JSON.stringify({ ok: true, recibido: datos }));
      } catch (err) {
        res.statusCode = 400;
        return res.end(JSON.stringify({ error: 'JSON malformado' }));
      }
    });
    return;
  }

  // Ruta 404 No Encontrada
  res.statusCode = 404;
  res.end(JSON.stringify({ error: 'Endpoint no encontrado', ruta: url }));
});

servidor.listen(PORT, () => {
  console.log(`🚀 Servidor HTTP nativo escuchando en http://localhost:${PORT}`);
});
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Qué sucede si dentro de la función de atención del servidor nativo de Node.js olvidas invocar a res.end()?
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar Node.js & npm Profesional y crear proyectos reales?

Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.