Conas a oibríonn tú le córas an chomhaid i Node?

Question

Accepted Answer

Léann an modúl ionsuite **`fs`** agus scríobhann sé comhaid agus fillteáin. Cuireann sé trí stíl API ar fáil — **promises** (nua-aimseartha, níos fearr), **callbacks** (async bunaidh), agus **sync** (blocáil) — ionas gur féidir leat an ceann ceart a roghnú do an bhfíor-chás.

## An API promise (moltha)

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

Feidhmíonn an API `fs/promises` go glan le async/await — an rogha nua-aimseartha don I/O comhaid.

## Athruithe callback agus 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!
```

**Rabhadh:** Blocálaíonn modhanna **`*Sync`** **an lúp imeaglais iomlán** go dtí go gcríochnaíonn an oibríocht. Tá siad ceart ag tosú (cóiríochtáil á foluain uair amháin) ach ba chóir iad a sheachaint i láimhsitheoirí iarrataigh — blocálann léamh blocáilte gach iarratais comhthréimhsiach.

## Oibríochtaí coitianta

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

## I gcomhair comhaid mhóra: úsáid 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"));
```

I gcomhair comhaid mhóra, ualú `readFile` gach rud ina chuimhne ag an am céanna; **streams** próiseáil sonraí i gcodanna le cuimhne leanúnach.

## Cén fáth a bhíonn sé tábhachtach

Is é I/O comhaid ríomhchuimhneachán bunúsach Node do líonadh cumraíochta, logáil, uachtar/íoslódáil comhaid, agus tógáil.

Tá eolas ar na trí stíl API — agus go fíochmhar, go **blocálaíonn modhanna sync an lúp imeaglais** (seachaint orthu i bhfreastalaithe) agus go bhfuil **comhaid mhóra ag teastáil streams** (ní hé `readFile`) — riachtanach chun cód láimhsithe comhaid a scríobh atá ionann agus ceart agus feidhmíonn faoi choinbhleach.

Is é an API promise le async/await an rogha soiléir don úsáid laethúil.