آپ Node میں فائل سسٹم کے ساتھ کیسے کام کرتے ہیں؟

Question

Accepted Answer

بیک وقت **`fs`** ماڈیول فائلوں اور ڈائریکٹریز کو پڑھتا اور لکھتا ہے۔ یہ تین API اسٹائلز فراہم کرتا ہے — **promises** (جدید، ترجیح دی گئی)، **callbacks** (اصل async) اور **sync** (مسدود کریں) — تاکہ آپ حالات کے لیے صحیح منتخب کر سکیں۔

## Promise API (تجویز کردہ)

```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** ڈیٹا کو مسلسل میموری کے ساتھ chunks میں معالجہ کرتے ہیں۔

## یہ کیوں اہم ہے

فائل I/O Node کی ترتیب لوڈنگ، لاگنگ، فائل اپ لوڈ/ڈاؤن لوڈ اور ٹولنگ کے لیے ایک بنیادی صلاحیت ہے۔

تینوں API اسٹائلز کو جاننا — اور اہم طور پر، **sync طریقے event loop کو مسدود کرتے ہیں** (سرورز میں ان سے بچیں) اور **بڑی فائلوں کو streams کی ضرورت ہے** (نہیں `readFile`) — فائل ہینڈلنگ کوڈ لکھنے کے لیے ضروری ہے جو درست اور بیک وقتیت کے تحت کارکردگی کے ساتھ ہے۔

Promise API async/await کے ساتھ روزمرہ استعمال کے لیے صاف معیار ہے۔