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

كائن الطلب XMLHttpRequest في JavaScriptAJAX XMLHttpRequest Object طريقة تتبع النسبة بحدث onprogress، وبنية كائن XMLHttpRequest، ومعالجا الاستجابة onload وonerror

أتقن كائن الطلب XMLHttpRequest في JavaScript: أنشئ نسخ XHR مستقلة، وعالج أحداث onload وonerror وontimeout، وتتبع نسبة التقدم عبر onprogress مع فهم سياسة نفس الأصل.
أقسام الدرس
4
الأمثلة
2
اللغة
العربية
المشاهدات
3,333
محتوى الدرس
في هذا الدرس 4تصفّح المواضيع

تتضمن جميع المتصفحات الحديثة الباني القياسي المدمج XMLHttpRequest. ينشئ الأمر const xhr = new XMLHttpRequest(); نسخة مستقلة تدير دورة تبادل HTTP كاملة عبر دوال التهيئة والإرسال (open وsend وabort)، وضبط المهلة (timeout)، وخصائص النتيجة (status وresponseText).

قاعدة هندسية مهمة: أنشئ دائماً نسخة جديدة مستقلة لكل طلب شبكي بدلاً من مشاركة كائن واحد بين عدة نقرات متزامنة.

مخطط بنية كائن XMLHttpRequest وأحداث onprogress وonload وonerror وسياسة نفس الأصل

بدلاً من فحص كل تغير داخلي يدوياً، توفر النسخة الحديثة من الكائن معالجات أحداث متخصصة نظيفة؛ وانتبه إلى أن xhr.onload يعمل فور اكتمال وصول الرد حتى لو كان بكود 404، لذا تحقّق دائماً من وقوع xhr.status بين 200 و299:

معالج الحدثمتى ينطلق؟التصرف البرمجي المعتاد
xhr.onloadاكتمال استلام رد الخادم بالكاملفحص نجاح status ثم قراءة البيانات
xhr.onerrorانقطاع الاتصال أو تعطل الشبكة أو حظر CORSعرض رسالة اعتذار وإتاحة زر إعادة المحاولة
xhr.ontimeoutتجاوز الطلب للمهلة المحددة في xhr.timeoutتنبيه المستخدم لتأخر استجابة الخادم
JavaScript
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).

JavaScript
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

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

0 / 3 مفهومةأول بطاقة، أول خطوة
01 new XMLHttpRequest() باني كائن الطلب XMLHttpRequest
ينشئ نسخة عميل HTTP مستقلة في المتصفح لإدارة إعدادات الطلب وأحداث التقدم وبيانات الرد.
للمراجعة
02 xhr.upload.onprogress حدث تقدم الرفع upload.onprogress
حدث دوري يعمل أثناء رفع الملفات للخادم ويوفر عدد البايتات المرسلة والإجمالي لحساب النسبة.
للمراجعة
03 Same-Origin Policy (SOP) سياسة نفس الأصل الأمنية
قاعدة الحماية الأساسية بالمتصفح التي تقصر قراءة الردود على نفس البروتوكول والنطاق والمنفذ ما لم يصرح الخادم.
للمراجعة

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

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

الاختصارات2

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

0 / 2 مفهومةأول بطاقة، أول خطوة
01 SOP SOP
Same-Origin Policy
حدود الأمان القياسية التي تطابق البروتوكول والنطاق والمنفذ لحماية جلسات المستخدمين.
للمراجعة
02 DNS DNS
Domain Name System
نظام أسماء النطاقات الذي يؤدي تعذر الوصول إليه إلى تشغيل معالج العطل الشبكي xhr.onerror.
للمراجعة

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

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

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

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

0/2مهام منجزة
  1. افتح مثال فحص تحميل XHR في محرر التجربة وعدّل عدد المقاعد من 12 إلى 25 وتحقق من النتيجة.

  2. افتح مثال تتبع البايتات في محرر التجربة وأضف كلمات إضافية للنص لملاحظة زيادة عدد البايتات المحملة.

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

مساحة التحدي

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

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

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

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

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

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

كيف تنشئ نسخة سليمة من كائن XMLHttpRequest في جميع المتصفحات الحديثة؟

02

إذا رد الخادم بكود الخطأ 404، يعمل الحدث xhr.onload أيضاً، لذا يجب فحص قيمة xhr.status داخله دائماً.

03

ما الخاصيتان داخل كائن حدث التقدم اللتان تُستخدمان لحساب النسبة المئوية عند تحقق lengthComputable؟

04

أين يُربط مستمع التقدم تحديداً لرصد نسبة «رفع» الملف من جهاز المستخدم إلى الخادم؟

05

ما الدالة التي تلغي طلب XMLHttpRequest الجارٍ فوراً؟

06

مشاركة متغير XMLHttpRequest واحد عام بين عدة طلبات متزامنة أكثر أماناً من إنشاء نسخة جديدة لكل طلب.

07

أي رابط مما يلي يطابق نفس الأصل (Same Origin) للرابط https://learn.closetag.com/courses؟

08

ما الخاصية التي تحدد المهلة القصوى بالمللي ثانية قبل إطلاق حدث انتهاء الوقت xhr.ontimeout؟

09

إذا لم يرسل الخادم طول المحتوى الإجمالي في رؤوس الرسالة، قد تكون خاصية event.lengthComputable مساوية لـ false.

10

ما الخاصية المنطقية التي توجه كائن XMLHttpRequest لإرفاق الكوكيز مع طلب خارجي مصرح به؟