Jak pracujete se systémem souborů v Node?

Question

Accepted Answer

Vestavěný modul **`fs`** čte a zapisuje soubory a adresáře. Nabízí tři styly API — **promises** (moderní, doporučeno), **callbacks** (původní asynchronní) a **sync** (blokující) — takže si můžete vybrat ten správný pro danou situaci.

## API pro promises (doporučeno)

```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` funguje čistě s async/await — moderní standard pro vstup/výstup souborů.

## Varianty callback a 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!
```

**Upozornění:** Metody `*Sync` **blokují celkou smyčku událostí** až do dokončení operace. Jsou v pořádku při spuštění (načítání konfigurace jednou), ale měly by se vyhýbat v obslužných programech požadavků — blokující čtení zamrazí všechny souběžné požadavky.

## Běžné operace

```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
```

## Pro velké soubory: používejte streamy

```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"));
```

U velkých souborů `readFile` načte všechno do paměti najednou; **streamy** zpracovávají data po kusech s konstantní pamětí.

## Proč je to důležité

Vstup/výstup souborů je základní schopnost Node pro načítání konfigurace, protokolování, nahrávání/stahování souborů a nástroje.

Znalost tří stylů API — a zásadně, že **sync metody blokují smyčku událostí** (vyhýbejte se jim na serverech) a že **velké soubory potřebují streamy** (ne `readFile`) — je nezbytná pro psaní kódu zpracování souborů, který je správný a výkonný při souběžnosti.

API pro promises s async/await je čistý standard pro každodenní použití.