انتقل إلى محتوى الدرس
الدرس 124
تاريخ النشر: تاريخ التحديث:
دورة جافا سكريبت

واجهة جلب البيانات الحديثة Fetch APIJavaScript Fetch API طريقة فحص النجاح عبر response ok، وقراءة الاستجابة json وtext، وإرسال طلبات POST والرؤوس

أتقن واجهة جلب البيانات Fetch API في JavaScript: أرسل طلبات GET وPOST بالوعود، وافحص النجاح عبر response.ok، واقرأ بيانات JSON، وألغِ الطلبات المعلقة عبر AbortController.
أقسام الدرس
5
الأمثلة
2
اللغة
العربية
المشاهدات
3,316
محتوى الدرس
في هذا الدرس 5تصفّح المواضيع

تُعد الدالة القياسية المدمجة fetch(url, options) الأداة العصرية المعتمدة لإرسال طلبات HTTP غير المتزامنة في المتصفح والبيئات الحديثة. بُنيت هذه الواجهة من الأساس على كائنات الوعود (Promises) وتدفقات البيانات، مما يجعلها تتناغم بسلاسة تامة مع صياغة async وawait.

مخطط مسار عمل Fetch API على مرحلتين وفحص response.ok قبل استدعاء response.json()

أشهر فخ برمجي في fetch(): لا يُرفض وعد fetch إلا عند انقطاع الشبكة الفعلي أو إلغاء الطلب أو حظر CORS؛ أما إذا رد الخادم بكود خطأ مثل 404 أو 500 فإن الوعد ينجح بشكل طبيعي! لذا افحص دائماً خاصية response.ok (التي تكون true للأكواد 200..299):

الحالة الشبكيةهل يُرفض وعد fetch؟قيمة response.okالإجراء البرمجي الصحيح
رد ناجح 200..299لا (يفي بكائن الاستجابة)trueالمتابعة لقراءة الجسم عبر await res.json()
خطأ خادم 404 أو 500لا! (يعتبر وصول الرد نجاحاً شبكياً)falseرمي خطأ صريح: if (!res.ok) throw ...
انقطاع اتصال أو إلغاءنعم (يُرفض الوعد فوراً)لا توجد استجابةالتقاط العطل داخل كتلة catch (err)
JavaScript
const url = 'data:application/json,' +
  encodeURIComponent('{"course":"JavaScript","lessons":159}');
async function loadCatalog() {
  const out = document.getElementById('ft-out');
  const res = await fetch(url);
  if (!res.ok) throw new Error('HTTP ' + res.status);
  const d = await res.json();
  out.textContent = d.course + ': ' + d.lessons + ' lessons';
}
loadCatalog();

لماذا يحتاج جلب البيانات إلى مرحلتي انتظار بـ await؟ يحل الانتظار الأول await fetch(url) فور وصول سطر الحالة ورؤوس الرسالة من الخادم قبل اكتمال تنزيل الجسم! بعدها تختار الدالة المناسبة لقراءة تدفق الجسم: await res.json() للبيانات المهيكلة، أو await res.text() للنصوص الصريحة.

لإرسال بيانات JSON إلى نقطة نهاية على الخادم، مرّر كائن إعدادات في المعامل الثاني للدالة fetch(url, options) يتضمن طريقة الإرسال method: "POST"، وحقل رأس الطلب headers: { "Content-Type": "application/json" }، وجسم البيانات محولاً لنص عبر body: JSON.stringify(data).

قد يظل طلب الشبكة معلقاً على الاتصالات الضعيفة طويلاً؛ لذا اربط الطلب بإشارة AbortController واستدعِ ctrl.abort() عند انتهاء المهلة أو كتابة استعلام أحدث مع فحص err.name === "AbortError" بهدوء.

تذكّر كذلك أن طلب البيانات من نطاق خارجي يخضع لسياسة مشاركة الموارد عبر الأصول (CORS) في المتصفح؛ إذ يجب أن يرسل الخادم البعيد نفسه حقل الرأس Access-Control-Allow-Origin للسماح لموقعك بقراءة الاستجابة.

JavaScript
const ctrl = new AbortController();
const out = document.getElementById('ab-out');
const blob = new Blob(['{"status":"Ready"}']);
const timer = setTimeout(() => ctrl.abort(), 2000);
fetch(URL.createObjectURL(blob), { signal: ctrl.signal })
  .then((r) => r.json())
  .then((d) => { out.textContent = 'Fetched: ' + d.status; })
  .catch((e) => { out.textContent = 'Canceled: ' + e.name; })
  .finally(() => clearTimeout(timer));
خلاصة المعرفة ومحطة الانتقال

ملخص الدرس

حصاد الدرس

مراجعة مركّزة لأهم المفاهيم والقواعد الهندسية التي أتقنتها في هذا الدرس قبل التطبيق العملي

ماذا تعلّمت في هذا الدرس؟

أتقنت في هذا الدرس جلب البيانات على مرحلتين عبر fetch()، وفحص نجاح الاستجابة عبر response.ok، وقراءة الجسم بـ res.json() وres.text()، وإرسال طلبات POST مع رؤوس الرسالة، وإلغاء الطلبات المتأخرة عبر AbortController وفهم سياسة CORS. الخطوة التالية: انتقل إلى درس «واجهة تحديد الموقع الجغرافي Geolocation API» لقراءة الإحداثيات باحترام كامل لخصوصية المستخدم.

مشاركة

هل كان هذا الدرس مفيدًا؟

جارٍ تحميل الآراء…

ابنِ لغتك البرمجية

المصطلحات3

راجع المعنى، اشرحه لنفسك، ثم علّم البطاقة كمفهومة.

0 / 3 مفهومةأول بطاقة، أول خطوة
01 fetch() دالة الجلب الشبكي الحديثة fetch
دالة قياسية مبنية على الوعود لإرسال طلبات HTTP واستقبال كائن الاستجابة بمرونة.
للمراجعة
02 response.ok خاصية فحص النجاح response.ok
خاصية منطقية تكون true حصراً عندما يقع كود حالة HTTP ضمن نطاق النجاح من 200 إلى 299.
للمراجعة
03 AbortController كائن إلغاء الطلبات AbortController
أداة قياسية تتيح تمرير إشارة signal لإلغاء طلبات الشبكة الجارية عند انتهاء المهلة أو تغير البحث.
للمراجعة

اقرأ البطاقات بحرية. سجّل الدخول لحفظ تقدم مراجعتك.

حروف قليلة. معنى كامل.

الاختصارات2

راجع المعنى، اشرحه لنفسك، ثم علّم البطاقة كمفهومة.

0 / 2 مفهومةأول بطاقة، أول خطوة
01 CORS CORS
Cross-Origin Resource Sharing
آلية أمنية تعتمد على رؤوس استجابة الخادم لتحديد النطاقات الخارجية المسموح لها بقراءة البيانات.
للمراجعة
02 REST REST
Representational State Transfer
نمط معماري شائع لواجهات الويب يتبادل موارد JSON عبر طرق HTTP القياسية.
للمراجعة

اقرأ البطاقات بحرية. سجّل الدخول لحفظ تقدم مراجعتك.

من الفهم للتطبيق

مهامك قبل الاختبار

خطوة صغيرة كل مرة. وإنجاز تقدر ترجع له.

0/2مهام منجزة
  1. افتح مثال الجلب الآمن في محرر التجربة وعدّل عدد الدروس في النص المضمن وتحقق من تحديث النتيجة.

  2. افتح مثال AbortController في محرر التجربة واستدعِ ctrl.abort() قبل الطلب للتأكد من التقاط AbortError.

تأشير المهمة إقرار منك بإتمامها، وليس تصحيحًا آليًا للكود. يُحفظ تقدمك في حسابك.

مساحة التحدي

اختبر فهمك.
ووصلها للإتقان.

كل سؤال خطوة لقدّام. اختار، اكتب كود، وشوف نتيجتك فورًا.

10أسئلة 2أنواع تحديات 100%هدف الإتقان
تصحيح تلقائي. فرص بلا حدود.

أكمل المهام، واجمع كل الإجابات الصحيحة. أقل من 100%؟ راجع وأعد المحاولة.

الأسئلة متاحة للاطلاع. سجّل الدخول للتفاعل وحفظ تقدمك.

لمحة عن التحدي10 أسئلة تنتظرك
01

عندما يرد الخادم بكود الخطأ 404 Not Found، ترفض دالة fetch() الوعد تلقائياً وتنتقل فوراً إلى كتلة catch.

02

أي خاصية يجب فحصها مباشرةً بعد await fetch(url) للتأكد من أن كود الاستجابة يقع ضمن نطاق النجاح 200-299؟

03

ماذا تُرجع الدالة response.json() عند استدعائها على كائن الاستجابة؟

04

عند إرسال كائن بصيغة JSON في طلب POST عبر fetch، كيف تضبط حقول الرأس وجسم الرسالة؟

05

أي أداة قياسية مدمجة تُستخدم لإلغاء طلب fetch() جارٍ عبر تمرير الكائن signal الخاص بها؟

06

استدعاء await response.json() مرتين متتاليتين على نفس كائن الاستجابة دون نسخه يطلق خطأ TypeError لأن التدفق قد استُهلك.

07

إذا حظر المتصفح قراءة رد خارجي بسبب سياسة CORS لغياب رأس السماح، فأين يجب ضبط الإصلاح الصحيح؟

08

أي دالة قياسية ترمّز مدخلات البحث المحتوية على مسافات أو علامة & بأمان قبل دمجها في رابط GET؟

09

ما قيمة الخاصية error.name للخطأ الناتج عند إلغاء طلب fetch عبر controller.abort()؟

10

عند تمرير كائن FormData كجسم لطلب fetch، يُترك للمتصفح ضبط رأس Content-Type تلقائياً ليحدد فاصل الحقول بدقة.