فرمتکننده JSON
یک رشته JSON را برای بررسی معتبر بودن، مشاهده نسخه مرتبشده و دریافت معیارهای ساختاری پایه وارد کنید.
نحوه استفاده از این فرمتکننده JSON
- JSON را در فیلد ورودی JSON جایگذاری کنید
رشته JSON خود را در فیلد ورودی JSON جایگذاری یا تایپ کنید.
- بررسی اعتبار
نتیجه وضعیت نشان میدهد که آیا ورودی یک JSON معتبر است یا خطای تجزیه را نمایش میدهد.
- خروجی فرمتشده را بخوانید
JSON معتبر با تورفتگی ۲-فاصلهای در بخش خروجی فرمتشده نمایش داده میشود.
- بررسی معیارهای ساختار
از «تعداد کل کلیدها» و «حداکثر عمق تو در تو» برای درک ساختار سند استفاده کنید.
نحوه عملکرد این ابزار قالببندی JSON
این ابزار از JSON.parse بومی مرورگر برای اعتبارسنجی ورودی و از JSON.stringify با فاصلهگذاری برای تولید خروجی خوانا استفاده میکند. همچنین ساختار تجزیهشده را برای شمارش کل کلیدها و اندازهگیری حداکثر عمق تودرتویی پیمایش میکند.
JSON.parse(input) → JSON.stringify(parsed, null, 2) ورودی: {"name":"test","value":42} ← قالببندی شده با تورفتگی ۲ فاصله، ۲ کلید، عمق ۱.
ورودی {"a":1,"b":[2,3],"c":{"d":4}} ← ۴ کلید، عمق ۲. شیء تودرتوی c یک سطح به عمق اضافه میکند.
ورودی نامعتبر {"key": undefined} در اعتبارسنجی رد میشود — JSON فاقد undefined است؛ از null استفاده کنید یا کلید را حذف کنید.
- ✓ ورودی باید JSON معتبر باشد (نه اشیاء جاوااسکریپت یا کاماهای انتهایی).
- ✓ ورودیهای حجیم ممکن است بر عملکرد مرورگر تأثیر بگذارند.
- این ابزار کاملاً در مرورگر شما اجرا میشود. هیچ دادهای به هیچ سروری ارسال نمیشود.
درک اعتبارسنجی JSON
JSON (JavaScript Object Notation) یک زیرمجموعه دقیق از نحو لیترال جاوااسکریپت است. JSON معتبر به کلیدها و مقادیر رشتهای با کوتیشن دوتایی، نبود کامای اضافی در انتها، نبود کامنت و نبود کوتیشن تکی نیاز دارد. تجزیهگر رشته را کاراکتر به کاراکتر میخواند و یک درخت تجزیه میسازد؛ هرگونه خطای نحوی — مانند کامای فراموششده، کوتیشن بدون کاراکتر گریز یا عدد نامعتبر — باعث شکست اعتبارسنجی با پیام خطا و موقعیت مشخص میشود. شناخت اشتباهات رایج کمک میکند: کاماهای اضافی بعد از آخرین عنصر آرایه یا ویژگی شیء نامعتبر هستند، همانطور که کامنتهای سبک جاوااسکریپت (// یا /* */) غیرمجازند. مقادیر عددی نباید صفر پیشرو داشته باشند (به جز خود عدد ۰) و رشتهها باید از توالیهای گریز معتبر استفاده کنند.
موارد استفاده کاربردی فرمتبندی JSON برای توسعهدهندگان
توسعهدهندگان هنگام عیبیابی پاسخهای API، بررسی فایلهای پیکربندی و آمادهسازی دادهها برای مستندات از فرمتکنندههای JSON استفاده میکنند. JSON فشردهشده در APIهای عملیاتی به سختی خوانده میشود؛ مرتبسازی (Pretty-printing) ساختار را نمایان کرده و شناسایی فیلدهای نامعتبر یا غیرمنتظره را آسانتر میکند. معیارهای ساختاری مانند تعداد کلیدها و عمق تودرتویی به ارزیابی پیچیدگی و شناسایی بارهای دادهای بیش از حد تودرتو که ممکن است باعث افت عملکرد شوند، کمک میکند. هنگام نوشتن تستها، JSON فرمتشده برای مقایسه و بازبینی در کنترل نسخه مناسبتر است. اعتبارسنج نیز خطاهای نحوی را پیش از ارسال درخواست یا ثبت فایلهای پیکربندی سریعاً شناسایی کرده و در زمان عیبیابی صرفهجویی میکند.
سوالات متداول
آیا این ابزار از JSON5 یا JSONC پشتیبانی میکند؟
خیر. فقط JSON استاندارد (RFC 8259) پشتیبانی میشود. کامنتها و کاماهای انتهایی باعث خطای اعتبارسنجی میشوند.
آیا محدودیت حجم وجود دارد؟
محدودیت قطعی وجود ندارد، اما رشتههای JSON بسیار بزرگ ممکن است سرعت مرورگر را کاهش دهند.