Módulo path de Node.js

Java FileMódulos integrados de Node.js


de Node.jspathel módulo es un módulo central integrado, diseñado específicamente para manejar rutas de archivos y directorios.

path ofrece una serie de métodos prácticos que te permiten operar con rutas de archivos de manera segura y eficiente en diferentes sistemas operativos.

¿Por qué necesitamos el módulo path?

Diferentes sistemas operativos usan diferentes separadores de ruta:

  • Windows usa barras invertidas\
  • Unix/Linux/macOS usan barras diagonales/

pathEl módulo maneja automáticamente estas diferencias, permitiendo que tu código funcione correctamente en diferentes plataformas.


Uso básico del módulo path

Importar el módulo path

const path = require('path');

Métodos comunes

1. path.join([...paths]) - Une rutas

Ejemplo

const fullPath = path.join('/user', 'documents', 'file.txt');
console.log(fullPath);
// En Unix se imprime: /user/documents/file.txt
// En Windows se imprime: \user\documents\file.txt

2. path.resolve([...paths]) - Resuelve una ruta absoluta

Ejemplo

const absolutePath = path.resolve('src', 'app.js');
console.log(absolutePath);
// Imprime la ruta absoluta del directorio de trabajo actual, por ejemplo: /home/user/project/src/app.js

3. path.basename(path[, ext]) - Obtiene el nombre del archivo

Ejemplo

console.log(path.basename('/user/docs/file.txt')); // file.txt
console.log(path.basename('/user/docs/file.txt', '.txt')); // file

4. path.dirname(path) - Obtiene el nombre del directorio

Ejemplo

console.log(path.dirname('/user/docs/file.txt')); // /user/docs

5. path.extname(path) - Obtiene la extensión

Ejemplo

console.log(path.extname('index.html')); // .html
console.log(path.extname('file')); // Cadena vacía

Manejo de rutas multiplataforma

Separadores de ruta

  • path.sep- Separador de ruta específico de la plataforma

    console.log(path.sep); // Windows 输出 '\', Unix 输出 '/'
  • path.delimiter- Separador de ruta específico de la plataforma (para la variable de entorno PATH)

    console.log(path.delimiter); // Windows 输出 ';', Unix 输出 ':'

Normalización de rutas

Usandopath.normalize(path)se puede normalizar la ruta, manejando los redundantes.、..y separadores:

Ejemplo

console.log(path.normalize('/user//docs/../file.txt')); // /user/file.txt

Análisis de rutas y conversión de formato

path.parse(path) - Analiza la ruta en un objeto

Ejemplo

const pathObj = path.parse('/user/docs/file.txt');
console.log(pathObj);
/*
{
  root: '/',
  dir: '/user/docs',
  base: 'file.txt',
  ext: '.txt',
  name: 'file'
}
*/

path.format(pathObject) - Construye una ruta desde un objeto

Ejemplo

const pathStr = path.format({
  dir: '/user/docs',
  name: 'file',
  ext: '.txt'
});
console.log(pathStr); // /user/docs/file.txt

Ejemplos de aplicación práctica

Ejemplo 1: Construir rutas de archivo multiplataforma

Ejemplo

const configPath = path.join(__dirname, 'config', 'settings.json');
console.log(configPath);

Ejemplo 2: Procesar archivos subidos por el usuario

Ejemplo

function saveUploadedFile(uploadDir, originalName) {
  const ext = path.extname(originalName);
  const baseName = path.basename(originalName, ext);
  const timestamp = Date.now();
  const newFileName = `${baseName}_${timestamp}${ext}`;
 
  return path.join(uploadDir, newFileName);
}

Ejemplo 3: Comprobar la extensión del archivo

Ejemplo

function isImageFile(filename) {
  const ext = path.extname(filename).toLowerCase();
  return ['.jpg', '.jpeg', '.png', '.gif'].includes(ext);
}

Métodos y propiedades

Los métodos y propiedades del módulo path son los siguientes:

MétodoDescripciónEjemplo
path.basename(path[, ext])Devuelve la última parte de la ruta (nombre de archivo). Parámetro opcionalextSe utiliza para eliminar la extensión del archivo.path.basename('/foo/bar/baz.txt'); // 输出: 'baz.txt'
path.dirname(path)Devuelve la parte del directorio de la ruta.path.dirname('/foo/bar/baz.txt'); // 输出: '/foo/bar'
path.extname(path)Devuelve la extensión del archivo en la ruta.path.extname('/foo/bar/baz.txt'); // 输出: '.txt'
path.join([...paths])Une múltiples rutas en una sola, manejando automáticamente los separadores de ruta.path.join('/foo', 'bar', 'baz/asdf', 'quux', '..'); // 输出: '/foo/bar/baz/asdf'
path.resolve([...paths])Resuelve una secuencia de rutas en una ruta absoluta, procesando cada segmento de ruta de derecha a izquierda hasta construir una ruta absoluta.path.resolve('/foo/bar', './baz'); // 输出: '/foo/bar/baz'
path.normalize(path)Normaliza la ruta, eliminando los redundantes.y.., y reemplaza los separadores de ruta según el sistema operativo actual.path.normalize('/foo/bar//baz/asdf/quux/..'); // 输出: '/foo/bar/baz/asdf'
path.isAbsolute(path)Comprueba si la ruta es absoluta.path.isAbsolute('/foo/bar'); // 输出: true
path.relative(from, to)Devuelve desdefromla ruta hastatola ruta relativa.path.relative('/foo/bar/baz', '/foo/bar/qux'); // 输出: '../qux'
path.parse(path)Analiza una cadena de ruta en un objeto, que contieneroot、dir、base、extynamepropiedades.path.parse('/home/user/dir/file.txt');Salida:{ root: '/', dir: '/home/user/dir', base: 'file.txt', ...}
path.format(pathObject)Formatea un objeto de ruta como una cadena de ruta, al contrario quepath.parsela operación contraria.path.format({ root: '/', dir: '/home/user/dir', base: 'file.txt' }); // 输出: '/home/user/dir/file.txt'
path.sepProporciona el separador de ruta del sistema operativo actual (para POSIX es'/', para Windows es'\')。console.log(path.sep); // 输出: '\' (Windows) 或 '/' (POSIX)
path.delimiterProporciona el separador de rutas (el separador de rutas en variables de entorno), para POSIX es:, para Windows es;。console.log(path.delimiter); // 输出: ';' (Windows) 或 ':' (POSIX)

Ejemplo

Crea un archivo main.js, con el siguiente código:

Ejemplo

const path = require('path');

// Obtener el nombre del archivo
console.log('Nombre del archivo:', path.basename('/foo/bar/baz.txt')); // Salida: 'baz.txt'

// Obtener el nombre del directorio
console.log('Nombre del directorio:', path.dirname('/foo/bar/baz.txt')); // Salida: '/foo/bar'

// Obtener la extensión
console.log('Extensión:', path.extname('/foo/bar/baz.txt')); // Salida: '.txt'

// Unir rutas
console.log('Ruta unida:', path.join('/foo', 'bar', 'baz/asdf', 'quux', '..')); // Salida: '/foo/bar/baz/asdf'

// Resolver ruta absoluta
console.log('Ruta absoluta:', path.resolve('/foo/bar', './baz')); // Salida: '/foo/bar/baz'

// Normalizar ruta
console.log('Ruta normalizada:', path.normalize('/foo/bar//baz/asdf/quux/..')); // Salida: '/foo/bar/baz/asdf'

// Comprobar si es una ruta absoluta
console.log('¿Es una ruta absoluta?:', path.isAbsolute('/foo/bar')); // Salida: true

// Ruta relativa
console.log('Ruta relativa:', path.relative('/foo/bar/baz', '/foo/bar/qux')); // Salida: '../qux'

// Analizar la ruta como objeto
const parsedPath = path.parse('/home/user/dir/file.txt');
console.log('Analizar ruta como objeto:', parsedPath);
// Salida: { root: '/', dir: '/home/user/dir', base: 'file.txt', ext: '.txt', name: 'file' }

// Formatear el objeto como ruta
const formattedPath = path.format(parsedPath);
console.log('Ruta formateada:', formattedPath); // Salida: '/home/user/dir/file.txt'

Java FileMódulos integrados de Node.js

Otras extensiones