ابدأ بقيمة يمكنك التحقق منها
رقم الطلب معرّف، وليس كمية تحتاج إلى حساب. عندما يصعب قراءة ملف JSON، يكون المطلوب غالبًا إضافة مسافات وتنظيم الأسطر، دون تغيير البيانات. استخدم الطلب التجريبي أدناه قبل التعامل مع ملف مهم.
جرّب الخطوات
افتح أداة تنسيق JSON من أجمد. الصق المثال، ثم اختر التنسيق وراجع قيمة orderId. بعد ذلك جرّب التصغير على الناتج المنسق. ينبغي أن يطابق النص المصغّر المثال الأصلي تمامًا. انسخ النتيجة بعد مراجعتها.
{"orderId":9007199254740993,"customer":"أجمد","items":[1,2]}
ما الذي تحققنا منه؟
احتفظ المحرّك الحالي بالقيمة 9007199254740993 كما كُتبت، وباسم العميل العربي وترتيب المصفوفة. شغّلنا المثال على المحرّك المحلي للإصدار 1.0.0. لا يثبت هذا الاختبار توافق التطبيق الذي سيستقبل الملف، ولا يختبر أذونات الحافظة.
التنسيق ليس إعادة بناء البيانات
قد يقرأ برنامج JSON باستخدام تمثيله الخاص للأرقام، ثم يكتب البيانات من جديد. قد تتغير حينها قيمة لا يستطيع ذلك التمثيل حفظها بدقة. تستخدم أداة أجمد JSON.parse للتحقق من الصياغة، لكنها لا تعيد تسلسل الناتج المحلل. بل تعيد بناء التنسيق من الرموز الأصلية، فتغيّر المسافات غير المؤثرة وتحتفظ بصياغة الأرقام وتسلسلات الهروب.
اختبار فشل مفيد
جرّب {"items":[1,2,]}. الفاصلة الأخيرة غير صالحة في JSON، ويرفضها المحرّك. لا تستطيع أداة التنسيق تحديد القيمة التي تقصدها. صحّح المصدر وفق متطلبات النظام الذي أنشأ البيانات أو سيستخدمها.
حدود الأداة
الأداة لا تتحقق من JSON Schema. قد يكون الملف صحيح الصياغة لكنه يحتوي على حقول أو قيم عمل غير صحيحة. تحتفظ الأداة بالمفاتيح المكررة، لكن ذلك لا يجعل استخدامها مناسبًا؛ فقد تختلف البرامج في تفسيرها. الحد الأقصى للإدخال 200 ألف وحدة UTF-16، وللتداخل 100 مستوى، وللناتج مليون وحدة.
قبل استخدام الناتج
احتفظ بالأصل، وقارن الحقول المهمة، واختبر التطبيق المستقبل بعينة آمنة. يعالج المحرّك النص داخل المتصفح دون رفع الإدخال، مع احتياج الصفحة إلى تحميل ملفات الموقع. إضافات المتصفح وسجل الحافظة خارج نطاق هذا الوعد.