منسّق JSON

نسّق JSON تنسيقًا مقروءًا واحصل على سطر وعمود دقيقين حين يكون غير صالح، بدل شكوى مبهمة.

تتم المعالجة على جهازك — بلا رفع

termiva json --pretty
0 حرفًا
الإزاحة
المفاتيح
0 حرفًا
صالح أسطر لا شيء مرفوع

كيف تنسّق JSON

  1. الصق JSON، أو اختر ملفًّا.
  2. اختر إزاحة، وافرز المفاتيح إن كان ذلك يساعدك على القراءة.
  3. انسخ الناتج المنسَّق.

كيف يعمل

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

ورسائل الخطأ هي سبب استعمال هذه بدل محرّر نصوص. فالمتصفّح يبلّغ عن مشكلة صياغية بإزاحة محارف — «الموضع 4182» — وهي غير قابلة للاستعمال في ملف كبير. وتلك الإزاحة تُحوَّل هنا إلى سطر وعمود، مع اقتباس السطر المخالف، فيستغرق الإصلاح ثوانيَ بدل بحث.

وفرز المفاتيح أبجديًا موجود للمقارنة. فاستجابتان لواجهة برمجية تحويان البيانات نفسها بترتيب مفاتيح مختلف تبدوان مختلفتين كليًا في المقارنة؛ افرز الاثنتين فلا يبقى إلا الفروق الحقيقية.

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

مثال عملي

واجهة برمجية تعيد سطرًا طويلًا واحدًا من JSON وشيء فيه خاطئ. اضغط حمّل عيّنة لترى الشكل المنسَّق لحمولة طلب نموذجية.

والآن اكسرها عمدًا: احذف قوسًا معقوفًا مغلقًا وانظر إلى الرسالة. بدل «نهاية غير متوقّعة لمدخل JSON» تحصل على السطر والعمود، والسطر نفسه مقتبسًا لك. وفي ملف من 4000 سطر ذلك هو الفرق بين إصلاح وبين بعد ظهر كامل.

وأشيع الأخطاء الحقيقية بالترتيب: فاصلة لاحقة بعد آخر عنصر في مصفوفة أو كائن؛ وعلامات اقتباس مفردة بدل المزدوجة؛ وسطر جديد غير مهرَّب داخل سلسلة. والثلاثة قانونية في JavaScript وغير قانونية في JSON، ولهذا تنجو من المراجعة وتخفق عند التحليل.

وخيار الفرز يستحق مكانه عند مقارنة نسختين من ملف إعداد. افرز الاثنتين، ثم مرّرهما عبر أداة مقارنة النصوص — فما يبقى هو التغيير الفعلي لا مئة سطر من إعادة الترتيب.

وللاتجاه الآخر ونزع الفراغ من جديد، المصغّر يعرض كم بايتًا كان التنسيق يكلّف.

أسئلة

هل ينسّق JSON ويدقّقه؟

الاثنان. فتنسيقه بإزاحة حقيقية هو أسرع طريقة لتدقيقه أيضًا: فإن كانت البنية خاطئة توقّفت الأداة وسمّت السطر.

كيف أجد خطأ التحليل؟

تعطي الرسالة سطرًا وعمودًا وتقتبس النص المخالف، بدل إزاحة المحارف الخام التي يبلّغ عنها المتصفّح. وذلك يكفي عادةً لرصد المشكلة بالعين.

هل يُرفع JSON عندي؟

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

كيف أجد الخطأ في ملف كبير؟

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

ما أشيع أخطاء JSON؟

فاصلة لاحقة بعد آخر عنصر، وعلامات اقتباس مفردة بدل المزدوجة، وسطر جديد غير مهرَّب داخل سلسلة. والثلاثة JavaScript صالحة وJSON غير صالح.

هل يغيّر التنسيق بياناتي؟

لا. لا يتغيّر إلا الفراغ — وترتيب المفاتيح إن طلبت الفرز. أما القيم فلا تُمسّ.

لماذا أفرز المفاتيح؟

لمقارنة ملفّين. فالبيانات المتطابقة بترتيب مفاتيح مختلف تنتج مقارنة مليئة بالضجيج؛ وفرز الاثنين يُبقي الفروق الحقيقية وحدها.

هل يدعم JSON بتعليقات؟

لا. فالتعليقات ليست جزءًا من JSON، والملف الذي يحويها لن يُحلَّل. انزعها أولًا إن كنت تعمل بصيغة إعداد تسمح بها.

مسافتان أم أربع؟

المسافتان أشيع عرف وتنتج ملفًّا أصغر. والأربع أيسر متابعةً حين يعمق التداخل. ولا أثر لأيّهما على البيانات.

هل هناك حدّ للحجم؟

لا حدّ ثابت. التنسيق سريع، وإن كان ملف من عدة ميغابايتات سيجعل صندوق النص نفسه بطيء التمرير.

هل منسّق JSON مجاني على الإنترنت؟

نعم — مجاني، بلا حساب، وبلا حد يومي، وبلا علامة مائية. يعمل في متصفّحك عبر الإنترنت، ولأن المعالجة تجري على جهازك فإنه يستمر في العمل دون اتصال بعد تحميل الصفحة.

للقراءة