Kako radite sa datotečnim sustavom u Node-u?

Question

Accepted Answer

Ugrađeni **`fs`** modul čita i piše datoteke i direktorije. Nudi tri API stila — **promises** (moderan, preporučeno), **callbacks** (originalni async), i **sync** (blokiranje) — pa možete odabrati pravi za situaciju.

## Promise API (preporuč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` čisto funkcionira s async/await — moderni standard za I/O datoteka.

## Callback i sync varijante

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

**Oprez:** `*Sync` metode **blokiraju cijelu event petlju** dok se operacija ne završi. Dobar su izbor pri pokretanju (učitavanje konfiguracije jednom) ali trebale bi se izbjegavati u rukovateljima zahtjeva — blokiranje čitanja zaustavlja sve istodobne zahtjeve.

## Česte operacije

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

## Za velike datoteke: koristite 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"));
```

Za velike datoteke, `readFile` učitava sve u memoriju odjednom; **streams** obrađuju podatke u dijelovima s konstantnom memorijom.

## Zašto je to važno

I/O datoteka je glavna mogućnost Node-a za učitavanje konfiguracije, logiranje, preuzimanje/preuzimanje datoteka i tooling.

Znanje tri API stila — i kritično, da **sync metode blokiraju event petlju** (izbjegavajte ih na serverima) i da **velike datoteke trebaju streams** (ne `readFile`) — neophodan je za pisanje koda obrade datoteka koji je i ispravan i efikasan pod konkurentnošću.

Promise API s async/await je čist standard za svakodnevnu upotrebu.