ما هي Promise وما هي الحالات التي تمتلكها؟

Question

Accepted Answer

**Promise** هو كائن يمثل قيمة قد لا تكون متاحة حالياً — النتيجة النهائية لعملية غير متزامنة. لها ثلاث حالات:

- **pending** — الحالة الأولية، لم تستقر بعد.
- **fulfilled** — اكتملت بنجاح (لها قيمة).
- **rejected** — فشلت (لها سبب/خطأ).

بمجرد استقرارها (fulfilled أو rejected) فهي **immutable** — لا يمكن أن تتغير مجدداً.

```js
fetch("/api/user")
  .then(res => res.json())     // runs on fulfillment; return value flows down
  .then(user => render(user))
  .catch(err => showError(err)) // runs on ANY rejection in the chain
  .finally(() => hideSpinner()); // always runs
```

## ربط السلاسل يسطح البرمجة غير المتزامنة المتداخلة

إرجاع promise داخل `.then` ينتظر انتهاءها قبل المتابعة، لذا تتجنب callbacks المتداخلة بعمق ("callback hell"):

```js
getUser(id)
  .then(user => getPosts(user.id)) // returns a promise → chain waits for it
  .then(posts => console.log(posts));
```

## المجمعات لعدة promises

```js
Promise.all([a, b, c]);     // wait for ALL; rejects fast if any fails
Promise.allSettled([a, b]); // wait for all, get each result/error
Promise.race([a, b]);       // settles with the FIRST to settle
Promise.any([a, b]);        // first to FULFILL (ignores rejections)
```

## لماذا يهم

Promises هي أساس async JS — حلت محل تداخل callbacks، توفر معالجة أخطاء موحدة عبر `.catch`، و`async/await` هي فقط صيغة أفضل فوقها.

nسيان `.catch` (rejection غير معالج) هو خطأ شائع.