Работа с папками в Node.js

Встроенный модуль Node.js fs предоставляет множество удобных методов для работы с папками.

Проверка существования папки

Используйте fs.access() (и его аналог на основе промисов fsPromises.access()) для проверки существования папки и возможности доступа к ней Node.js с имеющимися правами доступа.

const fs = require('node:fs');

try {
  await fs.promises.access('/Users/joe');
} catch (err) {
  throw err;
}

Создание новой папки

Используйте fs.mkdir() или fs.mkdirSync() или fsPromises.mkdir() для создания новой папки.

const fs = require('node:fs');
const folderName = '/Users/joe/test';

try {
  fs.mkdirSync(folderName);
} catch (err) {
  console.error(err);
}

Чтение содержимого каталога

Используйте fs.readdir() или fs.readdirSync() или fsPromises.readdir() для чтения содержимого каталога.

Этот фрагмент кода считывает содержимое папки, включая файлы и подпапки, и возвращает их относительные пути:

const fs = require('node:fs');
const folderPath = '/Users/joe';
fs.readdirSync(folderPath).map(fileName => {
  return path.join(folderPath, fileName);
});

Вы можете получить полный путь:

fs.readdirSync(folderPath)
  .map(fileName => path.join(folderPath, fileName));

Вы также можете отфильтровать результаты, чтобы возвращались только файлы, исключая папки:

const fs = require('node:fs');
const isFile = fileName => !fileName.includes(path.sep);

fs.readdirSync(folderPath)
  .map(fileName => path.join(folderPath, fileName))
  .filter(isFile);

Переименование папки

Используйте fs.rename() или fs.renameSync() или fsPromises.rename() для переименования папки. Первый параметр — текущий путь, второй — новый путь:

const fs = require('node:fs');
fs.rename('/Users/joe', '/Users/roger', err => {
  if (err) {
    console.error(err);
  }
});

fs.renameSync() — синхронная версия:

const fs = require('node:fs');
try {
  fs.renameSync('/Users/joe', '/Users/roger');
} catch (err) {
  console.error(err);
}

fsPromises.rename() — версия на основе промисов:

const fs = require('node:fs/promises');
async function example() {
  try {
    await fs.rename('/Users/joe', '/Users/roger');
  } catch (err) {
    console.log(err);
  }
}
example();

Удаление папки

Для удаления папки используйте fs.rmdir(), fs.rmdirSync() или fsPromises.rmdir().

const fs = require('node:fs');
fs.rmdir(dir, err => {
  if (err) {
    throw err;
  }
  console.log(`${dir} is deleted!`);
});

Для удаления папки с содержимым используйте fs.rm() с опцией { recursive: true } для рекурсивного удаления содержимого.

{ recursive: true, force: true } игнорирует исключения, если папка не существует.

const fs = require('node:fs');
fs.rm(dir, { recursive: true, force: true }, err => {
  if (err) {
    throw err;
  }
  console.log(`${dir} is deleted!`);
});