CRUD de archivos con Node.js fs

Aprende a dominar el módulo de fs en Node.js para crear, leer, actualizar y eliminar archivos de forma segura. Verás cómo estructurar un CRUD paso a paso en un script fs.js, ejecutar desde la terminal y detectar errores comunes en console.log.

¿Cómo usar fs para un CRUD de archivos en Node.js?

El módulo fs (file system) es nativo de Node.js y permite interactuar con el sistema de archivos. Con él implementas un CRUD completo: crear archivos, leer su contenido, actualizarlos agregando nuevas líneas y eliminarlos cuando ya no se necesiten.

• Importa el módulo nativo con require.
• Define un nombre de archivo estable, por ejemplo example.txt.
• Estructura cada acción del CRUD con funciones síncronas para simplificar el flujo.

Código base:

const fs = require('fs');
const filename = 'example.txt';

¿Qué código necesitas para crear, leer y actualizar?

A continuación, los fragmentos esenciales y mensajes de estado con console.log para verificar cada paso. Usa codificación UTF-8 al leer.

¿Cómo crear un archivo con writeFileSync?

Crea el archivo si no existe y escribe contenido inicial. Muestra confirmación al terminar.

fs.writeFileSync(filename, 'hola, este es un archivo de ejemplo');
console.log('archivo creado correctamente');

• Idea clave: si el archivo no existe, se crea.
• Mensaje útil: confirma el estado de la operación.

¿Cómo leer un archivo con readFileSync y UTF-8?

Lee el archivo y presenta su contenido en consola. Asegura pasar la codificación.

const content = fs.readFileSync(filename, 'utf-8');
console.log('file content:', content);

• Evita errores de sintaxis: si omites la coma entre el primer string y la variable en console.log, verás un aviso de “falta un argumento”.
• Idea clave: especificar 'utf-8' evita recibir un buffer.

¿Cómo actualizar con appendFileSync y saltos de línea?

Agrega texto al final y cuida la organización con saltos de línea.

fs.appendFileSync(filename, '\nesta es una nueva línea.\n');
console.log('archivo actualizado correctamente');

• Usa "\n" para separar líneas y mantener legible el archivo.
• Idea clave: append no reemplaza, suma contenido.

¿Qué errores y flujo de ejecución debes considerar?

Cuando un mismo script contiene todas las fases del CRUD, cada ejecución repite el flujo: crear, leer, actualizar y, si lo incluyes, eliminar. Por eso el estado del archivo parecerá “reiniciarse” al inicio y luego volver a cambiar con las operaciones siguientes. Ejecuta desde la terminal integrada de Visual Studio Code para observar el orden de los mensajes.

Comando de ejecución:

node fs.js

Eliminación del archivo con unlinkSync y confirmación del estado:

fs.unlinkSync(filename);
console.log('archivo eliminado correctamente');

• Idea clave: el flujo secuencial importa. Si creas y luego actualizas en el mismo run, verás el contenido inicial y después la nueva línea agregada.
• Validación continua: usa console.log para saber en qué paso estás y qué dato llega.
• Organización: separa lógicas en funciones si luego quieres ejecutar solo una fase del CRUD.

Conceptos y palabras clave integrados en el flujo:

• fs (file system): módulo nativo para operar archivos.
• CRUD: crear, leer, actualizar, eliminar archivos y carpetas.
• writeFileSync, readFileSync, appendFileSync, unlinkSync: funciones síncronas para un control directo del orden de ejecución.
• UTF-8: codificación estándar al leer con readFileSync.
• console.log: visor de estado y errores de sintaxis si faltan argumentos.
• Terminal de Visual Studio Code: ejecución rápida con node fs.js.

¿Quieres que armemos una versión que guarde transcripciones de audio y las organice por fecha y carpeta? Cuéntame en comentarios qué estructura te gustaría y lo construimos paso a paso.