قالب بندی JSON

درک قالب بندی، کوچک سازی و تایید JSON

JSON امروز رایج ترین روش انتقال داده بین سرورها، API ها و اپ هاست. هر وقت از API داده می آورید، فایل پیکربندی ویرایش می کنید یا با خروجی پایگاه داده کار می کنید، احتمالا JSON می بینید. مشکل این است که JSON خام به ندرت خواناست: API ها آن را به صورت یک خط واحد بزرگ برمی گردانند، و یک کاراکتر در جای غلط می تواند کل یکپارچگی را بشکند. به همین دلیل قالب بند JSON ساخته شده است — بلوک های ناخوانا را به متنی تمیز و منظم تبدیل می کند که واقعا می توانید با آن کار کنید.

این ابزار سه حالت به شما می دهد. قالب بندی / زیبا سازی JSON فشرده یا نامرتب را می گیرد و آن را با تورفتگی دو فاصله دوباره چاپ می کند، هر خط یک جفت کلید-مقدار، تا آبجکت ها و آرایه های تو در تو به صورت بصری باز شوند و بتوانید ساختار را با یک نگاه دنبال کنید. در حالی که کوچک سازی برعکس آن را انجام می دهد: هر فاصله و شکست خط غیر ضروری را حذف می کند، کوچک ترین رشته ممکن را می سازد. JSON کوچک شده وقتی بهترین است که اندازه بار مهم باشد — فرستادن داده از طریق API یا گنجاندن آن در پارامتر لینک یا ذخیره در فیلدی با اندازه محدود. و تایید فقط بررسی می کند آیا JSON از نظر ساختاری درست است، بدون تغییر چیزی، تایید روشنی به شما می دهد که JSON درست است یا خطای دقیق.

خطاهای رایج JSON که تجزیه را می شکنند

JSON از JavaScript سخت گیرتر است، و بیشتر شکست های تایید از گروه کوچکی از خطاها می آیند. کاماهای اضافی — کاما پس از آخرین عنصر در آبجکت یا آرایه — اولین علت هستند. علامت های نقل قول تکی به جای دوتایی دور رشته ها و کلیدها علت دیگری هستند؛ JSON همیشه علامت های نقل قول دوتایی را می طلبد. کلیدهای بدون نقل قول و نظرها (که JSON هرگز پشتیبانی نمی کند) و کاراکترهای کنترلی داخل رشته ها هم تجزیه را می شکنند. و وقتی ابزار خطایی مثل «Unexpected token } in JSON at position 42» را گزارش می دهد دقیقا به همان کاراکتر نگاه کنید: خطای واقعی معمولا بلافاصله پیش از آن است — کامای گمشده یا براکت اضافی یا رشته ناتمام.

نکات متخصص برای کار با JSON

پاسخ API را پیش از نوشتن کد در برابر آن همیشه تایید کنید — بسیاری از «خطاها» منطق خراب نیستند بلکه داده خراب هستند. هنگام اشکال زدایی اول زیبا کنید تا ساختار دیده شود، داده را درست کنید، سپس پیش از فرستادن دوباره کوچک کنید. مراقب کلیدهای تکراری باشید: JSON از نظر فنی آنها را اجازه می دهد، اما بیشتر تجزیه کننده ها فقط آخری را نگه می دارند، بی سر و صدا داده را حذف می کنند. و حریم خصوصی را در ذهن نگه دارید: بر خلاف بسیاری از قالب بندهای آنلاین، این ابزار کاملا در مرورگر شما کار می کند، پس کلیدهای API، توکن ها و داده شخصی در JSON هرگز جایی بارگذاری نمی شوند.