Модуль path, __dirname и import.meta.url
На этой странице
path - встроенный модуль Node.js для безопасной работы с путями к файлам и папкам. Он помогает собирать, разбирать, нормализовать и сравнивать пути без ручной склейки строк.
__dirname показывает папку текущего файла в CommonJS. В ES Modules его нет, поэтому обычно используют import.meta.url и fileURLToPath.
Вопрос
Как работать с путями в Node.js и чем __dirname отличается от import.meta.url и process.cwd()?
Зачем нужен path?
Пути отличаются в разных операционных системах:
| ОС | Разделитель |
|---|---|
| Windows | \ |
| macOS/Linux | / |
Если писать путь руками, код легко сделать хрупким:
const filePath = __dirname + '/data/users.json';Лучше использовать path.join или path.resolve.
import path from 'node:path';
const filePath = path.join(process.cwd(), 'data', 'users.json');join vs resolve
path.join собирает части пути и нормализует результат.
path.join('data', 'users', '..', 'posts.json');
// data/posts.jsonpath.resolve строит абсолютный путь, начиная от текущей рабочей директории или от переданного абсолютного пути.
path.resolve('data', 'users.json');
// C:\project\data\users.json на WindowsПолезные методы
| Метод | Что делает |
|---|---|
path.basename(file) | Имя файла |
path.dirname(file) | Папка файла |
path.extname(file) | Расширение |
path.parse(file) | Разобрать путь на части |
path.format(obj) | Собрать путь из частей |
import path from 'node:path';
const file = '/app/src/index.js';
console.log(path.basename(file)); // index.js
console.log(path.extname(file)); // .js
console.log(path.dirname(file)); // /app/src__dirname в CommonJS
В CommonJS доступны специальные переменные:
console.log(__filename); // полный путь к текущему файлу
console.log(__dirname); // папка текущего файлаОни удобны для чтения файлов рядом с текущим модулем.
const path = require('node:path');
const fs = require('node:fs');
const filePath = path.join(__dirname, 'template.html');
const html = fs.readFileSync(filePath, 'utf8');import.meta.url в ES Modules
В ESM __dirname и __filename не существуют.
import { fileURLToPath } from 'node:url';
import path from 'node:path';
const __filename = fileURLToPath(import.meta.url);
const __dirname = path.dirname(__filename);
console.log(__dirname);import.meta.url - это URL текущего модуля, например file:///C:/project/index.js, поэтому его нужно преобразовать в обычный путь.
process.cwd() vs __dirname
| Значение | Что означает |
|---|---|
process.cwd() | Папка, из которой запустили процесс |
__dirname | Папка, где лежит текущий файл |
// Запуск: node src/app.js
console.log(process.cwd()); // корень проекта
console.log(__dirname); // корень проекта/srcЧто важно помнить
path.joinсклеивает и нормализует,path.resolveвозвращает абсолютный путь.- В современных версиях Node.js в ESM доступны
import.meta.dirnameиimport.meta.filename. process.cwd()зависит от места запуска,__dirname— от расположения файла.- Пути из пользовательского ввода нормализуйте и проверяйте, чтобы избежать path traversal (
../).
Мини-шпаргалка
pathубирает ручную склейку путей.joinсобирает относительный или абсолютный путь из частей.resolveвозвращает абсолютный путь.- Для кроссплатформенного кода не полагайся на
/или\вручную. path.parseудобен, когда нужно получить имя, расширение и директорию отдельно.__dirnameесть в CommonJS.- В ESM используй
import.meta.url. fileURLToPath(import.meta.url)превращает URL модуля в путь.process.cwd()зависит от места запуска команды.- Для файлов рядом с модулем чаще нужен
__dirname, а неcwd.