Tema 7 · Módulo fs & Storage

7. Sistema de Archivos (fs): Lectura, Escritura y Métodos Asíncronos con fs/promises

Manipula archivos y carpetas de forma asíncrona y no bloqueante con async/await mediante node:fs/promises: readFile, writeFile, appendFile y unlink.

El Módulo Nativo node:fs

A diferencia de JavaScript en el navegador, Node.js tiene acceso total al sistema de archivos local a través del módulo nativo del núcleo node:fs (File System).

Consejo moderno: Prefijar los módulos nativos con node: (ej. node:fs en vez de fs) es una buena práctica oficial que mejora el rendimiento de resolución y evita colisiones accidentales con paquetes de npm.

Tres Formas de Trabajar con fs

1. Métodos Síncronos (readFileSync)

¡Bloquean por completo el hilo principal! Mientras lee un archivo de 50MB, el servidor no puede responder a ningún otro usuario. Solo se toleran en la carga inicial de archivos de configuración al arrancar.

2. Callbacks Clásicos (fs.readFile)

El enfoque original de Node con el patrón Error-First Callback (err, data) => .... Funciona bien pero produce anidamientos profundos (Callback Hell).

3. Promesas Modernas (fs/promises)

El estándar actual recomendado. Basado en Promesas nativas que se consumen limpiamente con async/await y bloques try/catch.

Operaciones Fundamentales con node:fs/promises

  • Leer archivo de texto: await fs.readFile('datos.txt', 'utf-8'); (Al pasar la codificación 'utf-8' devuelve un string; sin ella devuelve un Buffer binario).
  • Escribir / Sobrescribir: await fs.writeFile('salida.json', JSON.stringify(data, null, 2));.
  • Añadir al final (Append): await fs.appendFile('audit.log', nuevaLinea + '\n'); (Ideal para bitácoras y registros de actividad).
  • Eliminar archivo: await fs.unlink('temporal.pdf');.
  • Crear carpetas recursivas: await fs.mkdir('storage/uploads/2026', { recursive: true }); (Crea toda la jerarquía de carpetas intermedias sin fallar si ya existen).

⚡ Gestor Asíncrono de Bitácora (Logger) y Almacenamiento JSON con fs/promises

Servicio completo para leer, escribir y crear directorios de forma no bloqueante:

storage-service.js
Solo lectura
// storage-service.js - Manipulación Asíncrona Moderna con node:fs/promises
import fs from 'node:fs/promises';
import path from 'node:path';

const LOGS_DIR = path.join(process.cwd(), 'storage', 'logs');
const LOG_FILE = path.join(LOGS_DIR, 'app.log');

/**
 * Registra una línea en la bitácora creando el directorio si no existe
 */
async function registrarLog(mensaje) {
  try {
    // 1. Aseguramos que la carpeta exista de forma recursiva
    await fs.mkdir(LOGS_DIR, { recursive: true });

    // 2. Formateamos la línea con timestamp ISO
    const timestamp = new Date().toISOString();
    const linea = `[${timestamp}] INFO: ${mensaje}\n`;

    // 3. Añadimos el texto al final del archivo sin bloquear
    await fs.appendFile(LOG_FILE, linea, 'utf-8');
    console.log('✓ Log guardado con éxito');
  } catch (error) {
    console.error('Error al escribir en la bitácora:', error.message);
  }
}

/**
 * Lee y cuenta las líneas registradas en la bitácora
 */
async function leerTotalLogs() {
  try {
    const contenido = await fs.readFile(LOG_FILE, 'utf-8');
    const totalLineas = contenido.trim().split('\n').length;
    console.log(`Total de entradas registradas: ${totalLineas}`);
  } catch (error) {
    if (error.code === 'ENOENT') {
      console.log('El archivo de log aún no existe.');
    } else {
      console.error('Error al leer log:', error.message);
    }
  }
}

// Demostración
await registrarLog('Usuario ID 45 inició sesión desde Kilopolis');
await registrarLog('Petición procesada en 12ms');
await leerTotalLogs();
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Por qué se desaconseja utilizar métodos síncronos como fs.readFileSync() dentro de las rutas de un servidor web en Node.js?
🦉
¿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.