Node मा फाइल सिस्टमसँग कसरी काम गर्नुहुन्छ?

Question

Accepted Answer

बिल्ट-इन **`fs`** मोड्युल फाइल र निर्देशिकाहरू पढ्छ र लेख्छ। यसले तीन API शैलीहरू प्रदान गर्छ — **promises** (आधुनिक, सिफारिस गरिएको), **callbacks** (मूल async), र **sync** (ब्लकिङ) — ताकि तपाई आफ्नो परिस्थितिको लागि सही कुरा छनौट गर्न सक्नुहुन्छ।

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

`fs/promises` API async/await सँग सफलतापूर्वक काम गर्छ — फाइल I/O को लागि आधुनिक डिफल्ट।

## Callback र 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!
```

**सावधानी:** `*Sync` विधिहरूले **सम्पूर्ण event loop अवरुद्ध गर्छन्** जबसम्म अपरेशन पूरा हुँदैन। ती स्टार्टअपमा ठीक छन् (कन्फिग एकपटक लोड गर्दै) तर अनुरोध ह्यान्डलरहरूमा बेवास्ता गर्नुपर्छ — अवरुद्ध पढाइ सबै समवर्ती अनुरोधहरूलाई स्तब्ध गर्छ।

## सामान्य सञ्चालनहरू

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

## ठूला फाइलहरूको लागि: 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"));
```

ठूला फाइलहरूको लागि, `readFile` सबै कुरा एकै पटक मेमोरीमा लोड गर्छ; **streams** स्थिर मेमोरीसँग चंकहरूमा डेटा प्रक्रिया गर्छन्।

## यो किन महत्वपूर्ण छ

फाइल I/O कन्फिग लोडिङ, लगिङ, फाइल अपलोड/डाउनलोड, र टूलिङको लागि Node को मूल क्षमता हो।

तीन API शैलीहरू जान्ने — र महत्त्वपूर्ण रूपमा, **sync विधिहरूले event loop अवरुद्ध गर्छन्** (सर्भरहरूमा बेवास्ता गर्नुहोस्) र **ठूला फाइलहरूलाई streams चाहिन्छ** (नभई `readFile`) — फाइल-ह्यान्डलिङ कोड लेख्न आवश्यक छ जो समकालिकताको अन्तर्गत सही र कार्यकारी दुवै होस्।

Promise API async/await सँग दैनिक प्रयोगको लागि स्वच्छ डिफल्ट हो।