Sistema de archivos (módulo fs) en Node.js

Al finalizar este tema

Podrás escribir código para leer, escribir y eliminar archivos en Node.js.

Limitaciones en el navegador

JavaScript en el navegador no puede acceder a los archivos de tu computadora por motivos de seguridad. Sin embargo, al ser un entorno de servidor, Node.js permite leer y escribir archivos libremente. El módulo que proporciona esta funcionalidad es fs (File System).

// Importar el módulo fs
const fs = require("fs");

// Leer archivo (modo síncrono — se detiene hasta que se lee)
const data = fs.readFileSync("memo.txt", "utf8");
console.log(data);

require("fs") es la forma de importar los módulos integrados de Node.js. No requiere instalación adicional. Si se omite "utf8", se devuelve un búfer (datos binarios), lo que provoca que se muestren números en lugar de caracteres.

Escritura y adición de archivos

const fs = require("fs");

// Escribir en un archivo: crea si no existe, sobrescribe si existe
fs.writeFileSync("output.txt", "Primera línea\n");

// Agregar contenido al archivo (sin sobrescribir)
fs.appendFileSync("output.txt", "segunda línea\n");

// verificar
const result = fs.readFileSync("output.txt", "utf8");
console.log(result);
// primera línea
// segunda línea

writeFileSync reemplaza por completo el contenido existente. Si desea agregar contenido sin eliminar el anterior, utilice appendFileSync.

Verificar la existencia del archivo y eliminarlo.

const fs = require("fs");

// verificar si el archivo existe
if (fs.existsSync("output.txt")) {
  console.log("El archivo existe");

  // Eliminar archivo
  fs.unlinkSync("output.txt");
  console.log("Eliminación completada");
}

// Crear directorio (carpeta)
if (!fs.existsSync("logs")) {
  fs.mkdirSync("logs");
}

// Lista de archivos en el directorio
const files = fs.readdirSync(".");
console.log(files); // ["index.js", "logs", ...]

Todos los métodos que se utilizan aquí llevan el sufijo Sync (sincrónico). El código siguiente no se ejecuta hasta que se completa la operación de archivo. En los servidores reales, se utiliza la versión asíncrona (readFile, writeFile — sin sincronización), lo que se explica en Sincrónico frente a asíncrono.