Trabajar con rutas de archivos en Node.js

Cuando trabajamos con archivos en Node.js es muy fácil cometer un error clásico: asumir que todas las rutas funcionan igual en todos los sistemas operativos.

Y no, no es así.

En esta clase vamos a ver cómo trabajar correctamente con rutas de archivos usando el módulo nativo node:path, evitando bugs y haciendo nuestro código realmente multiplataforma.

El problema con las rutas según el sistema operativo

Dependiendo de dónde se ejecute tu código, la forma de escribir una ruta cambia:

• 🐧 Linux y macOS: Usan la barra inclinada (forward slash) /. Ejemplo: carpeta/archivo.txt.
• 🪟 Windows: Usa la barra invertida (backslash) \. Ejemplo: carpeta\archivo.txt.

Si concatenas rutas manualmente usando strings, como por ejemplo:

const filePath = 'output/' + fileName

Este código:

• ✅ Funciona perfectamente en macOS y Linux.
• ❌ Puede fallar en Windows, o generar rutas inconsistentes que causen errores difíciles de depurar.

La solución: el módulo node:path

Node.js incluye un módulo nativo llamado path que se encarga de gestionar estas diferencias por ti. Al usarlo, te aseguras de que:

1. No necesitas hacer comprobaciones manuales de sistema operativo (if (os === 'windows') ...).
2. No tienes que preocuparte por si falta o sobra una barra.
3. Tu código es 100% multiplataforma.

path.join: Concatenar rutas correctamente

La función path.join permite unir diferentes segmentos de una ruta (carpetas y archivos) de forma segura.

import path from 'node:path'

const outputDir = path.join('output', 'files')
console.log(outputDir)

¿Qué hace Node.js aquí?

• Detecta el sistema operativo actual.
• Une los trozos usando / o \ según corresponda.
• Normaliza la ruta (elimina barras duplicadas, por ejemplo).

Usar join para archivos finales

También puedes usar join para crear la ruta completa a un archivo y usarla directamente en operaciones de lectura o escritura:

import path from 'node:path'
import { writeFile } from 'node:fs/promises'

const filePath = path.join('output', 'files', 'archivo.txt')

// Ahora podemos usar esa ruta con total seguridad
await writeFile(filePath, 'Contenido del archivo')

Resultado: un código más limpio, más seguro y más resiliente.

Obtener información de archivos con path

El módulo path no solo sirve para crear rutas, también tiene utilidades muy potentes para extraer información de una ruta ya existente.

path.basename: El nombre del archivo

Si tienes una ruta completa y solo quieres el nombre del archivo, usa basename:

const fullPath = '/home/user/documents/reporte.pdf'
const fileName = path.basename(fullPath)

console.log(fileName) // "reporte.pdf"

Tip: No intentes usar .split('/') para esto. Es frágil y fallará si la ruta usa el separador de Windows.

path.extname: La extensión del archivo

extname te devuelve la extensión del archivo, incluyendo el punto:

const extension = path.extname('imagen.png')
console.log(extension) // ".png"

Esto es ideal para:

• ✅ Validar si un archivo es del tipo correcto (ej: .jpg, .png).
• ✅ Procesar ficheros de forma distinta según su formato.
• ✅ Evitar errores con nombres de archivos complejos (como archivo.v1.backup.tar.gz).

Resumen de buenas prácticas

Usando path.join, basename y extname consigues:

1. 🧼 Código más limpio: Menos manipulación manual de strings.
2. 🐛 Menos errores: Node se encarga de los separadores de ruta.
3. 🌍 Compatibilidad total: Tu script funcionará igual en el servidor Linux de producción que en tu portátil Windows de desarrollo.
4. 🛠️ Mantenibilidad: Es el estándar profesional de la industria.

Conclusión: Si trabajas con archivos en Node.js, nunca concatenes rutas a mano. Usa siempre el módulo node:path.

En la siguiente clase seguiremos profundizando en cómo obtener metadatos más avanzados de los archivos, como su tamaño o fecha de creación.