ما هي الأدوات التي تساعد في العمل مع الكود غير المتزامن (promisify, AbortController)؟

Question

Accepted Answer

يوفر Node عدة أدوات تجعل الكود غير المتزامن أنظف وأكثر قابلية للتحكم — تحويل واجهات برمجية قديمة قائمة على callbacks إلى Promises، إلغاء العمليات، وتنسيق عدة مهام غير متزامنة.

## promisify — تحويل واجهات برمجية callback إلى 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` يغلف أي دالة callback معيارية `(args..., (err, result) => {})` بحيث يمكنك `await` عليها — مفيد للمكتبات الأقدم التي سبقت Promises. (العديد من المكتبات المدمجة توفر الآن إصدارات Promise مباشرة، على سبيل المثال `fs/promises`.)

## AbortController — إلغاء العمليات غير المتزامنة

```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` يوفر طريقة معيارية لـ **إلغاء** العمليات الجارية (fetch, timers, streams, العديد من المكتبات) — ضروري للمهل الزمنية وتجنب العمل الضائع عندما لا تكون النتيجة مطلوبة بعد الآن.

## Promise combinators — تنسيق عدة مهام غير متزامنة

```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()]);
```

هذه الدوال الموحدة تعبر عن أنماط شائعة: `all` للتوازي والانتظار، `allSettled` عندما تحتاج كل النتائج بغض النظر عن الأخطاء، `race` للمهل الزمنية والفائز الأسرع، `any` للمصادر البديلة.

## setTimeout كـ Promise (الحديثة)

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

## لماذا يهم هذا

هذه الأدوات تجعل كود Node غير المتزامن الحقيقي أنظف وأكثر متانة: `promisify` يربط واجهات برمجية callback القديمة في async/await، `AbortController` يضيف الإلغاء والمهل الزمنية (منع العمليات المعلقة أو المهدرة)، وموحدات Promise (`all`/`allSettled`/`race`/`any`) تعبر عن أنماط التنسيق الشائعة بإيجاز وصحة.

معرفتك بها تسمح لك بالتعامل مع التوازي والإلغاء والبدائل بأناقة بدلاً من إعادة اختراعها — احتياجات شائعة في أي تطبيق غير متزامن غير تافه.