Kif taħdem mas-sistema ta' fajls f'Node?

Question

Accepted Answer

Il-modulu **`fs`** integrat jaqra u jikteb fajls u direttorji. Joffri tliet stili API — **promises** (modern, rikkommandat), **callbacks** (async oriġinali), u **sync** (blocking) — sabiex tista' tagħżel l-istess xieraq għas-sitwazzjoni tiegħek.

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

L-API `fs/promises` jaħdem clean ma' async/await — il-istandard modern għal file I/O.

## Varianti callback u 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!
```

**Twissija:** Metodi `*Sync` **jabloku l-event loop kollu** sakemm it-operazzjoni tispiċċa. Huma tajbin fl-istartup (taħmil ta' config darba) iżda għandhom jiġu evitati fl-handlers tat-talbiet — qari li jblokka jiffrieza l-mitluba konkurrenti kollha.

## Operazzjonijiet komuni

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

## Għal fajls kbar: uża 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"));
```

Għal fajls kbar, `readFile` taħmil kollox fil-memorja darba; **streams** jipproċessaw data f'chunks bi memorja kostanti.

## Għaliex hu importanti

File I/O hija kapaċità ewlenija ta' Node għat-taħmil ta' config, logging, uploads/downloads ta' fajls, u tooling.

Il-għarfien tat-tliet stili API — u kruċjalment, li **metodi sync jabloku l-event loop** (evita fil-servers) u li **fajls kbar għandhom bżonn streams** (mhux `readFile`) — hija essenzjali għat-tiktib ta' kodiċi li jaħdem tal-fajls li hu korrett u performant taħt konkorrenza.

L-API promise ma' async/await huwa default pulizz għal użu ta' kuljum.