في هذا الدرس 5تصفّح المواضيع
تُعد الدالة القياسية المدمجة fetch(url, options) الأداة العصرية المعتمدة لإرسال طلبات HTTP غير المتزامنة في المتصفح والبيئات الحديثة. بُنيت هذه الواجهة من الأساس على كائنات الوعود (Promises) وتدفقات البيانات، مما يجعلها تتناغم بسلاسة تامة مع صياغة async وawait.
أشهر فخ برمجي في 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) |
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 للسماح لموقعك بقراءة الاستجابة.
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
راجع المعنى، اشرحه لنفسك، ثم علّم البطاقة كمفهومة.
- 01 fetch() دالة الجلب الشبكي الحديثة fetch
- دالة قياسية مبنية على الوعود لإرسال طلبات HTTP واستقبال كائن الاستجابة بمرونة.
- للمراجعة
- 02 response.ok خاصية فحص النجاح response.ok
- خاصية منطقية تكون true حصراً عندما يقع كود حالة HTTP ضمن نطاق النجاح من 200 إلى 299.
- للمراجعة
- 03 AbortController كائن إلغاء الطلبات AbortController
- أداة قياسية تتيح تمرير إشارة signal لإلغاء طلبات الشبكة الجارية عند انتهاء المهلة أو تغير البحث.
- للمراجعة
لا توجد بطاقات تطابق البحث والتصفية.
اقرأ البطاقات بحرية. سجّل الدخول لحفظ تقدم مراجعتك.
الاختصارات2
راجع المعنى، اشرحه لنفسك، ثم علّم البطاقة كمفهومة.
- 01 CORS CORS
- Cross-Origin Resource Sharing
- آلية أمنية تعتمد على رؤوس استجابة الخادم لتحديد النطاقات الخارجية المسموح لها بقراءة البيانات.
- للمراجعة
- 02 REST REST
- Representational State Transfer
- نمط معماري شائع لواجهات الويب يتبادل موارد JSON عبر طرق HTTP القياسية.
- للمراجعة
لا توجد بطاقات تطابق البحث والتصفية.
اقرأ البطاقات بحرية. سجّل الدخول لحفظ تقدم مراجعتك.
مهامك قبل الاختبار
خطوة صغيرة كل مرة. وإنجاز تقدر ترجع له.
-
افتح مثال الجلب الآمن في محرر التجربة وعدّل عدد الدروس في النص المضمن وتحقق من تحديث النتيجة.
-
افتح مثال AbortController في محرر التجربة واستدعِ ctrl.abort() قبل الطلب للتأكد من التقاط AbortError.
تأشير المهمة إقرار منك بإتمامها، وليس تصحيحًا آليًا للكود. يُحفظ تقدمك في حسابك.
اختبر فهمك.
ووصلها للإتقان.
كل سؤال خطوة لقدّام. اختار، اكتب كود، وشوف نتيجتك فورًا.
أكمل المهام، واجمع كل الإجابات الصحيحة. أقل من 100%؟ راجع وأعد المحاولة.
الأسئلة متاحة للاطلاع. سجّل الدخول للتفاعل وحفظ تقدمك.