Si punon me sistemin e skedarëve në Node?

Question

Accepted Answer

Moduli i ndërtuar **`fs`** lexon dhe shkruan skedarë dhe direktore. Ai ofron tre stile API — **promises** (modern, i preferuar), **callbacks** (async origjinal) dhe **sync** (bllokues) — kështu që mund të zgjedhësh atë të duhur për situatën.

## Pse ka rëndësi

```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-ja `fs/promises` funksionon qartë me async/await — standardi modern për I/O të skedarëve.

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

**Paralajmërim:** Metodat `*Sync` **bllokojnë të gjithë event loop** derisa operacioni të përfundojë. Ato janë në rregull në nisje (ngarkimi i konfigurimit një herë), por duhet të shmanget në manipuluesit e kërkesave — një lexim bllokues ngrysë të gjitha kërkesatat e njëkohshme.

## Operacione të zakonshme

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

## Për skedarët e mëdhenj: përdor 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"));
```

Për skedarët e mëdhenj, `readFile` ngarkon gjithçka në memorie në të njëjtën kohë; **streams** përpunojnë të dhëna në pjesë me memorie konstante.

## Pse ka rëndësi

I/O i skedarëve është një aftësi themelore në Node për ngarkimin e konfigurimit, regjistrimin, ngarkim/shkarkim të skedarëve dhe mjet.

Dija e tre stileve të API — dhe në mënyrë vendimtare, se **metodat sync bllokojnë event loop** (shmang ato në servera) dhe **skedarët e mëdhenj kanë nevojë për streams** (jo `readFile`) — është thelbësore për shkrimin e kodit të trajtimit të skedarëve që është si i saktë ashtu edhe me performancë nën njëkohshmëri.

API-ja e premtimit me async/await është standardi i qartë për përdorim të përditshëm.