Как вы работаете с файловой системой в Node?

Question

Accepted Answer

Встроенный модуль **`fs`** читает и записывает файлы и директории. Он предлагает три стиля API — **promises** (современный, рекомендуемый), **callbacks** (исходный асинхронный) и **sync** (блокирующий) — так что вы можете выбрать подходящий для ситуации.

## Почему это важно

```js
import { readFile, writeFile, mkdir, readdir } from "fs/promises";

async function work() {
  const data = await readFile("input.txt", "utf8");     // read (utf8 → string)
  await writeFile("output.txt", "Hello");                // write (overwrites)
  await mkdir("new-dir", { recursive: true });           // create dirs (recursive = mkdir -p)
  const files = await readdir("./");                      // list directory contents
}
```

API `fs/promises` работает чисто с async/await — современным стандартом для файлового ввода-вывода.

## Варианты callback и sync

```js
import fs from "fs";

fs.readFile("file.txt", "utf8", (err, data) => { ... }); // async callback
const data = fs.readFileSync("file.txt", "utf8");         // SYNC — blocks the event loop!
```

**Внимание:** Методы `*Sync` **блокируют весь event loop** до завершения операции. Они приемлемы при запуске (загрузка конфига один раз), но их следует избегать в обработчиках запросов — блокирующее чтение замораживает все одновременные запросы.

## Общие операции

```js
await fs.promises.appendFile("log.txt", "new line
"); // append
await fs.promises.unlink("old.txt");                    // delete a file
await fs.promises.rename("a.txt", "b.txt");             // rename/move
const stats = await fs.promises.stat("file.txt");       // metadata (size, mtime)
const exists = fs.existsSync("file.txt");               // check existence
```

## Для больших файлов: используйте streams

```js
// ❌ readFile loads the WHOLE file into memory — bad for huge files
const huge = await readFile("10gb.txt"); // could exhaust memory

// ✅ stream it in chunks (constant memory)
fs.createReadStream("10gb.txt").pipe(fs.createWriteStream("copy.txt"));
```

Для больших файлов `readFile` загружает всё в память сразу; **streams** обрабатывают данные порциями с постоянным использованием памяти.

## Почему это важно

Файловый ввод-вывод — основная возможность Node для загрузки конфигурации, логирования, загрузки/скачивания файлов и инструментов.

Знание трёх стилей API — и критически важно, что **методы sync блокируют event loop** (избегайте их на серверах) и что **большие файлы требуют streams** (не `readFile`) — необходимо для написания кода работы с файлами, который одновременно корректен и производителен при параллелизме.

API promise с async/await — чистый стандарт для повседневного использования.