На этой странице

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

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

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

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

const folderName = '/Users/joe/test';

try {
  if (!fs.existsSync(folderName)) {
    fs.mkdirSync(folderName);
  }
} catch (err) {
  console.error(err);
}
JavaScript

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

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

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

const folderPath = '/Users/joe';

fs.readdirSync(folderPath);
JavaScript

Можно получить полный путь:

fs.readdirSync(folderPath).map(fileName => {
  return path.join(folderPath, fileName);
});
JavaScript

Можно также отфильтровать результаты, чтобы вернуть только файлы и исключить папки:

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

const isFile = fileName => {
  return fs.lstatSync(fileName).isFile();
};

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

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

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

fs.rename('/Users/joe', '/Users/roger', err => {
  if (err) {
    console.error(err);
  }
  // готово
});
JavaScript

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

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

try {
  fs.renameSync('/Users/joe', '/Users/roger');
} catch (err) {
  console.error(err);
}
JavaScript

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();
JavaScript

Используйте fs.rmdir(), fs.rmdirSync() или fsPromises.rmdir(), чтобы удалить папку.

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

fs.rmdir(dir, err => {
  if (err) {
    throw err;
  }

  console.log(`${dir} is deleted!`);
});
JavaScript

Чтобы удалить папку с содержимым, используйте 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!`);
});
JavaScript