طلب XHR: فهم XMLHttpRequest وكتابته ومراقبته

طلب XHR في JavaScript: إنشاء XMLHttpRequest وإرساله وتصحيحه، والتعامل مع حالة HTTP والشبكة وCORS، ثم متابعته عبر RUM في Dynatrace.
Requête XHR : comprendre, écrire et superviser XMLHttpRequest

طلب XHR هو طلب HTTP يُرسله المتصفح عبر كائن JavaScript المسمّى XMLHttpRequest. يتيح تبادل البيانات مع خادم من دون إعادة تحميل الصفحة. وفق MDN، تُستخدم هذه الواجهة لإرسال طلبات HTTP بين صفحة ويب وخادم، ورغم اسمها فهي لا تقتصر على صيغة XML.

في هذا المقال ستكتب طلب XHR خطوة بخطوة، وتعالج الاستجابة والأخطاء، وتفهم حالات الحظر بسبب CORS، ثم ترى كيف تقيس مراقبة المستخدمين الفعليين (Real User Monitoring، اختصارًا RUM) هذه الطلبات لدى مستخدمين حقيقيين. الجزء الخاص بـ Dynatrace ينطبق على Dynatrace SaaS كما على Dynatrace Managed: مفهوم «إجراء XHR» واحد في RUM الكلاسيكي على المنصتين.

باختصار

  • XHR هي واجهة AJAX التاريخية: تنشئ الكائن، وتسجّل مستمعي الأحداث، ثم تستدعي open فـ send.
  • Fetch هي الخيار الموصى به اليوم حين يكون ذلك ممكنًا، لكن XHR ما زالت حاضرة بقوة في الشيفرات القائمة وفي كثير من المكتبات.
  • تأتي الأخطاء غالبًا من ثلاثة مصادر: حالة HTTP، والشبكة، وCORS. ولكل منها طريقة تشخيص مختلفة.
  • تقيس Real User Monitoring مدة هذه الطلبات وإخفاقاتها داخل المتصفح، في رحلات حقيقية، وهو ما لا تُظهره اختبارات المختبر.

ما هو طلب XHR فعليًا

حين تنقر على «تحميل المزيد» فتظهر عناصر جديدة من دون تغيّر عنوان URL، فمن المرجح أن طلب XHR (أو مكافئه عبر Fetch) أُرسل في الخلفية. المبدأ، كما يصفه دليل MDN حول جلب البيانات من الخادم، يفصل بين مهمتين: تطلب JavaScript البيانات من الخادم، ثم تعدّل DOM لتحديث الواجهة، بدلًا من إطلاق تنقّل كامل.

يعود اختصار AJAX (Asynchronous JavaScript and XML) إلى زمن كانت فيه XML صيغة التبادل الشائعة. أما اليوم فيعيد الخادم غالبًا JSON، وأحيانًا HTML أو نصًا، كما تذكّر صفحة MDN نفسها. ويشدّد درس من جامعة كان نورماندي على نقطتين: الاستجابة ليست بالضرورة XML، ويجب إضافة المستمع قبل إطلاق الطلب بـ send.

كلمة «غير متزامن» محورية هنا. فالمتصفح لا ينتظر الاستجابة ليواصل عرض الصفحة والتفاعل مع النقرات. أنت تصف ما ينبغي أن يحدث عند وصول الاستجابة، وتستمر الشيفرة في التنفيذ.

كتابة طلب XHR خطوة بخطوة

وفق MDN، يمر الطلب بثلاث مراحل: إنشاء الكائن، وفتح عنوان URL بـ open، ثم الإرسال بـ send. المعامل async في open قيمته true افتراضيًا أو عند حذفه، فيكون الطلب عندئذ غير متزامن. إليك مثالًا بسيطًا يجلب JSON.

شيفرة JavaScript لطلب XHR من نوع GET: مستمعو الأحداث load وerror وabort، ثم open وsetRequestHeader وsend
Source : developer.mozilla.org
const xhr = new XMLHttpRequest();

xhr.addEventListener("load", () => {
  if (xhr.status >= 200 && xhr.status < 300) {
    const data = JSON.parse(xhr.responseText);
    console.log(data);
  } else {
    console.error("Statut HTTP inattendu :", xhr.status);
  }
});

xhr.addEventListener("error", () => console.error("Échec réseau"));
xhr.addEventListener("abort", () => console.warn("Requête annulée"));

xhr.open("GET", "https://api.exemple.fr/produits");
xhr.setRequestHeader("Accept", "application/json");
xhr.send();

الخطوات الأربع التي يجب تذكّرها

  1. إنشاء الكائن بـ new XMLHttpRequest().
  2. ربط مستمعي الأحداث. توضح MDN أنه يجب إضافتهم قبل استدعاء open، وإلا لن تُلتقط أحداث progress.
  3. فتح الطلب بـ open(method, url). تُعرَّف الترويسات بعد open وقبل send.
  4. الإرسال بـ send(). وفق صفحة XMLHttpRequest.send()، ترسل هذه الدالة الطلب إلى الخادم وتقبل معاملًا اختياريًا للجسم، يُستخدم خصوصًا مع طلبات مثل PUT. أما مع GET أو HEAD فيُتجاهل هذا الجسم.

إرسال بيانات عبر POST

لإرسال POST بصيغة JSON، افتح الطلب بالطريقة POST، وصرّح بنوع المحتوى، ثم مرّر الجسم إلى send. يضيف المثال التالي أيضًا مهلة زمنية، نفصّلها لاحقًا:

شيفرة JavaScript لطلب XHR من نوع POST بصيغة JSON مع مهلة timeout قدرها 8000 ms وترويسة Content-Type وجسم JSON.stringify
Source : developer.mozilla.org
const xhr = new XMLHttpRequest();

xhr.timeout = 8000;
xhr.addEventListener("timeout", () => console.warn("Délai dépassé"));
xhr.addEventListener("load", () => console.log(xhr.status));

xhr.open("POST", "/api/commandes");
xhr.setRequestHeader("Content-Type", "application/json");
xhr.send(JSON.stringify({ produit: 42, quantite: 2 }));

اختيار نوع الاستجابة

تحدد الخاصية responseType الصيغة المتوقعة: text (القيمة الافتراضية) أو arraybuffer أو blob أو document أو json. مع واجهة API تعيد JSON، يغنيك ضبط xhr.responseType = "json" قبل الإرسال عن JSON.parse اليدوي: تقرأ النتيجة حينها من xhr.response، التي تكون null إذا أعاد الخادم شيئًا غير JSON صالح. ولتنزيل ملف، blob هو الخيار المعتاد.

متابعة سير الطلب: الأحداث والحالة والأخطاء

يمر طلب XHR بعدة حالات، وتعطي الخاصية readyState قيمتها. يتحقق مثال MDN التاريخي من readyState === XMLHttpRequest.DONE (القيمة 4) ومن status === 200 قبل قراءة الاستجابة. والأحداث الحديثة أوضح قراءةً من onreadystatechange القديم.

جدول أحداث XMLHttpRequest: progress وload وerror وabort وtimeout وloadend، مع لحظة الإطلاق والاستخدام المعتاد
Source : developer.mozilla.org
الحدث متى يُطلق الاستخدام المعتاد
progress أثناء النقل شريط تقدّم لعملية تنزيل
load اكتمال النقل قراءة الاستجابة والحالة
error فشل الطلب (شبكة، CORS) رسالة خطأ، إعادة محاولة
abort إلغاء الطلب تنظيف الواجهة
timeout تجاوز مهلة xhr.timeout إعلام المستخدم
loadend النهاية، أيًا كانت النتيجة إخفاء مؤشر التحميل

يستند هذا الجدول إلى تعريفات وثائق MDN. نقطة خادعة: يُطلق load أيضًا مع استجابة 404 أو 500، لأن النقل اكتمل فعلًا. لذلك تحقق دائمًا من xhr.status داخل معالج load، كما في المثال أعلاه. أما الحدث error فيشير إلى أن الطلب لم يتمكن من الاكتمال أصلًا.

إدارة المهلة الزمنية

افتراضيًا، قيمة xhr.timeout هي 0، أي بلا مهلة: قد يبقى الطلب منتظرًا طويلًا. اضبط xhr.timeout بالميلي ثانية واستمع إلى الحدث timeout لإعلام المستخدم، بدلًا من ترك مؤشر يدور إلى ما لا نهاية. هذه القيمة نقطة انطلاق جيدة أيضًا لتحديد ما يُعدّ «بطيئًا جدًا» في مراقبتك.

لماذا يفشل طلب XHR: HTTP والشبكة وCORS

ثلاث عائلات من المشكلات تتكرر باستمرار. والتمييز بينها يوفّر وقتًا كثيرًا.

أخطاء HTTP (4xx و5xx)

أجاب الخادم، لكن بحالة فشل. الطلب «نجح» من حيث النقل، ويُطلق الحدث load، وعلى شيفرتك أن تقرأ xhr.status. يشير 401 أو 403 إلى المصادقة، و404 إلى عنوان URL خاطئ، و500 إلى مشكلة في جانب الخادم.

أخطاء الشبكة

لا توجد استجابة قابلة للاستخدام: انقطاع الاتصال، أو تعذّر حل DNS، أو شهادة غير صالحة. يُطلق الحدث error وحده، من دون حالة مفيدة. في المتصفح يبقى التفصيل غامضًا عمدًا، وتبويب الشبكة (Network) في أدوات المطوّر هو حليفك الأفضل.

أخطاء CORS

يطبّق المتصفح سياسة الأصل الواحد (same-origin policy). لا يكتمل طلب إلى نطاق آخر إلا إذا سمح الخادم بذلك. تشير MDN إلى أن XMLHttpRequest يعمل ما دام الخادم مضبوطًا لقبول أصل تطبيق الويب الخاص بك، عبر ترويسة الاستجابة Access-Control-Allow-Origin. في الشيفرة، يشبه العَرَض خطأ شبكة، لكن وحدة تحكم المتصفح تذكر سببًا دقيقًا متعلقًا بـ CORS.

حالتان شائعتان:

  • ملفات تعريف الارتباط لا تُرسل. افتراضيًا، لا تُرسل بيانات الاعتماد (ملفات تعريف الارتباط، ترويسات المصادقة) في طلب عابر للأصول. على العميل ضبط xhr.withCredentials على true، وعلى الخادم الرد بالترويسة Access-Control-Allow-Credentials: true، وإلا أبلغ المتصفح عن خطأ شبكة.
  • الاختبار يجري من ملف محلي. لا يمكن لطلبات CORS استخدام سوى مخططي HTTP أو HTTPS. وفق MDN، صفحة مفتوحة عبر file:/// لها أصل مبهم (opaque) وتسبب خطأ CORS في Firefox كما في Chrome. شغّل خادمًا محليًا صغيرًا بدلًا من ذلك.

يُصحَّح حظر CORS في جانب الخادم دائمًا تقريبًا، بضبط ترويسات الاستجابة. ولا يمكن لأي شيفرة JavaScript في جانب العميل الالتفاف على هذه القاعدة بشكل سليم.

XHR أم Fetch: ماذا تختار اليوم؟

للشيفرة الجديدة، تنصح MDN باستخدام Fetch متى أمكن، لأن الواجهة أبسط وتقدّم مزايا أكثر. تبقى XHR شائعة في الشيفرات التاريخية: فهي الواجهة التي سبقت Fetch وأول ما أتاح AJAX (المصدر: MDN).

عمليًا، ستصادف XHR في ثلاث حالات:

  • تطبيق قديم يجب صيانته، حيث إعادة كتابة كل استدعاء ليست أولوية؛
  • مكتبة خارجية تستخدم XHR داخليًا؛
  • الحاجة إلى متابعة تقدّم رفع ملف، حيث يبقى الحدث progress في XHR عمليًا.

بالنسبة للمراقبة، الخبر الجيد أن الاختيار لا يغيّر الجوهر: يلتقط RUM في Dynatrace استدعاءات XMLHttpRequest كما يلتقط استدعاءات fetch()، ويمكنك الترحيل تدريجيًا من دون فقدان الرؤية على استدعاءاتك.

إمكانية الوصول: لا تنسَ ما يتغيّر في الصفحة

تحديث المحتوى غير المتزامن غير مرئي لمن يستخدم متصفحًا صوتيًا إذا لم يعلن عنه شيء. يوفّر معيار WAI-ARIA مواصفات للحد من هذا النوع من المشكلات، كما تذكّر صفحة ويكيبيديا المخصصة لـ XMLHttpRequest. عمليًا، أشر إلى التغييرات المهمة بمنطقة aria-live وأدر التركيز (focus) بعد تحميل جزئي.

مراقبة طلبات XHR عبر Real User Monitoring

شيفرتك تعمل على جهازك، باتصال جيد. لكن مستخدميك لديهم شبكات محمولة، وإضافات متصفح، وأجهزة قديمة. تجمع Real User Monitoring القياسات مباشرة في متصفحهم للإجابة عن سؤال بسيط: ماذا يعيش المستخدمون فعلًا؟

RUM والبيانات الميدانية

تستخدم Google بيانات RUM الميدانية لتحديد ما إذا كان موقع ما يحترم العتبات الموصى بها لمؤشرات Core Web Vitals، كما يشرح web.dev. ويلاحظ المقال نفسه أن بيانات RUM التي تجمعها بنفسك تكمّل الأدوات القائمة على CrUX، بمعلومات أكثر تفصيلًا وفورية.

ما تفعله Dynatrace بطلبات XHR

في Dynatrace، ينشئ تفاعل المستخدم الذي يطلق XMLHttpRequest أو استدعاءات fetch() إجراء XHR (XHR action). توضح صفحة «User actions» في وثائق Dynatrace أن الإجراء يبدأ عند نقرة المستخدم، وأن Dynatrace تكتشف أيضًا طلبات XHR الإضافية المطلقة في callback الطلب الأول، وأنها تنتظر انتهاء جميع الطلبات قبل إغلاق الإجراء. ويدوم إجراء الويب 3 دقائق كحد أقصى. في تطبيق الصفحة الواحدة، حيث يمر كل الاتصال تقريبًا عبر XHR بعد التحميل الأول، هذا ما يجعل الرحلات قابلة للقياس.

إعدادان يجدر معرفتهما في ضبط تطبيق الويب (RUM الكلاسيكي، SaaS وManaged): يُفعَّل التقاط XHR في Capturing > Async web requests and SPAs > Generic support، الخيار «Capture XmlHttpRequest (XHR)»، وتستبعد قواعدُ الاستثناء بتعبير نمطي على عنوان URL الاستدعاءاتِ التقنية (heartbeat، القياس عن بُعد) التي قد تنشئ إجراءات طفيلية. نقطة أخرى موثقة: يجب أن يبدأ الطلب خلال 30 ms بعد التفاعل؛ وقد تتجاوز الشيفرة القائمة على الوعود (promises) هذه النافذة، وتوصي Dynatrace عندئذ بواجهة JavaScript الخاصة بـ RUM لإنشاء الإجراء بنفسك.

ما يمكنك قراءته بعد ذلك يعتمد على ضبطك، لكن الأسئلة المطروحة واحدة دائمًا:

  1. أي إجراء هو الأبطأ لدى المستخدمين، وعلى أي متصفح أو نوع جهاز؟
  2. أي استدعاء XHR يسبب الأخطاء، وبأي رمز HTTP؟
  3. هل البطء من الشبكة أم من الخادم؟ قارن المدة في المتصفح بالتتبّع في جانب الخادم.
  4. هل تظهر أخطاء JavaScript مباشرة بعد استجابة غير متوقعة؟

لإعداد حقن JavaScript واختيار التطبيقات وقراءة Core Web Vitals، اتبع دليلنا حول ضبط RUM في Dynatrace. وبعد قياس إجراءاتك، يبيّن درسنا حول metric selector والتنبيهات كيف تستعلم عن هذه المقاييس وتطلق تنبيهًا عندما تتجاوز مدةٌ ما عتبتك.

مثال على مسار تشخيص

تخيّل صفحة بحث يشكو المستخدم من أنها «بطيئة». إليك مسارًا واقعيًا، من دون أرقام مختلقة:

  1. في RUM، رشّح على إجراء XHR الذي يطلقه البحث وانظر إلى توزيع المدد بدلًا من المتوسط.
  2. قسّم حسب المتصفح والبلد ونوع الاتصال لترى إن كانت المشكلة عامة أم محصورة.
  3. إذا كانت المدة طويلة في كل مكان، افتح التتبّع الموزّع المرتبط وابحث عن الخدمة أو استعلام قاعدة البيانات المسؤول.
  4. إذا كانت طويلة على الهاتف المحمول فقط، افحص حجم الاستجابة: واجهة API تعيد حقولًا كثيرة جدًا مكلفة على شبكة بطيئة.
  5. بعد التصحيح، قارن ما قبل وما بعد على الفترة نفسها لتأكيد الأثر.

لأهداف كمون قائمة على التوزيع لا على المتوسط، راجع أيضًا مقاييس المدرّج التكراري في OpenPipeline. ولإعادة إنتاج استدعاء بطيء من وكيل برمجة، يتيح Chrome DevTools MCP الوصول إلى لوحة الشبكة من المساعد.

ممارسات جيدة لطلبات XHR موثوقة

  • تحقق دائمًا من status داخل load، لا من وصول الحدث فقط.
  • حدد timeout ورسالة واضحة للمستخدم.
  • ألغِ الطلبات التي لم تعد مفيدة بـ abort()، مثلًا حين يكتب المستخدم بحثًا جديدًا.
  • تجنّب الوضع المتزامن: فهو يجمّد الواجهة، وtimeout وresponseType ممنوعان فيه داخل صفحة.
  • فضّل HTTPS ولا تضع سرًا أبدًا في شيفرة العميل.
  • قِس في الإنتاج: استدعاء يبدو سريعًا في التطوير قد يكون بطيئًا لدى مستخدميك.

وجهة نظرنا

في span.observer نلاحظ أن معظم الأسئلة حول طلبات XHR تخفي سؤالًا عن المراقبة: الطلب يخرج، لكن لا أحد يعرف كم يستغرق لدى المستخدم ولا لماذا يفشل.

نؤمن بأن المطوّر يتقدم أسرع حين يربط ثلاثة مستويات: الشيفرة (هذا الدليل)، والقياس في المتصفح (RUM)، والتتبّع في جانب الخادم. لهذا تنطلق دروسنا حول Dynatrace من مشكلات إنتاج ملموسة، في Managed كما في SaaS، وتبقى مجانية ومستقلة وبلا إعلانات.

نهجنا أن نمنحك خطوات قابلة للتطبيق فورًا: اضبط، اقرأ، استعلم، نبّه. تتعلم بإيقاعك، ويمكنك مشاركة هذه الموارد مع فريقك.

المضي أبعد مع مواردنا المجانية

إذا أردت الانتقال من طلب XHR المعزول إلى رؤية شاملة لتطبيقاتك، فإن تدريبنا المجاني في الملاحظة يتبع مسارًا تدريجيًا، من الإشارات إلى SLO. وهو موجّه إلى المطوّرين ومهندسي SRE ومسؤولي تقنية المعلومات الراغبين في تدريب فرقهم.

الأسئلة الشائعة

ما هو طلب XHR؟

هو طلب HTTP يرسله كائن JavaScript المسمّى XMLHttpRequest من المتصفح. يجلب البيانات من خادم أو يرسلها إليه من دون إعادة تحميل الصفحة. والصيغة المتبادلة غالبًا JSON، حتى وإن ورد XML في الاسم.

ما الفرق بين XHR وFetch؟

كلاهما يرسل طلبات HTTP من المتصفح. تنصح MDN بـ Fetch متى أمكن، لأنها أبسط وأغنى بالمزايا. تبقى XHR مفيدة لصيانة شيفرة قائمة، ويلتقط RUM في Dynatrace الآليتين على حد سواء.

لماذا يحظر CORS طلب XHR الخاص بي؟

خادم الوجهة لا يسمح بأصل صفحتك. يجب ضبط ترويسات استجابة CORS لديه، وإضافة withCredentials في جانب العميل إذا كان يجب إرسال ملفات تعريف الارتباط. تحقق أيضًا من أنك لا تختبر من صفحة مفتوحة عبر file:///.

ماذا تقيس Real User Monitoring في طلب XHR؟

تقيس، في متصفح مستخدمين حقيقيين، مدة ونتيجة الاستدعاءات التي تطلقها إجراءاتهم. في Dynatrace، تشكّل هذه الاستدعاءات إجراءات XHR يمكنك ترشيحها حسب المتصفح أو الموقع الجغرافي أو التطبيق. ويفصّل دليلنا حول RUM خطوات الضبط.

المصادر

span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لشركة Dynatrace LLC. تحقق دائمًا من القيم (المنافذ والإصدارات والأحجام) في الوثائق الرسمية الخاصة بإصدارك.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
OpenObserve, observabilité open source en Rust : logs, métriques, traces et RUM

OpenObserve مفتوح المصدر بلغة Rust: السجلات والمقاييس والتتبعات وRUM

Next Post
Lightpanda navigateur headless en Zig : agents IA, mémoire et supervision

Lightpanda متصفح headless بلغة Zig: وكلاء الذكاء الاصطناعي والذاكرة والمراقبة

Related Posts