انتقل إلى المحتوى
يوتركي تيك
كل مواضيع JavaScript

Promises & async/await

متوسط

كيف يمثّل الوعد نتيجةً لم تجهز بعد، ومتى تُنفَّذ الدوال المرتبطة به، وما الذي توقفه await فعلًا.يعتمد على Callback Hell, Event Loop

مكدّس الاستدعاءات

فارغ

    واجهات الويب (Web APIs)

    فارغ

      طابور المهام الدقيقة

      فارغ

        طابور المهام

        فارغ

          حلقة الأحداث
          1. تشغيل الكود
          2. تشغيل المهام الدقيقة
          3. أخذ المهمة التالية
          4. في الانتظار
          وحدة التحكم

          فارغ

          0/20اضغط تشغيل، أو تقدّم خطوة بخطوة بالأسهم، لتبدأ.
          الخطوة 0 من 20

          الشرح

          وقت القراءة: 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. الخطوة 1:

            يبدأ السكربت في مكدّس الاستدعاءات. عُرّفت wait وbrew لكن لم تُستدعيا بعد.

          2. الخطوة 2:

            تُطبع start.

            السطر 12

          3. الخطوة 3:

            تُستدعى brew(). الدالة async تعمل بشكل متزامن حتى أول await.

            السطر 13

          4. الخطوة 4:

            تُطبع boiling water.

            السطر 6

          5. الخطوة 5:

            تُستدعى wait(1000) وتوضع أعلى المكدّس.

            السطر 7

          6. الخطوة 6:

            تُشغّل new Promise دالتها فورًا. فتبدأ مؤقّتًا سيستدعي resolve بعد 1000 ms.

            السطر 2

          7. الخطوة 7:

            تُعيد wait وعدًا ما زال معلّقًا (pending): حاملًا لنتيجة لم تجهز بعد.

            السطر 2

          8. الخطوة 8:

            تواجه await وعدًا معلّقًا، فتتوقف brew مؤقتًا وتخرج من المكدّس. وتُعطي مَن استدعاها وعدًا معلّقًا خاصًا بها.

            السطر 7

          9. الخطوة 9:

            تسجّل .then دالة على وعد brew. لا شيء يدخل الطابور بعد: فهي لا تعمل إلا عندما يتحقّق ذلك الوعد.

            السطر 13

          10. الخطوة 10:

            تُطبع end. أوقفت await الدالة brew وحدها، لا بقية السكربت.

            السطر 14

          11. الخطوة 11:

            انتهى السكربت وفرغ المكدّس. وتنتظر الحلقة المؤقّت.

          12. الخطوة 12:

            بعد 1000 ms، تمرّ resolve عبر طابور المهام إلى المكدّس.

            السطر 2

          13. الخطوة 13:

            يؤدي استدعاء resolve إلى تحقيق وعد wait. فيدخل باقي brew، أي ما بعد await، طابور المهام الدقيقة.

            الأسطر 2–7

          14. الخطوة 14:

            المكدّس فارغ، فتعمل المهام الدقيقة: تستأنف brew من حيث توقفت تمامًا.

            السطر 8

          15. الخطوة 15:

            تُطبع coffee ready.

            السطر 8

          16. الخطوة 16:

            يؤدي return 'coffee' إلى تحقيق وعد brew بالقيمة 'coffee'، فتدخل دالة .then طابور المهام الدقيقة.

            الأسطر 9–13

          17. الخطوة 17:

            ما زالت الحلقة تُفرغ المهام الدقيقة، فتعمل دالة .then فورًا، ويأخذ drink القيمة 'coffee'.

            السطر 13

          18. الخطوة 18:

            تُطبع enjoy coffee.

            السطر 13

          19. الخطوة 19:

            تنتهي الدالة. وأصبح المكدّس والطابوران فارغين.

            السطر 13

          20. الخطوة 20:

            الناتج: start ثم boiling water ثم end ثم coffee ready ثم enjoy coffee. بلا تداخل: كل خطوة تنتظر هي سطر واحد مسطّح.