Kako delaš s sistemom datotek v Node?

Question

Accepted Answer

Vgrajeni modul **`fs`** bere in piše datoteke ter direktorije. Ponuja tri sloge API — **promises** (sodoben, priporočen), **callbacks** (izvirni async) in **sync** (blokirajući) — tako da lahko izbereš pravega za situacijo.

## Zakaj je to važno

```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` deluje čisto z async/await — sodobnim standardom za datotečni I/O.

## Variante callback in 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!
```

**Opozorilo:** Metode `*Sync` **blokirajo celoten event loop** dokler se operacija ne konča. So v redu pri zagonu (nalaganje konfiguracije enkrat), vendar se jih je treba izogibati v obdelovalcih zahtevkov — blokirajoče branje zamrzne vse sočasne zahtevke.

## Pogoste 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: uporabi tokove

```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` naloži vse v pomnilnik naenkrat; **tokovi** obdelujejo podatke v košcih z konstantnim pomnilnikom.

## Zakaj je to važno

Datotečni I/O je jedilna sposobnost Node za nalaganje konfiguracije, beleženje, nalaganje/prenos datotek in orodja.

Poznanost treh slogov API — in ključno, da **metode sync blokirajo event loop** (izogni se jih na servirjih) in da **velike datoteke potrebujejo tokove** (ne `readFile`) — je bistvena za pisanje kode obdelave datotek, ki je tako pravilna kot učinkovita pod konkurenčnostjo.

API obljube z async/await je čist standard za vsakdanjo rabo.