نحوه ایجاد فایل JSON در نوت‌پد (Notepad)

JSON یک متن ساده با قواعد سخت‌گیرانه است. نوت‌پد به‌خوبی از پس نوشتن آن برمی‌آید. نکته‌ای که اکثر افراد در آن اشتباه می‌کنند، سینتکس (نحو) است، نه ابزار کار. اگر ساختار را درست رعایت کنید، ذخیره کردن فایل ساده‌ترین بخش کار است.

فایل JSON چیست؟

JSON مخفف JavaScript Object Notation است. این فرمت داده‌ها را به‌صورت جفت‌های کلید-مقدار (key-value) درون آکولاد ذخیره می‌کند و از اشیاء و آرایه‌های تو در تو پشتیبانی می‌کند. برنامه‌ها، APIها و فایل‌های تنظیمات از آن استفاده می‌کنند زیرا سبک است و تقریباً تمام زبان‌های برنامه‌نویسی اصلی می‌توانند آن را بخوانند.

یک فایل JSON پایه به این شکل است:

{

  "name": "John",

  "age": 28,

  "isActive": true,

  "skills": ["writing", "editing"]

}

راهنمای گام‌به‌گام: ایجاد فایل JSON در نوت‌پد

گام ۱: باز کردن نوت‌پد

نوت‌پد را روی کامپیوتر خود باز کنید یا از یک نوت‌پد آنلاین رایگان در هر مرورگری استفاده کنید.

گام ۲: شروع با آکولاد باز

هر فایل JSON با { برای یک شیء یا [ برای یک آرایه شروع می‌شود. اکثر فایل‌ها با یک شیء شروع می‌شوند.

گام ۳: افزودن کلیدها و مقادیر

هر کلید را داخل گیومه (دابل کوتیشن) بنویسید، سپس یک کولون و بعد از آن مقدار را قرار دهید. هر جفت را با یک ویرگول از هم جدا کنید.

{

  "title": "Sample File",

  "version": 1

}

گام ۴: بستن صحیح فایل

هر آکولاد یا براکت باز را با یک بسته‌ی متناظر ببندید. آخرین جفت کلید-مقدار در یک شیء یا آرایه نباید با ویرگول تمام شود.

گام ۵: ذخیره با پسوند .json

به منوی File بروید و Save As را انتخاب کنید. در منوی کشویی "Save as type" گزینه All Files را انتخاب کنید. نام فایل را با پسوند .json وارد کنید، برای مثال data.json. اگر این منو را تغییر ندهید، فایل شما به‌صورت .txt ذخیره می‌شود و به‌عنوان یک فایل JSON قابل خواندن نخواهد بود.

گام ۶: اعتبارسنجی پیش از استفاده

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

قواعد سینتکس JSON که باید به یاد داشته باشید

• فقط دابل کوتیشن. کلیدها و مقادیر متنی باید داخل دابل کوتیشن قرار گیرند، نه کوتیشن تکی.

• بدون ویرگول اضافی. هیچ‌چیزی نباید بعد از آخرین آیتم در یک شیء یا آرایه بیاید.

• بدون کامنت. JSON استاندارد از کامنت‌های // یا /* */ درون فایل پشتیبانی نمی‌کند.

• بولین‌ها با حروف کوچک. از true و false استفاده کنید، نه True یا FALSE.

• اعداد نیازی به کوتیشن ندارند. بنویسید 28، نه "28"، مگر اینکه مقدار مورد نظر حتماً باید به‌صورت متن باشد.

خطاهای رایج و نحوه پیشگیری از آن‌ها

مشکل: فراموش کردن ویرگول بین جفت‌های کلید-مقدار. راه حل: هر جفت به جز آخری، باید بعد از خود یک ویرگول داشته باشد.

مشکل: عدم تطابق براکت‌ها یا آکولادها. راه حل: جفت‌های {} و [] خود را بشمارید. یک اعتبارسنج (validator) دقیقاً خطی که در آن عدم تطابق وجود دارد را به شما نشان می‌دهد.

مشکل: استفاده از کوتیشن‌های فرار نشده (Unescaped) داخل متن. راه حل: کوتیشن‌های داخلی را با بک‌اسلش خنثی کنید، مثلاً "او گفت \"سلام\"".

مشکل: کلیدی که داخل کوتیشن نیست. راه حل: هر کلید باید داخل دابل کوتیشن باشد، حتی کلیدهای ساده‌ای مثل id یا name.

نتیجه‌گیری

یک فایل JSON صرفاً متنی است که از یک فرمت سخت‌گیرانه پیروی می‌کند. کلیدها و مقادیر خود را با دابل کوتیشن بنویسید، براکت‌ها را جفت کنید، از گذاشتن ویرگول اضافه در انتها خودداری کنید و آن را با پسوند .json ذخیره نمایید. قبل از استفاده، یک بار آن را از طریق یک اعتبارسنج چک کنید تا کارتان تمام شود.