Hogyan dolgozhat a fájlrendszerrel a Node-ban?

Question

Accepted Answer

A beépített **`fs`** modul fájlokat és könyvtárakat olvas és ír. Három API stílust kínál — **promises** (modern, ajánlott), **callbacks** (eredeti async), és **sync** (blokkoló) — így kiválaszthatja a helyzetnek megfelelőt.

## A promise API (ajánlott)

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

Az `fs/promises` API tisztán működik az async/await-tel — a modern alapértelmezés a fájl I/O-hoz.

## Callback és sync változatok

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

**Figyelmeztetés:** A `*Sync` metódusok **blokkolják az egész eseményciklust**, amíg a művelet be nem fejeződik. Rendben vannak az indításnál (konfigurációs betöltés egyszer), de kerülni kell őket a kéréskezelőkben — egy blokkoló olvasás lefagyasztja az összes párhuzamos kérést.

## Gyakori műveletek

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

## Nagy fájlok esetén: használjon streameket

```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"));
```

Nagy fájlok esetén a `readFile` az egészet egyszerre betölti a memóriába; az **streamek** az adatokat konstans memóriával tömbökben feldolgozzák.

## Miért fontos

A fájl I/O a Node alapvető képessége a konfigurációs betöltéshez, naplózáshoz, fájlfeltöltéshez/letöltéshez és eszközökhöz.

A három API stílus ismerete — és kritikusan, hogy a **sync metódusok blokkolják az eseményciklust** (kerülje őket a szervereken) és hogy a **nagy fájloknak streamek szükségesek** (nem `readFile`) — nélkülözhetetlen a fájlkezelő kód írásához, amely párhuzamossága alatt helyes és hatékony.

A promise API az async/await-tel a tiszta alapértelmezés a mindennapi használathoz.