ما هو JSON؟

في الجزء A تسعة أخطاء صياغة. السطر ⁦2⁩: تعليق، وJSON لا يقبل التعليقات. السطر ⁦4⁩: 'SAR' بعلامتي اقتباس مفردتين؛ اكتب "SAR". السطر ⁦5⁩: المفتاح items غير مقتبس؛ اكتب "items". وفي السطر ⁦7⁩ ثلاثة أخطاء: 01 يبدأ بصفر بادئ (اكتب 1)، و42. ينتهي بنقطة عشرية (اكتب 42 أو 42.00)، والفاصلة بعد آخر عنصر في المصفوفة يجب حذفها. السطر ⁦9⁩: False تُكتب بأحرف صغيرة false. وفي السطر ⁦11⁩ خطآن: علامتا الاقتباس المزدوجتان الداخليتان تُنهيان النص قبل أوانه، فهرّبهما بشرطة مائلة عكسية "Leave it at the gate marked \"B\""، والفاصلة بعد آخر عضو في الكائن يجب حذفها.

الأسطر ⁦1⁩ و⁦3⁩ و⁦6⁩ و⁦8⁩ و⁦10⁩ و⁦12⁩ صالحة. فـ6.50 رقم سليم (الأصفار بعد النقطة العشرية مسموحة)، وnull قيمة صالحة، والفاصلة خطأ فقط بعد العنصر الأخير، لذا فالفاصلة في نهاية السطر ⁦6⁩ سليمة. احذف التعليق بدلاً من تحويله إلى مفتاح مثل "_comment": فالملف هو جسم الطلب نفسه، وأي مفتاح إضافي يُرسَل إلى الواجهة أيضاً. ضع الملاحظة في اسم الاختبار أو وصفه.

يحتاج المدقّق إلى تسع جولات، جولة لكل خطأ بترتيب القائمة أعلاه، لأن المحلّل يتوقف عند أول خطأ يصادفه. اعتمد على السطر والعمود، فهما الموضع الذي توقف عنده المحلّل؛ أما التلميح فتخمين مبنيّ على النص المحيط بذلك الموضع، فراجعه مقابل القواعد. وبعد حذف سطر التعليق تنتقل أرقام الأسطر التالية كلها سطراً واحداً إلى الأعلى. وكثيراً ما يُبلَّغ عن الفاصلتين الزائدتين عند القوس المغلق في السطر التالي، حيث يلاحظهما المحلّل. إذن فالخطأ الواحد المُبلَّغ عنه لا يعني أبداً أن في المستند خطأً واحداً: اقرأ المستند كله مقابل القواعد أولاً، واستخدم المدقّق للتأكيد. ولاحظ أيضاً أن الاختبار الفاشل لم يقل شيئاً عن الواجهة: فالعيب كان في مواد الاختبار (Testware)، فتُصلح ملف البيانات ولا تسجّل عيباً على الواجهة.

الجزء C، الأنواع: orderId وstatus وcustomer.id نصوص (string)؛ وcustomer.phone رقم (number)؛ وitems مصفوفة من كائنين، وقيمتا sku فيهما نصّان؛ وquantity نص ("2") في العنصر الأول ورقم (0) في الثاني؛ وقيمتا unitPrice وtotal أرقام؛ وgiftWrap نص؛ وcouponCode قيمته null. أما deliveredAt فغائب.

الصحيح: orderId وcustomer.id وitems (مصفوفة من كائنين) وقيمتا sku وقيمتا unitPrice وcouponCode، ونوع total وصيغته (أما قيمته فتُفحص أدناه). الرقم في JSON قيمة لا صيغة عرض: 6.5 و6.50 رقم واحد، و42 رقم صالح، فعرض «⁦6.50⁩ ريال» مهمة الشاشة. والقيمة null مسموحة في couponCode وتعني أنه لم تُستخدم أي قسيمة.

الانحرافات، ويكشفها كلها التحقق من المخطط ولا يكشف أياً منها التحقق من الصياغة، لأن الاستجابة JSON صالح: (⁦1⁩) status قيمته "Paid"؛ والنصوص تُقارن حرفاً بحرف، فالعميل الذي يتحقق من "paid" لا يرى طلباً مدفوعاً (القيم المسموحة، أي enum). (⁦2⁩) customer.phone هو الرقم 501234567؛ والرقم في JSON لا يبدأ بصفر بادئ، فرقم الجوال المرسَل رقماً يفقد صفره دائماً (النوع string والنمط pattern). (⁦3⁩) items[0].quantity هو النص "2"؛ وفي JavaScript يعطي "2" + 1 النتيجة "21"، فالسلة التي تضيف قطعة أخرى تعرض ⁦21⁩ (النوع integer). (⁦4⁩) items[1].quantity قيمته 0، وهي أقل من الحد الأدنى ⁦1⁩ (minimum). (⁦5⁩) giftWrap هو النص "false"؛ وكل نص غير فارغ يُعامَل معاملة القيمة الصادقة (truthy) في JavaScript، فالشرط if (order.giftWrap) يعامل الطلب على أنه يطلب تغليف هدية (النوع boolean). (⁦6⁩) deliveredAt غائب؛ والمفتاح الغائب ليس null، فنتيجة order.deliveredAt === null هي false لأن القيمة undefined (required).

التعبير $.items[*].quantity يعيد "2" بالنوع string و0 بالنوع number، فيظهر انحرافا الكمية في استعلام واحد، وعلى المسار نفسه يضع الاختبار المؤتمت تأكيداته (Assertions). ويكتب عمود «النوع» number لا integer: ففي JSON نوع رقمي واحد، والعدد الصحيح (integer) قاعدة من العقد، ولها في JSON Schema النوع integer. ويشير «محلّل استجابات API» إلى بعض الانحرافات دون أي عقد (الكمية المرسلة نصاً وبنوع مختلف في كل عنصر، وgiftWrap المرسل نصاً)، لكنه لا يستطيع أن يعرف أن تهجئة الحالة أو رقم الجوال أو المفتاح الغائب أو الكمية الصفرية خطأ؛ فالعقد وحده يخبرك بذلك.

ما لا يكشفه أيّ من المستويين: الطلب المصحَّح طلب ⁦2 × 6.50 + 1 × 42.00 = 55.00⁩ ريال، وtotal قيمته ⁦55⁩، وهذا متطابق. لكن مجموع عناصر الاستجابة ⁦2 × 6.5 + 0 × 42 = 13⁩، فهي تخالف قاعدة العقد بأن total هو مجموعها، والمقارنة بالطلب تبيّن أن الخطأ في كمية RCE-5KG لا في الإجمالي. المخطط يفحص كل قيمة وحدها، ولا يستطيع فحص مجموع يمتد عبر الحقول ولا مقارنة الاستجابة بما طُلب؛ ولو أعاد الخادم الكمية ⁦3⁩ لنجحت كل قواعد المخطط. هذا يحتاج إلى مرجع اختبار (Test oracle)، أي مصدر للنتيجة المتوقعة، وهو هنا الطلب: احسب منه القيم المتوقعة وقارنها في تأكيد. وأبلغ عن كل انحراف بمسار الحقل والقيمة المتوقعة والقيمة الفعلية، مثل: «items[0].quantity: المتوقع عدد صحيح من ⁦1⁩ فأكثر، والفعلي النص "2"»، وأرفق الطلب والاستجابة.