Módulo path 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
Métodos comunes
1. path.join([...paths]) - Une rutas
Ejemplo
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
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', '.txt')); // file
4. path.dirname(path) - Obtiene el nombre del directorio
Ejemplo
5. path.extname(path) - Obtiene la extensión
Ejemplo
console.log(path.extname('file')); // Cadena vacía
Manejo de rutas multiplataforma
Separadores de ruta
path.sep- Separador de ruta específico de la plataformaconsole.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
Análisis de rutas y conversión de formato
path.parse(path) - Analiza la ruta en un objeto
Ejemplo
console.log(pathObj);
/*
{
root: '/',
dir: '/user/docs',
base: 'file.txt',
ext: '.txt',
name: 'file'
}
*/
path.format(pathObject) - Construye una ruta desde un objeto
Ejemplo
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
console.log(configPath);
Ejemplo 2: Procesar archivos subidos por el usuario
Ejemplo
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
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étodo | Descripción | Ejemplo |
|---|---|---|
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.sep | Proporciona el separador de ruta del sistema operativo actual (para POSIX es'/', para Windows es'\')。 | console.log(path.sep); // 输出: '\' (Windows) 或 '/' (POSIX) |
path.delimiter | Proporciona 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
// 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'
Módulos integrados de Node.js