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

تكامل واجهات الخادم الخلفية مع JSONJSON Backend API Integration طريقة إرسال معايير التصفية بالرابط، ومعالجة أخطاء تحقق الخادم، وعقد البيانات مع الخادم

أتقن تكامل واجهات JavaScript مع أي خادم خلفي عبر عقد JSON وبناء روابط التصفية بـ URLSearchParams ومعالجة أخطاء التحقق 422 وإحلال سياسة CORS محل JSONP.
أقسام الدرس
4
الأمثلة
2
اللغة
العربية
المشاهدات
3,568
محتوى الدرس
في هذا الدرس 4تصفّح المواضيع

يحقق عقد بيانات JSON فصلاً هندسياً كاملاً بين كود الواجهة الأمامية بـ JavaScript ولغة البرمجة العاملة على الخادم الخلفي؛ فسواء بُنيت نقطة النهاية بلغة PHP أو Python أو Go أو Java، يظل كود المتصفح ثابتاً لا يتغير ما دام شكل حقول JSON وأكواد HTTP متفقاً عليها.

ولا يرى متصفح الزائر أبداً شيفرة الخادم أو استعلامات قاعدة البيانات، بل يتبادل معها رؤوس HTTP وسلاسل application/json النصية فقط.

مخطط عقد التخاطب عبر JSON بين الواجهة والخادم الخلفي ومعالجة أخطاء 422 وإحلال CORS محل JSONP

عند طلب سجلات JSON مصفاة بطريقة GET (مثل تصفية الدورات حسب القسم ورقم الصفحة)، لا تدمج مدخلات المستخدم يدوياً بالجمع النصي داخل الرابط؛ بل ابنِ معاملات الاستعلام عبر الباني القياسي new URLSearchParams(...) الذي يرمّز المسافات والأحرف العربية والرموز الخاصة مثل & تلقائياً:

طريقة بناء الرابطعند إدخال q = "C++ & JS"سلامة الاستعلام المرسل
الدمج اليدوي "?q=" + qيكسر المعاملات عند علامة &استعلام تالف وعرضة للتلاعب بالمعاملات
الكائن new URLSearchParams({ q })q=C%2B%2B+%26+JSترميز قياسي سليم وآمن بالكامل
JavaScript
const params = new URLSearchParams({
  category: 'web & dom',
  limit: '10',
});
const endpoint = '/api/lessons?' + params.toString();
document.getElementById('url-out').textContent = endpoint;

عند إرسال نموذج يضم بيانات غير مقبولة (كالبريد المسجل مسبقاً)، ترد الخوادم الحديثة بكود الحالة 422 Unprocessable Content مع جسم JSON مهيكل يحدد رسائل كل حقل بدقة مثل {"errors": {"email": ["Email already taken"]}}.

لذلك يقرأ كود الواجهة الاحترافي جسم JSON حتى عندما تكون response.ok مساوية لـ false ليعرض رسالة الحقل المقابل للمستخدم عبر textContent بوضوح.

JavaScript
const mock422 = new Response(
  JSON.stringify({ errors: { email: ['Email is already registered.'] } }),
  { status: 422, headers: { 'Content-Type': 'application/json' } }
);
async function inspectReply(res) {
  const body = await res.json();
  if (res.status === 422) {
    document.getElementById('err-out').textContent = body.errors?.email?.[0] ?? 'Invalid';
  }
}
inspectReply(mock422);

قبل توحيد معيار CORS في المتصفحات، لجأ المطورون قديماً إلى حيلة تُسمى JSONP (JSON with Padding) عبر حقن وسم <script src="..."> خارجي يشغّل دالة محلية لتجاوز سياسة نفس الأصل.

تُعد تقنية JSONP اليوم مهجورة ومحظورة أمنياً لثلاثة أسباب حاسمة:

  • خطر اختراق كامل (XSS): لأنها تشغّل الرد كشيفرة برمجية حية بصلاحيات صفحتك الكاملة لا كنص بيانات معزول!
  • انحصارها في طلبات GET: لا يستطيع وسم <script> إرسال طلبات POST أو PUT أو رؤوس مخصصة.
  • غياب أكواد الحالة: يتعذر قراءة أكواد الخطأ مثل 422 أو 404 برمجياً؛ ولذلك حلت سياسة CORS مع fetch() محلها كلياً.
خلاصة المعرفة ومحطة الانتقال

ملخص الدرس

حصاد الدرس

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

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

استوعبت في هذا الدرس عقد التخاطب القياسي بـ JSON مع الخوادم الخلفية، وبناء روابط التصفية الآمنة بـ URLSearchParams، ومعالجة أخطاء التحقق 422، وسبب إحلال سياسة CORS محل حيلة JSONP القديمة. الخطوة التالية: انتقل إلى درس «بناء واجهات HTML ديناميكية آمنة من بيانات JSON» لتحويل مصفوفات البيانات إلى جداول وقوائم منسدلة بكفاءة وأمان.

مشاركة

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

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

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

المصطلحات3

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

0 / 3 مفهومةأول بطاقة، أول خطوة
01 URLSearchParams الكائن URLSearchParams
واجهة قياسية تبني معاملات استعلام الرابط وترمز المحارف الخاصة والمسافات تلقائياً بأمان.
للمراجعة
02 HTTP 422 Unprocessable Content كود الحالة 422 لأخطاء التحقق
كود استجابة قياسي يعني سلامة صياغة JSON المرسلة مع فشل إحدى القيم في شروط التحقق على الخادم.
للمراجعة
03 JSONP (Deprecated) تقنية JSONP المهجورة
أسلوب قديم غير آمن كان يحقن وسوم script خارجية لتبادل البيانات، واستُبدل كلياً بسياسة CORS.
للمراجعة

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

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

الاختصارات2

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

0 / 2 مفهومةأول بطاقة، أول خطوة
01 JSONP JSONP
JSON with Padding
تغليف JSON بدالة استدعاء داخل وسم سكربت، وهي تقنية متقاعدة لمخاطرها الأمنية.
للمراجعة
02 CSRF CSRF
Cross-Site Request Forgery
هجوم تزوير الطلبات عبر المواقع الذي يُصد عبر رموز التحقق ورؤوس الحماية المرفقة بالطلبات.
للمراجعة

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

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

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

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

0/2مهام منجزة
  1. غيّر قيمة category في محرر التجربة الأول إلى "java & json" وتأكد من ترميز المسافات والرمز & تلقائياً.

  2. أضف حقل خطأ ثانٍ باسم password داخل كائن errors في محرر التجربة الثاني واعرض رسالته في الواجهة.

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

مساحة التحدي

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

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

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

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

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

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

ماذا يحدث لكود fetch في الواجهة إذا غير فريق الخادم لغة البرمجة الخلفية مع الإبقاء على نفس الرابط وبنية حقول JSON؟

02

ما الأداة القياسية المدمجة في المتصفح لبناء وترميز معاملات استعلام الرابط بأمان دون كسر الرابط؟

03

ما كود حالة HTTP الشائع لإرجاع رسائل خطأ التحقق من الحقول بصيغة JSON عند رفض مدخلات نموذج؟

04

لماذا استُبدلت تقنية JSONP القديمة بسياسة CORS ودالة fetch الحديثة؟

05

يستطيع زائر الموقع رؤية كود الخادم الخلفي واستعلامات قاعدة البيانات بمجرد فحص رد JSON في المتصفح.

06

لماذا تُرفق تطبيقات الواجهة رأس الطلب Accept بقيمة application/json عند مخاطبة الخادم؟

07

ضبط رأس الاستجابة X-Content-Type-Options: nosniff مع نوع application/json يمنع المتصفح من تشغيل الرد كملف سكربت.

08

كيف يجب إدراج رسائل خطأ التحقق الواردة من الخادم داخل عناصر الصفحة لمنع ثغرات XSS؟

09

التحقق من المدخلات في كود JavaScript بالمتصفح يغني تماماً عن التحقق منها على الخادم الخلفي.

10

أي خيار في دالة fetch يحدد إرسال ملفات الكوكيز مع طلبات JSON المصرح بها عبر النطاقات؟