Hoe werk je met het bestandssysteem in Node?

Question

Accepted Answer

De ingebouwde **`fs`** module leest en schrijft bestanden en mappen. Het biedt drie API-stijlen — **promises** (modern, aanbevolen), **callbacks** (originele async) en **sync** (blokkering) — zodat je de juiste kunt kiezen voor de situatie.

## The promise API (recommended)

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

De `fs/promises` API werkt schoon samen met async/await — de moderne standaard voor bestands-I/O.

## Callback- en sync-varianten

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

**Voorzichtig:** `*Sync` methodes **blokkeren de volledige event loop** totdat de bewerking klaar is. Ze zijn prima bij opstarten (config eenmaal laden), maar moeten worden vermeden in request handlers — een blokkerende read bevriест alle gelijktijdige aanvragen.

## Veelgebruikte bewerkingen

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

## Voor grote bestanden: gebruik 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"));
```

Voor grote bestanden laadt `readFile` alles in één keer in het geheugen; **streams** verwerken gegevens in chunks met constant geheugen.

## Waarom het belangrijk is

Bestands-I/O is een kernvermogen van Node voor het laden van configuraties, loggen, bestanden uploaden/downloaden en tooling.

De drie API-stijlen kennen — en cruciaal, dat **sync methodes de event loop blokkeren** (vermijd ze op servers) en dat **grote bestanden streams nodig hebben** (niet `readFile`) — is essentieel voor het schrijven van bestandsverwerkingscode die zowel correct als performant onder gelijktijdigheid is.

De promise API met async/await is de schone standaard voor dagelijks gebruik.