re:re:actable
Урок 023 минуты чтения

Модуль 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.json

path.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.

Документация

Node.js: Path, Node.js: import.meta.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам