في هذا الدرس 4تصفّح المواضيع
يحقق عقد بيانات JSON فصلاً هندسياً كاملاً بين كود الواجهة الأمامية بـ JavaScript ولغة البرمجة العاملة على الخادم الخلفي؛ فسواء بُنيت نقطة النهاية بلغة PHP أو Python أو Go أو Java، يظل كود المتصفح ثابتاً لا يتغير ما دام شكل حقول JSON وأكواد HTTP متفقاً عليها.
ولا يرى متصفح الزائر أبداً شيفرة الخادم أو استعلامات قاعدة البيانات، بل يتبادل معها رؤوس HTTP وسلاسل application/json النصية فقط.
عند طلب سجلات JSON مصفاة بطريقة GET (مثل تصفية الدورات حسب القسم ورقم الصفحة)، لا تدمج مدخلات المستخدم يدوياً بالجمع النصي داخل الرابط؛ بل ابنِ معاملات الاستعلام عبر الباني القياسي new URLSearchParams(...) الذي يرمّز المسافات والأحرف العربية والرموز الخاصة مثل & تلقائياً:
| طريقة بناء الرابط | عند إدخال q = "C++ & JS" | سلامة الاستعلام المرسل |
|---|---|---|
الدمج اليدوي "?q=" + q | يكسر المعاملات عند علامة & | استعلام تالف وعرضة للتلاعب بالمعاملات |
الكائن new URLSearchParams({ q }) | q=C%2B%2B+%26+JS | ترميز قياسي سليم وآمن بالكامل |
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 بوضوح.
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
راجع المعنى، اشرحه لنفسك، ثم علّم البطاقة كمفهومة.
- 01 URLSearchParams الكائن URLSearchParams
- واجهة قياسية تبني معاملات استعلام الرابط وترمز المحارف الخاصة والمسافات تلقائياً بأمان.
- للمراجعة
- 02 HTTP 422 Unprocessable Content كود الحالة 422 لأخطاء التحقق
- كود استجابة قياسي يعني سلامة صياغة JSON المرسلة مع فشل إحدى القيم في شروط التحقق على الخادم.
- للمراجعة
- 03 JSONP (Deprecated) تقنية JSONP المهجورة
- أسلوب قديم غير آمن كان يحقن وسوم script خارجية لتبادل البيانات، واستُبدل كلياً بسياسة CORS.
- للمراجعة
لا توجد بطاقات تطابق البحث والتصفية.
اقرأ البطاقات بحرية. سجّل الدخول لحفظ تقدم مراجعتك.
الاختصارات2
راجع المعنى، اشرحه لنفسك، ثم علّم البطاقة كمفهومة.
- 01 JSONP JSONP
- JSON with Padding
- تغليف JSON بدالة استدعاء داخل وسم سكربت، وهي تقنية متقاعدة لمخاطرها الأمنية.
- للمراجعة
- 02 CSRF CSRF
- Cross-Site Request Forgery
- هجوم تزوير الطلبات عبر المواقع الذي يُصد عبر رموز التحقق ورؤوس الحماية المرفقة بالطلبات.
- للمراجعة
لا توجد بطاقات تطابق البحث والتصفية.
اقرأ البطاقات بحرية. سجّل الدخول لحفظ تقدم مراجعتك.
مهامك قبل الاختبار
خطوة صغيرة كل مرة. وإنجاز تقدر ترجع له.
-
غيّر قيمة category في محرر التجربة الأول إلى "java & json" وتأكد من ترميز المسافات والرمز & تلقائياً.
-
أضف حقل خطأ ثانٍ باسم password داخل كائن errors في محرر التجربة الثاني واعرض رسالته في الواجهة.
تأشير المهمة إقرار منك بإتمامها، وليس تصحيحًا آليًا للكود. يُحفظ تقدمك في حسابك.
اختبر فهمك.
ووصلها للإتقان.
كل سؤال خطوة لقدّام. اختار، اكتب كود، وشوف نتيجتك فورًا.
أكمل المهام، واجمع كل الإجابات الصحيحة. أقل من 100%؟ راجع وأعد المحاولة.
الأسئلة متاحة للاطلاع. سجّل الدخول للتفاعل وحفظ تقدمك.