کون سی utilities async code کے ساتھ کام کرنے میں مدد دیتی ہیں (promisify، AbortController)؟

Question

Accepted Answer

Node کئی utilities فراہم کرتا ہے جو async code کو صاف اور زیادہ قابلِ کنٹرول بناتی ہیں — پرانی callback APIs کو Promises میں بدلنا، operations کو cancel کرنا، اور متعدد async tasks کو coordinate کرنا۔

## promisify — callback APIs کو Promises میں بدلیں

```js
import { promisify } from "util";
import fs from "fs";

// turn an error-first callback function into a Promise-returning one
const readFileAsync = promisify(fs.readFile);
const data = await readFileAsync("file.txt", "utf8"); // now awaitable
```

`promisify` کسی بھی معیاری `(args..., (err, result) => {})` callback function کو wrap کرتا ہے تاکہ آپ اسے `await` کر سکیں — ان پرانی libraries کے لیے مفید جو Promises سے پہلے کی ہیں۔ (بہت سے built-ins اب براہ راست promise versions پیش کرتے ہیں، مثلاً `fs/promises`۔)

## AbortController — async operations کو cancel کریں

```js
const controller = new AbortController();

// pass the signal to a cancellable operation
const promise = fetch("https://api.example.com", { signal: controller.signal });

// cancel it (e.g. on timeout or user navigation)
setTimeout(() => controller.abort(), 5000); // abort after 5s

try {
  await promise;
} catch (err) {
  if (err.name === "AbortError") console.log("request cancelled");
}
```

`AbortController` in-flight operations (fetch، timers، streams، بہت سی libraries) کو **cancel** کرنے کا ایک معیاری طریقہ فراہم کرتا ہے — timeouts کے لیے اور جب کسی result کی مزید ضرورت نہ ہو تو ضائع کام سے بچنے کے لیے ضروری۔

## Promise combinators — متعدد async tasks کو coordinate کریں

```js
// run in parallel, wait for ALL (fails fast if any rejects)
const [a, b, c] = await Promise.all([getA(), getB(), getC()]);

// wait for all, get each result OR error (never short-circuits)
const results = await Promise.allSettled([getA(), getB()]);

// the first to settle (resolve OR reject) wins
const fastest = await Promise.race([fetchPrimary(), fetchBackup()]);

// the first to FULFILL (ignores rejections until one succeeds)
const first = await Promise.any([source1(), source2()]);
```

یہ combinators عام patterns بیان کرتے ہیں: parallel-and-wait کے لیے `all`، جب آپ کو ناکامیوں سے قطع نظر ہر نتیجہ درکار ہو تو `allSettled`، timeouts/fastest-wins کے لیے `race`، fallback sources کے لیے `any`۔

## setTimeout بطور Promise (جدید)

```js
import { setTimeout as sleep } from "timers/promises";
await sleep(1000); // await a delay without wrapping in a Promise manually
```

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

یہ utilities حقیقی دنیا کے async Node code کو صاف اور زیادہ مضبوط بناتی ہیں: `promisify` legacy callback APIs کو async/await میں جوڑتا ہے، `AbortController` cancellation اور timeouts شامل کرتا ہے (hung یا ضائع operations کو روکتا ہے)، اور Promise combinators (`all`/`allSettled`/`race`/`any`) عام coordination patterns کو مختصر اور درست طریقے سے بیان کرتے ہیں۔

انہیں جاننا آپ کو parallelism، cancellation، اور fallback کو ازسرنو ایجاد کرنے کے بجائے خوبصورتی سے ہینڈل کرنے کے قابل بناتا ہے — کسی بھی غیر معمولی async application میں عام ضروریات۔