في هذا الدرس 4تصفّح المواضيع
تتضمن جميع المتصفحات الحديثة الباني القياسي المدمج XMLHttpRequest. ينشئ الأمر const xhr = new XMLHttpRequest(); نسخة مستقلة تدير دورة تبادل HTTP كاملة عبر دوال التهيئة والإرسال (open وsend وabort)، وضبط المهلة (timeout)، وخصائص النتيجة (status وresponseText).
قاعدة هندسية مهمة: أنشئ دائماً نسخة جديدة مستقلة لكل طلب شبكي بدلاً من مشاركة كائن واحد بين عدة نقرات متزامنة.
بدلاً من فحص كل تغير داخلي يدوياً، توفر النسخة الحديثة من الكائن معالجات أحداث متخصصة نظيفة؛ وانتبه إلى أن xhr.onload يعمل فور اكتمال وصول الرد حتى لو كان بكود 404، لذا تحقّق دائماً من وقوع xhr.status بين 200 و299:
| معالج الحدث | متى ينطلق؟ | التصرف البرمجي المعتاد |
|---|---|---|
xhr.onload | اكتمال استلام رد الخادم بالكامل | فحص نجاح status ثم قراءة البيانات |
xhr.onerror | انقطاع الاتصال أو تعطل الشبكة أو حظر CORS | عرض رسالة اعتذار وإتاحة زر إعادة المحاولة |
xhr.ontimeout | تجاوز الطلب للمهلة المحددة في xhr.timeout | تنبيه المستخدم لتأخر استجابة الخادم |
const xhr = new XMLHttpRequest();
const out = document.getElementById('xhr-out');
const url = 'data:application/json,' +
encodeURIComponent('{"plan":"Pro","seats":12}');
xhr.onload = () => {
if (xhr.status >= 200 && xhr.status < 300) {
const d = JSON.parse(xhr.responseText);
out.textContent = d.plan + ' Plan (' + d.seats + ' seats)';
}
};
xhr.open('GET', url, true);
xhr.send();
هنا تتجلى نقطة التفوق العملية الأبرز لكائن XMLHttpRequest: تتبع تقدم نقل البايتات لحظة بلحظة! يعمل حدث التنزيل على xhr.onprogress، بينما يرصد xhr.upload.onprogress تقدم رفع الملفات الكبيرة إلى الخادم. عندما تكون event.lengthComputable محققة نحسب النسبة بدقة عبر المعادلة Math.round((e.loaded / e.total) * 100).
const xhr = new XMLHttpRequest();
const out = document.getElementById('prg-out');
const blob = new Blob(['CloseTag AJAX Byte Stream Demo']);
xhr.onprogress = (e) => {
const pct = e.lengthComputable
? Math.round((e.loaded / e.total) * 100) : 100;
out.textContent = 'Loaded: ' + e.loaded + 'B (' + pct + '%)';
};
xhr.open('GET', URL.createObjectURL(blob), true);
xhr.send();
حمايةً لبيانات المستخدمين، يفرض المتصفح سياسة نفس الأصل (Same-Origin Policy) على كائن XMLHttpRequest؛ فيسمح للكود بقراءة ردود المسارات التابعة لنفس البروتوكول والنطاق والمنفذ بحرية، بينما يمنع قراءة ردود أي نطاق خارجي ويُشغّل xhr.onerror ما لم يصرح الخادم البعيد بذلك عبر حقول رأس الاستجابة القياسية CORS.
ملخص الدرس
حصاد الدرسمراجعة مركّزة لأهم المفاهيم والقواعد الهندسية التي أتقنتها في هذا الدرس قبل التطبيق العملي
ماذا تعلّمت في هذا الدرس؟
أتقنت في هذا الدرس إنشاء نسخ مستقلة عبر new XMLHttpRequest()، والتعامل النظيف مع onload وonerror وontimeout، وحساب النسبة المئوية للتحويل عبر onprogress، وفهم سياسة نفس الأصل وCORS. الخطوة التالية: انتقل إلى درس «إرسال طلبات الشبكة عبر AJAX» لإتقان تهيئة وإرسال طلبات GET وPOST بأمان.
سجّل الدخول لحفظ تقدمك
تابع إنجاز المواضيع والمصطلحات والمهام، وكمّل من آخر خطوة على أي جهاز.
المصطلحات3
راجع المعنى، اشرحه لنفسك، ثم علّم البطاقة كمفهومة.
- 01 new XMLHttpRequest() باني كائن الطلب XMLHttpRequest
- ينشئ نسخة عميل HTTP مستقلة في المتصفح لإدارة إعدادات الطلب وأحداث التقدم وبيانات الرد.
- للمراجعة
- 02 xhr.upload.onprogress حدث تقدم الرفع upload.onprogress
- حدث دوري يعمل أثناء رفع الملفات للخادم ويوفر عدد البايتات المرسلة والإجمالي لحساب النسبة.
- للمراجعة
- 03 Same-Origin Policy (SOP) سياسة نفس الأصل الأمنية
- قاعدة الحماية الأساسية بالمتصفح التي تقصر قراءة الردود على نفس البروتوكول والنطاق والمنفذ ما لم يصرح الخادم.
- للمراجعة
لا توجد بطاقات تطابق البحث والتصفية.
اقرأ البطاقات بحرية. سجّل الدخول لحفظ تقدم مراجعتك.
الاختصارات2
راجع المعنى، اشرحه لنفسك، ثم علّم البطاقة كمفهومة.
- 01 SOP SOP
- Same-Origin Policy
- حدود الأمان القياسية التي تطابق البروتوكول والنطاق والمنفذ لحماية جلسات المستخدمين.
- للمراجعة
- 02 DNS DNS
- Domain Name System
- نظام أسماء النطاقات الذي يؤدي تعذر الوصول إليه إلى تشغيل معالج العطل الشبكي xhr.onerror.
- للمراجعة
لا توجد بطاقات تطابق البحث والتصفية.
اقرأ البطاقات بحرية. سجّل الدخول لحفظ تقدم مراجعتك.
مهامك قبل الاختبار
خطوة صغيرة كل مرة. وإنجاز تقدر ترجع له.
-
افتح مثال فحص تحميل XHR في محرر التجربة وعدّل عدد المقاعد من 12 إلى 25 وتحقق من النتيجة.
-
افتح مثال تتبع البايتات في محرر التجربة وأضف كلمات إضافية للنص لملاحظة زيادة عدد البايتات المحملة.
تأشير المهمة إقرار منك بإتمامها، وليس تصحيحًا آليًا للكود. يُحفظ تقدمك في حسابك.
اختبر فهمك.
ووصلها للإتقان.
كل سؤال خطوة لقدّام. اختار، اكتب كود، وشوف نتيجتك فورًا.
أكمل المهام، واجمع كل الإجابات الصحيحة. أقل من 100%؟ راجع وأعد المحاولة.
الأسئلة متاحة للاطلاع. سجّل الدخول للتفاعل وحفظ تقدمك.