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

Acrafto Team المطورون
تم التحديث
في انتظار الإدخال. الصق JSON أعلاه أو أفلت ملف .json هنا.

الصق أي JSON في الحقل أعلاه، وستتولى أداة تنسيق JSON والتحقق منه (JSON Formatter & Validator) فحص تركيبه أثناء الكتابة. صلاحية التركيب لا تعني أن الحقول والقيم تطابق مخطط التطبيق. يُعرض الإدخال الصالح بتنسيق مقروء مع المسافة البادئة التي تختارها، أو يُضغط في سطر واحد. أما الإدخال غير الصالح فيحصل على رسالة خطأ دقيقة تتضمن رقم السطر والعمود ومقتطفًا مميزًا، وعلى إصلاح بنقرة واحدة في حالة الأخطاء الشائعة. يعمل كل شيء في متصفحك، فلا تغادر استجابات API وملفات الإعداد والبيانات المصدّرة جهازك.

ما الذي تفعله أداة تنسيق JSON هذه

  • تنسيق JSON وتجميله (Beautify) بمسافتين أو 4 مسافات أو علامات جدولة (Tab). يحتفظ الناتج بالترتيب الأصلي للمفاتيح ما لم تفعّل خيار ترتيب المفاتيح.
  • ضغط JSON (Minify) بحذف المسافات البيضاء الزائدة خارج السلاسل النصية. يوضح مؤشر الحجم أسفل النتيجة عدد البايتات التي وفّرتها.
  • التحقق من JSON مباشرة وفق RFC 8259، وهو معيار JSON الحالي. يتحول سطر الحالة إلى اللون الأخضر لحظة يصبح المستند صحيحًا.
  • إصلاح الأخطاء الشائعة تلقائيًا، ومنها الفواصل الزائدة وعلامات الاقتباس المفردة والمفاتيح غير المقتبسة والتعليقات وقيم Python مثل True وNone وNaN، والأرقام مثل .5 أو +1.
  • فتح الملفات بزر فتح ملف أو بسحب ملف .json وإفلاته في حقل الإدخال، ثم تنزيل النتيجة أو إعادتها إلى الإدخال لمعالجة أخرى.

لماذا تهم رسالة الخطأ أكثر من اللون الأحمر

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

أكثر الأخطاء التي نراها في المستندات الملصقة:

الإدخالالمشكلةJSON الصحيح
{'name': 'Ada'}علامات اقتباس مفردة{"name": "Ada"}
{name: "Ada"}مفتاح غير مقتبس{"name": "Ada"}
[1, 2, 3,]فاصلة زائدة[1, 2, 3]
{"a": 1 "b": 2}فاصلة مفقودة{"a": 1, "b": 2}
{"ok": True}قيمة من Python{"ok": true}
{"x": 007}صفر بادئ{"x": 7} أو {"x": "007"}
// commentتعليقغير مسموح به في JSON

يصلح زر أصلحه لي كل هذه الأخطاء باستثناء الفاصلة المفقودة والصفر البادئ. الإصلاح متحفظ عن قصد، فهو لا يخمّن أبدًا موضع الفاصلة المفقودة، لأن إدراجها في المكان الخطأ يغيّر معنى البيانات، وقد يُقصد بـ 007 الرقم 7 أو رمز ما. في هذه الحالات تحصل على الموضع الدقيق بدلًا من الإصلاح.

الأرقام الكبيرة وترتيب المفاتيح وأشياء أخرى تتلف عادة

تستخدم بعض مسارات تنسيق JSON استدعاء JSON.parse ثم JSON.stringify. وقد تغير هذه الطريقة كتابة الأرقام أو تفقد دقة عدد صحيح كبير. فمعرّف Twitter أو Snowflake مثل 1234567890123456789 يتجاوز أكبر عدد صحيح آمن في JavaScript، وهو 2^53−1، ويعود على شكل 1234567890123456800. وتتحول القيمة 1.0 إلى 1، و1e3 إلى 1000. أما أداة تنسيق JSON هذه فلا تحوّل الأرقام أبدًا إلى أعداد ذات فاصلة عائمة (floating point)، بل تنسخ كل قيمة حرفية كما كُتبت تمامًا، فيكون الناتج إعادة تنسيق أمينة للإدخال وليس إعادة تفسير له. وينطبق الأمر نفسه على تسلسلات الهروب داخل السلاسل النصية، فـ "\u00e9" تبقى "\u00e9" ولا تتحول إلى "é".

يُحفظ ترتيب المفاتيح أيضًا. تنص مواصفة JSON على أن أعضاء الكائن غير مرتبة، لكن ملفات الإعداد وبيانات الاختبار ومراجعات الكود تكون أسهل قراءة بكثير عندما يكون الترتيب ثابتًا. وإذا كنت تفضل صيغة موحدة، مثلًا لمقارنة استجابتين من API في أداة مقارنة النصوص، ففعّل ترتيب المفاتيح وسيعرض المستندان خصائصهما أبجديًا في كل مستوى من مستويات التداخل.

تنسيق JSON أم ضغط JSON: متى تستخدم كلًا منهما

JSON المنسق موجّه للبشر. استخدمه عندما تراجع استجابة API، أو تكتب ملف package.json أو tsconfig.json أو مستند OpenAPI، أو عندما تخزّن بيانات اختبار في مستودع يجب أن يعرض فيه كل فرق تغييرًا واحدًا في كل سطر. المسافتان هما العرف السائد في عالم JavaScript، والمسافات الأربع شائعة في مشاريع Python و.NET، أما علامات الجدولة فتتيح لكل قارئ اختيار العرض الذي يناسبه.

JSON المضغوط موجّه للآلات. حذف المسافات البيضاء الزائدة خارج السلاسل النصية قد يقلل حجم المستند. مقدار التوفير، وأثره بعد ضغط gzip، يعتمدان على البيانات نفسها. لا تُحذف المسافات داخل القيم النصية. ويعرض مؤشر الحجم أسفل النتيجة الفرق الدقيق لمستندك.

التعامل مع JSON في الطرفية والمحررات

للملفات التي تعالجها بشكل متكرر، تكون أداة سطر الأوامر أسرع من أي موقع ويب. يقوم jq . file.json بتنسيق الملف، وjq -c . file.json بضغطه، ويعمل python -m json.tool file.json في أي مكان يتوفر فيه Python. ويُنسّق Visual Studio Code ملفات JSON بالاختصار Shift+Alt+F، ويتحقق منها مقابل مخطط (schema) عند إضافة خاصية $schema. أما هذه الصفحة فهي للحالات الأخرى، مثل استجابة منسوخة من تبويب الشبكة (Network)، أو سطر من سجل، أو مقتطف إعدادات من ويكي، أو فحص سريع على جهاز لا يمكنك تثبيت أي شيء عليه.

أدوات ذات صلة على هذا الموقع: أداة ترميز وفك ترميز Base64 تفك ترميز جزء البيانات (payload) في رمز JWT، وهو JSON مرمّز بصيغة Base64url. ويحوّل محول وقت يونكس أرقامًا مثل createdAt إلى تواريخ إذا كان النظام المصدر يعرّفها كطوابع Unix، بينما يخبرك تحليل UUID بإصدار المعرّف وحقول الوقت المدعومة؛ UUID v4 لا يحمل تاريخ إنشاء. وتجد مزيدًا من الأدوات في قسم أدوات المطورين.

الأسئلة الشائعة

هل يُرفع JSON الخاص بي إلى خادم؟ لا. يجري التحليل والتنسيق والإصلاح بالكامل في متصفحك بلغة JavaScript. بعد تحميل الصفحة يمكنك قطع الاتصال بالشبكة وستواصل الأداة العمل. الأداة لا ترسل JSON المدخل إلى خادم Acrafto ولا تحفظه في التخزين المحلي.
لماذا يرفض المدقق التعليقات بينما يقبلها المحرر الذي أستخدمه؟ أزال مبتكر JSON، Douglas Crockford، التعليقات من الصيغة عن قصد لمنع استخدامها في توجيهات المحلل (parser directives). ملفات مثل tsconfig.json أو .vscode/settings.json هي من الناحية التقنية JSONC، وهي صيغة موسّعة تدعمها المحررات. أما المحللات الصارمة في واجهات API وقواعد البيانات ومعظم لغات البرمجة فترفضها. يحاول زر الإصلاح حذف التعليقات؛ تظل الأخطاء الأخرى معروضة إن وجدت. صلاحية التركيب لا تضمن قبول كل تطبيق للبيانات.
هل يمكنني تنسيق JSON Lines أو عدة كائنات دفعة واحدة؟ يحتوي مستند JSON على قيمة واحدة فقط. إذا ألصقت عدة كائنات تفصل بينها فواصل أو أسطر جديدة، يتوقف المدقق عند أول قيمة زائدة. ضعها بين قوسين مربعين لتصبح مصفوفة، ثم نسّقها. لا يفعل زر الإصلاح ذلك تلقائيًا لأنه لا يستطيع معرفة ما إذا كان الإدخال مقصودًا كمستند واحد.
ما الحد الأقصى للحجم؟ الحجم الممكن والسرعة يعتمدان على بنية المستند وذاكرة الجهاز وقدرته؛ لا يوجد وعد بزمن ثابت لعدد معين من الميغابايتات. يُعطَّل تلوين الصيغة (syntax highlighting) فوق 400 kB تقريبًا للحفاظ على سرعة استجابة الصفحة، لكن النسخ والتنزيل يبقيان متاحين.
هل يغيّر ترتيب المفاتيح البيانات؟ تغيير ترتيب مفاتيح كائن ذي أسماء فريدة لا يغيّر عادة قيمه، ولا يعيد هذا الخيار ترتيب المصفوفات. لكنه يغير بايتات النص، وبالتالي قد يغير التجزئة أو يبطل توقيعًا. ليس ترتيب المفاتيح تطبيعًا تشفيريًا معياريًا؛ راجع أيضًا المفاتيح المكررة، فقد تختلف طريقة تفسيرها بين المحللات.
كيف أهرّب JSON لتضمينه داخل سلسلة نصية؟ اضغطه أولًا، ثم هرّب كل شرطة مائلة عكسية وكل علامة اقتباس مزدوجة. توفر لغات كثيرة ذلك مباشرة، فالتعبير JSON.stringify(JSON.stringify(obj)) في JavaScript أو json.dumps(json.dumps(obj)) في Python ينتج سلسلة JSON تحتوي على نص JSON.

سأقدر إذا كنت تستطيع مشاركة هذه الصفحات مع الأصدقاء أو حفظها في الإشارات المرجعية أو الربط بها. شكراً! 🙏