Cum lucrezi cu sistemul de fișiere în Node?

Question

Accepted Answer

Modulul încorporat **`fs`** citește și scrie fișiere și directoare. Oferă trei stiluri de API — **promises** (modern, preferat), **callbacks** (async original) și **sync** (blocant) — pentru ca tu să poți alege pe cel potrivit pentru situație.

## De ce conteaza

```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-ul `fs/promises` funcționează curat cu async/await — standardul modern pentru I/O de fișiere.

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

**Atenție:** Metodele `*Sync` **blochează întreaga buclă de evenimente** până când operația se termină. Sunt în regulă la pornire (încărcând config o singură dată), dar ar trebui evitate în handleri de cereri — o citire blocantă înghață toate cererile concurente.

## Operații comune

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

## Pentru fișiere mari: folosește 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"));
```

Pentru fișiere mari, `readFile` încarcă totul în memorie deodată; **streams** procesează date în bucăți cu memorie constantă.

## De ce conteaza

I/O de fișiere este o capacitate de bază în Node pentru încărcarea configurației, logging, upload/download de fișiere și tooling.

Cunoașterea celor trei stiluri de API — și crucial, că **metodele sync blochează bucla de evenimente** (evită-le în servere) și că **fișierele mari au nevoie de streams** (nu `readFile`) — este esențială pentru scrierea codului de manipulare a fișierelor care este atât corect cât și performant sub concurență.

API-ul promise cu async/await este standardul curat pentru utilizarea zilnică.