تنسيق JSON والتحقق من صحته

جرّب المثال المرفق

نزّل order-options.json، وهو طلب خيالي يحتوي على صنفين وأسماء حقول باللغة الإنجليزية. يجمع الكائن customer اسمًا ومدينة؛ وتحتوي المصفوفة items على CARD-02 ثم BOX-01. يتضمن المثال نصًا بين علامتي اقتباس، وكميات وأسعارًا عددية، والقيمة المنطقية true، والقيمة null لملاحظة توصيل فارغة. الحقول غير مرتبة عمدًا لإظهار تأثير خيار الترتيب.

خطوة بخطوة

1. افتح منسّق ومدقق JSON. استخدم ملف لفتح الملف المرفق order-options.json، أو الصق محتواه في قيم الإدخال.
2. اضبط المسافة البادئة على 2 لاستخدام مسافتين لكل مستوى. اترك ترتيب مفاتيح الكائنات غير محدد في التشغيل الأول.
3. اختر معالجة المدخلات. تتحقق الأداة من صياغة JSON قبل عرض النتيجة. إذا أبلغت عن خطأ، فاستخدم رقم السطر والعمود لتحديده، ثم صحح الإدخال وحاول مجددًا.
4. اقرأ النتيجة. يجب أن يكون الكائن customer والصنفان واضحين، بحقل أو عنصر قائمة واحد في كل سطر. تحتفظ الحقول بترتيب المثال ما دام خيار الترتيب غير محدد.
5. اختر تنزيل النتيجة لحفظ formatted.json. يمكنك أيضًا استخدام نسخ النص لنقل النتيجة إلى محرر آخر.
6. افتح الملف المنزّل في محرر نصوص وقارنه بالمثال باستخدام الفحوص أدناه. ثم جرّب الخيارات الأخرى للمسافة البادئة والترتيب، واختر معالجة المدخلات مجددًا بعد كل تغيير.

أمثلة قبل وبعد

تستخدم هذه الأمثلة القصيرة الكائن customer من order-options.json وتعرضه كمستند JSON صغير. قارن الاسم والمدينة نفسيهما قبل كل إعداد وبعده. يعرض قسم المراجع الاختياري في النهاية الطلب كاملًا.

{"customer":{"name":"Zoë","city":"Bergen"}}

{
  "customer": {
    "name": "Zoë",
    "city": "Bergen"
  }
}

{
  "customer": {
    "name": "Zoë",
    "city": "Bergen"
  }
}

{
  "customer": {
    "city": "Bergen",
    "name": "Zoë"
  }
}

{
  "customer": {
    "name": "Zoë",
    "city": "Bergen"
  }
}

{"customer":{"name":"Zoë","city":"Bergen"}}

اختيار المسافة البادئة

يؤدي تغيير الإدخال أو أي خيار إلى مسح النتيجة السابقة. اختر معالجة المدخلات مجددًا لإنشاء نتيجة بالإعدادات الجديدة. تقرأ الأداة منطقة الإدخال في كل مرة؛ ولا تعيد النتيجة السابقة إلى الإدخال تلقائيًا.

ترتيب مفاتيح الكائنات

اترك ترتيب مفاتيح الكائنات غير محدد للاحتفاظ بالترتيب الأصلي لحقول كل كائن. عند تحديده، يرتب المفاتيح وفق الترتيب النصي مع التمييز بين الأحرف الكبيرة والصغيرة في المستند كله، بما في ذلك الكائنات داخل المصفوفات. تحتفظ عناصر المصفوفات نفسها بتسلسلها الأصلي.

1. أبقِ المسافة البادئة على 2، وحدد ترتيب مفاتيح الكائنات، واختر معالجة المدخلات.
2. تصبح مفاتيح المستوى الأعلى بالترتيب customer وdeliveryNote وitems وorder وpaid. داخل customer، يأتي city قبل name. وداخل كل صنف، يأتي price قبل quantity وsku.
3. لا تزال المصفوفة items تحتوي على CARD-02 ثم BOX-01. ترتيب المفاتيح لا يرتب الأصناف حسب sku أو السعر.

النسخ والتنزيل والبدء من جديد

التحقق من ملف JSON المنزّل

• افتح formatted.json في محرر نصوص. تأكد من أن الطلب هو ORD-1042، وأن العميل هو Zoë في Bergen، وأن هناك صنفين.
• تحقق من القيم وأنواعها: quantity هو العدد 2 ثم 1، والأسعار تحتفظ بـ19.50 و5.00، وpaid هو القيمة المنطقية true دون اقتباس، وdeliveryNote هو القيمة null دون اقتباس. تبقى الأسماء ورموز الأصناف بين علامتي اقتباس سلاسل نصية.
• بعد تجربة ترتيب مفاتيح الكائنات، تحقق من ترتيب الحقول الموضح أعلاه ومن أن CARD-02 لا يزال يسبق BOX-01 في المصفوفة items.
• جرّب تصغير ومعالجة المدخلات. الصق النتيجة مجددًا في قيم الإدخال، واضبط المسافة البادئة على 2، واختر معالجة المدخلات مرة أخرى. قارن القيم وترتيب الأصناف بالمثال الأصلي؛ يجب أن تحافظ خيارات التنسيق عليهما.

الأسئلة وحل المشكلات

لماذا تشير الأداة إلى أن JSON غير صالح؟

تحقق من السطر والعمود المذكورين ومن الحقل الذي يسبق ذلك الموضع مباشرة. تحتاج المفاتيح والنصوص إلى علامتي اقتباس مزدوجتين؛ وتحتاج الحقول إلى فواصل ونقطتين رأسيتين؛ ويجب إغلاق الأقواس المربعة والمعقوفة. صحح الإدخال واختر معالجة المدخلات مجددًا. يفحص التحقق صياغة JSON، لذا قد تظل النتيجة الصالحة تفتقد حقولًا يتطلبها تطبيقك.

هل يمكن استخدام التعليقات أو فاصلة أخيرة؟

أزل التعليقات وأي فاصلة تسبق قوسًا مربعًا أو معقوفًا مغلقًا مباشرة. فهي غير صالحة في JSON. تتطلب أداة التنسيق إدخالًا صالحًا ولا تصلحه تلقائيًا.

ماذا يعني تحذير المفتاح المتكرر؟

تعني الرسالة «تم الاحتفاظ بالمفاتيح المكررة. قد تتجاهل بعض البرامج المفاتيح المكررة.» أن مفتاحًا يظهر أكثر من مرة في الكائن نفسه. تحتفظ أداة التنسيق بهذه الإدخالات وتحذرك. راجع المصدر، واختر القيمة المقصودة، وأزل الإدخال الإضافي؛ فقد يحتفظ تطبيق آخر بواحد منها فقط.

لماذا لا يُفتح ملفي أو لا تتم معالجته؟

الحد الأقصى للإدخال هو 2 MiB، أي 2,097,152 بايت. يجب أن تكون الملفات النصية المحلية بترميز UTF-8. إذا أبلغت الأداة أن البيانات معقدة جدًا، فقلل مستويات التداخل أو عدد الإدخالات. قسّم الإدخال الكبير إلى مستندات JSON أصغر ومكتملة بدلًا من قطعه وسط كائن أو مصفوفة.

لماذا تتغير الأعداد الطويلة في تطبيق آخر؟

يحتوي مثال الدقة المنفصل أدناه على 9007199254740993 و0.10000000000000001. تحتفظ أداة التنسيق هذه بنص الأعداد كما هو تمامًا مع جميع خيارات المسافة البادئة والترتيب. نسّق exact-numbers.json وقارن النتيجة بـexact-numbers-formatted.json في محرر نصوص. قد يظل التطبيق الذي يستورد النتيجة يقرّب الأعداد، لذا تأكد من دعمه للدقة المطلوبة. يجب أن يكون الرمز ذو الأصفار البادئة، مثل 00123، سلسلة نصية بين علامتي اقتباس في JSON.

هل يمكن للتنسيق استعادة أرقام قُرّبت سابقًا؟

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

أدوات ذات صلة

المصادر