فرمت‌کننده JSON

یک رشته JSON را برای بررسی معتبر بودن، مشاهده نسخه مرتب‌شده و دریافت معیارهای ساختاری پایه وارد کنید.

رشته JSON خود را اینجا بچسبانید.

خروجی قالب‌بندی شده

{}

وضعیتJSON معتبر
تعداد کل کلیدها۰
حداکثر عمق تودرتویی۰
فرمول فرمول مفروضات 2 مثال مثال منابع 2 آخرین به‌روزرسانی ۲۰ اسفند ۱۴۰۴
ورودی‌ها در مرورگر باقی می‌مانند، مگر اینکه در آینده قابلیتی خلاف آن را صراحتاً اعلام کند. از این به عنوان یک تخمین استفاده کنید و تصمیمات مهم را با یک متخصص واجد شرایط تأیید نمایید.

نحوه استفاده از این فرمت‌کننده JSON

  1. JSON را در فیلد ورودی JSON جای‌گذاری کنید

    رشته JSON خود را در فیلد ورودی JSON جای‌گذاری یا تایپ کنید.

  2. بررسی اعتبار

    نتیجه وضعیت نشان می‌دهد که آیا ورودی یک JSON معتبر است یا خطای تجزیه را نمایش می‌دهد.

  3. خروجی فرمت‌شده را بخوانید

    JSON معتبر با تورفتگی ۲-فاصله‌ای در بخش خروجی فرمت‌شده نمایش داده می‌شود.

  4. بررسی معیارهای ساختار

    از «تعداد کل کلیدها» و «حداکثر عمق تو در تو» برای درک ساختار سند استفاده کنید.

روش‌شناسی

نحوه عملکرد این ابزار قالب‌بندی JSON

این ابزار از JSON.parse بومی مرورگر برای اعتبارسنجی ورودی و از JSON.stringify با فاصله‌گذاری برای تولید خروجی خوانا استفاده می‌کند. همچنین ساختار تجزیه‌شده را برای شمارش کل کلیدها و اندازه‌گیری حداکثر عمق تودرتویی پیمایش می‌کند.

فرمول
JSON.parse(input) → JSON.stringify(parsed, null, 2)
تجزیه بررسی می‌کند که رشته یک JSON با ساختار صحیح باشد.
تبدیل به رشته تبدیل مجدد به یک رشته با تورفتگی
مثال

ورودی: {"name":"test","value":42} ← قالب‌بندی شده با تورفتگی ۲ فاصله، ۲ کلید، عمق ۱.

ورودی {"a":1,"b":[2,3],"c":{"d":4}} ← ۴ کلید، عمق ۲. شیء تودرتوی c یک سطح به عمق اضافه می‌کند.

ورودی نامعتبر {"key": undefined} در اعتبارسنجی رد می‌شود — JSON فاقد undefined است؛ از null استفاده کنید یا کلید را حذف کنید.

مفروضات
  • ✓ ورودی باید JSON معتبر باشد (نه اشیاء جاوااسکریپت یا کاماهای انتهایی).
  • ✓ ورودی‌های حجیم ممکن است بر عملکرد مرورگر تأثیر بگذارند.
یادداشت‌ها
  • این ابزار کاملاً در مرورگر شما اجرا می‌شود. هیچ داده‌ای به هیچ سروری ارسال نمی‌شود.
منابع
  1. RFC 8259 — The JavaScript Object Notation (JSON) Data Interchange Format — نحو و مدل داده JSON
  2. MDN — JSON.parse() — رفتار تجزیه JSON در مرورگر

درک اعتبارسنجی JSON

JSON (JavaScript Object Notation) از نحو لیترال اشیاء JavaScript مشتق شده است، اما یک قالب داده مجزا و سخت‌گیرانه‌تر است. JSON معتبر به کلیدها و مقادیر رشته‌ای با علامت نقل‌قول دوتایی، بدون کامای انتهایی، بدون کامنت و بدون نقل‌قول تکی نیاز دارد. تجزیه‌کننده رشته را کاراکتر به کاراکتر می‌خواند و یک درخت تجزیه می‌سازد؛ هرگونه خطای نحوی — مانند کامای جا افتاده، نقل‌قول فرار داده نشده یا عدد نامعتبر — باعث شکست اعتبارسنجی با پیام خطا و موقعیت مشخص می‌شود. شناخت اشتباهات رایج کمک می‌کند: کاماهای انتهایی بعد از آخرین عنصر آرایه یا ویژگی شیء نامعتبر هستند، همان‌طور که کامنت‌های سبک JavaScript (// یا /* */) غیرمجازند. مقادیر عددی نباید صفر پیشرو داشته باشند (به جز خود عدد ۰) و رشته‌ها باید از توالی‌های فرار معتبر استفاده کنند.

موارد استفاده کاربردی فرمت‌بندی JSON برای توسعه‌دهندگان

توسعه‌دهندگان هنگام عیب‌یابی پاسخ‌های API، بررسی فایل‌های پیکربندی و آماده‌سازی داده‌ها برای مستندات از فرمت‌کننده‌های JSON استفاده می‌کنند. JSON فشرده‌شده در APIهای عملیاتی به سختی خوانده می‌شود؛ مرتب‌سازی (Pretty-printing) ساختار را نمایان کرده و شناسایی فیلدهای نامعتبر یا غیرمنتظره را آسان‌تر می‌کند. معیارهای ساختاری مانند تعداد کلیدها و عمق تودرتویی به ارزیابی پیچیدگی و شناسایی بارهای داده‌ای بیش از حد تودرتو که ممکن است باعث افت عملکرد شوند، کمک می‌کند. هنگام نوشتن تست‌ها، JSON فرمت‌شده برای مقایسه و بازبینی در کنترل نسخه مناسب‌تر است. اعتبارسنج نیز خطاهای نحوی را پیش از ارسال درخواست یا ثبت فایل‌های پیکربندی سریعاً شناسایی کرده و در زمان عیب‌یابی صرفه‌جویی می‌کند.

سوالات متداول

آیا این ابزار از JSON5 یا JSONC پشتیبانی می‌کند؟

خیر. فقط JSON استاندارد (RFC 8259) پشتیبانی می‌شود. کامنت‌ها و کاماهای انتهایی باعث خطای اعتبارسنجی می‌شوند.

آیا محدودیت حجم وجود دارد؟

محدودیت قطعی وجود ندارد، اما رشته‌های JSON بسیار بزرگ ممکن است سرعت مرورگر را کاهش دهند.

نوشته شده توسط یان کرنک مؤسس و توسعه‌دهنده اصلی
بازبینی شده توسط بررسی متدولوژی DigitSum تأیید فرمول و تضمین کیفیت
آخرین به‌روزرسانی ۲۰ اسفند ۱۴۰۴

از این به عنوان یک تخمین استفاده کنید و تصمیمات مهم را با یک متخصص واجد شرایط تأیید نمایید.

ورودی‌ها در مرورگر باقی می‌مانند، مگر اینکه در آینده قابلیتی خلاف آن را صراحتاً اعلام کند.