Bagaimanakah anda bekerja dengan sistem fail dalam Node?

Question

Accepted Answer

Modul **`fs`** bawaan membaca dan menulis fail serta direktori. Ia menawarkan tiga gaya API — **promises** (moden, disyorkan), **callbacks** (async asal) dan **sync** (menghalang) — jadi anda boleh memilih yang sesuai untuk situasi tersebut.

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

API `fs/promises` berfungsi dengan baik bersama async/await — standar moden untuk fail I/O.

## Varian callback dan 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!
```

**Amaran:** Kaedah `*Sync` **menghalang seluruh event loop** sehingga operasi selesai. Ia baik pada permulaan (memuatkan konfigurasi sekali) tetapi harus dielakkan dalam pengendali permintaan — bacaan yang menghalang membekukan semua permintaan serentak.

## Operasi biasa

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

## Untuk fail besar: gunakan 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"));
```

Untuk fail besar, `readFile` memuatkan semuanya ke dalam memori sekali gus; **streams** memproses data dalam ketulan dengan memori tetap.

## Mengapa ia penting

Fail I/O adalah keupayaan teras Node untuk memuatkan konfigurasi, pengelogan, muat naik/muat turun fail, dan perkakas.

Mengetahui tiga gaya API — dan yang penting, bahawa **kaedah sync menghalang event loop** (elakkan di pelayan) dan bahawa **fail besar memerlukan streams** (bukan `readFile`) — adalah penting untuk menulis kod pengendalian fail yang betul dan berprestasi di bawah keserenakan.

API janji dengan async/await adalah lalai bersih untuk penggunaan harian.