منسق ومحقق JSON
أداة JSON Formatter تنظف وتتحقق من JSON داخل المتصفح. تلصق النص في مربع الإدخال، ثم تختار المسافة البادئة: مسافتان، أربع مسافات أو tab. عند الضغط على Format يستخدم الكود JSON.parse لقراءة النص، ثم JSON.stringify لإخراجه بتنسيق واضح. زر Validate يكتفي بالتحقق من صحة JSON دون عرض نسخة منسقة. إذا كان النص غير صالح، تظهر رسالة الخطأ القادمة من parser حتى تعرف موضع المشكلة تقريبا.
ما الذي تعتبره الأداة JSON صالحا؟
JSON الصالح يستخدم أقواسا للكائنات، أقواسا مربعة للمصفوفات، مفاتيح نصية بين علامتي اقتباس مزدوجتين، وقيم مثل string وnumber وtrue وfalse وnull. لا يقبل JSON الرسمي التعليقات، الفواصل الزائدة في نهاية المصفوفة، أو المفاتيح غير المحاطة بعلامتي اقتباس. لذلك قد تعمل بعض النصوص في JavaScript object literal لكنها تفشل هنا لأنها ليست JSON معياريا.
متى تستخدم JSON Formatter؟
يفيد المنسق عند قراءة رد API، تنظيف إعدادات، مراجعة payload قبل إرساله، أو مقارنة نسخة مضغوطة من JSON مع نسخة قابلة للقراءة. المسافة البادئة تجعل البنية الهرمية واضحة، خصوصا في الكائنات المتداخلة والمصفوفات الطويلة. وإذا كنت ترسل المثال لفريق دعم أو مطور، فنسخ النسخة المنسقة يقلل سوء الفهم ويسهل اكتشاف الحقول الناقصة أو أنواع القيم غير المتوقعة.
الخصوصية والعمل المحلي
الأداة تعمل في المتصفح ولا تحتاج إلى إرسال JSON إلى الخادم، وهذا مفيد عند التعامل مع أمثلة داخلية. مع ذلك، لا تلصق أسرارا أو tokens أو بيانات شخصية في أي صفحة عامة إذا لم تكن متأكدا من بيئة العمل. قبل مشاركة JSON، احذف كلمات المرور، مفاتيح API، عناوين البريد والمعلومات الحساسة. التنسيق لا يخفي البيانات؛ هو فقط يغير ترتيب العرض والمسافات.
نصائح لتصحيح الأخطاء
إذا ظهرت رسالة خطأ، افحص آخر فاصلة قبل القوس، علامات الاقتباس، والأقواس غير المغلقة. ابدأ بتنسيق جزء صغير من JSON ثم أضف بقية الحقول تدريجيا إذا كان الملف كبيرا. تذكر أن الأرقام الكبيرة جدا قد تفقد دقتها عند التعامل معها كأرقام JavaScript، لذلك يفضل تمثيل المعرفات الطويلة كسلاسل نصية إذا كانت الدقة مهمة. ولملفات ضخمة جدا، استخدم أداة متخصصة قادرة على المعالجة التدريجية.
مثال تطبيقي
إذا وصلك رد API في سطر واحد، الصقه ثم اختر مسافتين للقراءة السريعة أو أربع مسافات للتوثيق. بعد التنسيق، افحص أسماء الحقول وأنواع القيم: هل الرقم مكتوب كرقم أم كنص؟ هل null مقصود أم حقل مفقود؟ هذه الأسئلة تكشف أخطاء تكامل كثيرة. وإذا فشل التحقق، انسخ رسالة الخطأ مع جزء صغير من JSON بدلا من إرسال الملف كله.
التحقق والتنسيق
تستخدم أداة JSON Formatter دالة `JSON.parse` للتحقق من صحة النص. عند الضغط على تنسيق، تحاول قراءة JSON ثم تعيد إخراجه بواسطة `JSON.stringify` مع مسافة بادئة تختارها: مسافتان، أربع مسافات، أو tab. إذا كان النص صالحا تعرض رسالة نجاح وتضع النسخة المنسقة في مربع الإخراج. وإذا كان غير صالح، تعرض رسالة الخطأ مع السبب القادم من المتصفح، مثل فاصلة زائدة أو علامة اقتباس ناقصة أو قيمة غير مسموحة.
زر التحقق يختلف عن زر التنسيق: هو يتأكد من صلاحية JSON فقط ولا يملأ الإخراج إذا كان كل شيء صحيحا. هذا مفيد عندما تريد التأكد من payload قبل إرساله إلى API. تذكر أن JSON يتطلب مفاتيح نصية داخل علامات اقتباس مزدوجة، ولا يقبل التعليقات أو الفواصل النهائية مثل بعض صيغ JavaScript. كما أن الأرقام والقيم المنطقية وnull لها قواعد محددة. لا تلصق أسرارا أو مفاتيح إنتاجية في أي أداة عامة إذا لم تكن متأكدا من بيئة التشغيل، رغم أن هذه الصفحة تنفذ العمل في المتصفح.
التعليقات