Promises & async/await
متوسطكيف يمثّل الوعد نتيجةً لم تجهز بعد، ومتى تُنفَّذ الدوال المرتبطة به، وما الذي توقفه await فعلًا.يعتمد على Callback Hell, Event Loop
فارغ
فارغ
فارغ
فارغ
- تشغيل الكود
- تشغيل المهام الدقيقة
- أخذ المهمة التالية
- في الانتظار
فارغ
Spaceتشغيل أو إيقاف←→الخطوة السابقة أو التاليةRالعودة إلى البداية
الشرح
وقت القراءة: 2 د
في هذه الصفحة
ما هو الوعد (Promise) في JavaScript؟
الوعد (Promise) كائن يمثّل نتيجةً لم تجهز بعد. ويكون في واحدة من ثلاث حالات: (pending) ما زال ينتظر، أو متحقّق (fulfilled) ومعه قيمة، أو مرفوض (rejected) ومعه خطأ. وما إن يُحسم حتى لا يتغيّر أبدًا.
وasync/await صياغة مبنية فوق الوعود. الدالة async تُعيد وعدًا دائمًا، وawait توقف تلك
الدالة، وتلك الدالة وحدها، حتى يُحسم الوعد.
كيف تعمل الـ Promises و async/await؟
- تسجّل
.then(fn)الدالةfnلتعمل بالقيمة عندما يتحقّق الوعد؛ وتعمل.catch(fn)عند الرفض؛ وتعمل.finally(fn)في الحالتين. - تُعيد
.thenوعدًا جديدًا، لذا تتسلسل الخطوات بشكل مسطّح، واحدةً بعد الأخرى، بدل أن تتداخل. - تعمل دوال الوعود والكود الذي يلي
awaitكـ مهام دقيقة (microtasks): بعد الكود الحالي، وقبل المؤقّت أو الحدث التالي. - لتشغيل أعمال مستقلة في الوقت نفسه، ابدأها معًا واجمعها:
Promise.all(يجب أن تنجح كلها)، وPromise.allSettled(انتظر كل النتائج)، وPromise.race(أول ما يُحسم)، وPromise.any(أول ما ينجح).
ما الأخطاء الشائعة مع الـ Promises؟
مثال مصغّر
async function showUser(id) { try { const response = await fetch(`/api/users/${id}`); const user = await response.json(); console.log(user.name); } catch (error) { console.error('Could not load the user', error); }} const [a, b] = await Promise.all([fetch('/api/a'), fetch('/api/b')]);اختبر نفسك
داخل دالة async، ماذا توقف await؟
للمزيد من القراءة
المراجع من MDN Web Docs، باللغة الإنجليزية.
شاهد الفيديو
الشرح الكامل من قناة YouTurkey Tech على يوتيوب.
كل الخطوات كنص
- الخطوة 1:
يبدأ السكربت في مكدّس الاستدعاءات. عُرّفت
waitوbrewلكن لم تُستدعيا بعد. - الخطوة 2:
تُطبع start.
السطر 12
- الخطوة 3:
تُستدعى
brew(). الدالة async تعمل بشكل متزامن حتى أولawait.السطر 13
- الخطوة 4:
تُطبع boiling water.
السطر 6
- الخطوة 5:
تُستدعى
wait(1000)وتوضع أعلى المكدّس.السطر 7
- الخطوة 6:
تُشغّل
new Promiseدالتها فورًا. فتبدأ مؤقّتًا سيستدعيresolveبعد 1000 ms.السطر 2
- الخطوة 7:
تُعيد
waitوعدًا ما زال معلّقًا (pending): حاملًا لنتيجة لم تجهز بعد.السطر 2
- الخطوة 8:
تواجه
awaitوعدًا معلّقًا، فتتوقفbrewمؤقتًا وتخرج من المكدّس. وتُعطي مَن استدعاها وعدًا معلّقًا خاصًا بها.السطر 7
- الخطوة 9:
تسجّل
.thenدالة على وعد brew. لا شيء يدخل الطابور بعد: فهي لا تعمل إلا عندما يتحقّق ذلك الوعد.السطر 13
- الخطوة 10:
تُطبع end. أوقفت
awaitالدالةbrewوحدها، لا بقية السكربت.السطر 14
- الخطوة 11:
انتهى السكربت وفرغ المكدّس. وتنتظر الحلقة المؤقّت.
- الخطوة 12:
بعد 1000 ms، تمرّ
resolveعبر طابور المهام إلى المكدّس.السطر 2
- الخطوة 13:
يؤدي استدعاء
resolveإلى تحقيق وعدwait. فيدخل باقيbrew، أي ما بعدawait، طابور المهام الدقيقة.الأسطر 2–7
- الخطوة 14:
المكدّس فارغ، فتعمل المهام الدقيقة: تستأنف
brewمن حيث توقفت تمامًا.السطر 8
- الخطوة 15:
تُطبع coffee ready.
السطر 8
- الخطوة 16:
يؤدي
return 'coffee'إلى تحقيق وعد brew بالقيمة 'coffee'، فتدخل دالة.thenطابور المهام الدقيقة.الأسطر 9–13
- الخطوة 17:
ما زالت الحلقة تُفرغ المهام الدقيقة، فتعمل دالة
.thenفورًا، ويأخذdrinkالقيمة 'coffee'.السطر 13
- الخطوة 18:
تُطبع enjoy coffee.
السطر 13
- الخطوة 19:
تنتهي الدالة. وأصبح المكدّس والطابوران فارغين.
السطر 13
- الخطوة 20:
الناتج: start ثم boiling water ثم end ثم coffee ready ثم enjoy coffee. بلا تداخل: كل خطوة تنتظر هي سطر واحد مسطّح.