Hvordan arbejder du med filsystemet i Node?

Question

Accepted Answer

Det indbyggede **`fs`** modul læser og skriver filer og mapper. Det tilbyder tre API-stilarter — **promises** (moderne, anbefalet), **callbacks** (original async) og **sync** (blokering) — så du kan vælge den rigtige til situationen.

## Promise API (anbefalet)

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

`fs/promises` API fungerer rent med async/await — det moderne standardvalg til fil-I/O.

## Callback- og sync-varianter

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

**Advarsel:** `*Sync` metoder **blokerer hele event loop'en** indtil operationen er færdig. De er fine ved opstart (indlæser konfiguration én gang), men bør undgås i request handlers — en blokering læsning fryser alle samtidige anmodninger.

## Almindelige operationer

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

## For store filer: brug 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"));
```

For store filer indlæser `readFile` alt i hukommelsen på én gang; **streams** behandler data i chunks med konstant hukommelse.

## Hvorfor det er vigtigt

Fil-I/O er en kernefunktion i Node til konfiguration indlæsning, logging, fil-uploads/downloads og værktøjer.

At kende de tre API-stilarter — og afgørende, at **sync metoder blokerer event loop'en** (undgå dem på servere) og at **store filer har brug for streams** (ikke `readFile`) — er afgørende for at skrive filbehandlingskode, der er både korrekt og performant under concurrency.

Promise API med async/await er det rene standardvalg til daglig brug.