איך ליצור קובץ JSON ב-Notepad

JSON הוא טקסט פשוט עם חוקים נוקשים. פנקס הרשימות (Notepad) יכול לכתוב אותו בקלות. החלק שאנשים טועים בו הוא התחביר, לא הכלי. אם תדאגו למבנה הנכון, שמירת הקובץ תהיה החלק הקל ביותר.

מהו קובץ JSON?

JSON מייצג JavaScript Object Notation. הוא מאחסן נתונים כזוגות של מפתח-ערך בתוך סוגריים מסולסלים, עם תמיכה באובייקטים ומערכים מקוננים. אפליקציות, ממשקי API וקבצי הגדרות משתמשים בו מכיוון שהוא קל משקל וכל שפת תכנות מרכזית יכולה לקרוא אותו.

קובץ JSON בסיסי נראה כך:

{

  "name": "John",

  "age": 28,

  "isActive": true,

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

}

צעד אחר צעד: יצירת קובץ JSON ב-Notepad

שלב 1: פתחו את Notepad

פתחו את פנקס הרשימות במחשב שלכם, או השתמשו ב- עורך טקסט מקוון מכל דפדפן.

שלב 2: התחילו עם סוגר פותח

כל קובץ JSON מתחיל ב-{ עבור אובייקט או ב-[ עבור מערך. רוב הקבצים מתחילים עם אובייקט.

שלב 3: הוסיפו את המפתחות והערכים שלכם

כתבו כל מפתח במירכאות כפולות, אחריו נקודתיים, ולאחר מכן הערך. הפרידו כל זוג באמצעות פסיק.

{

  "title": "Sample File",

  "version": 1

}

שלב 4: סגרו את הקובץ כראוי

התאימו כל סוגר פותח לסוגר סוגר מתאים. הזוג האחרון של מפתח-ערך בתוך אובייקט או מערך לא מקבל פסיק בסוף.

שלב 5: שמרו עם סיומת .json

עברו אל File (קובץ), ולאחר מכן Save As (שמור בשם). בחרו באפשרות All Files בתפריט הנפתח "Save as type". תנו לקובץ שם עם סיומת .json, לדוגמה: data.json. שמירה מבלי לשנות תפריט זה תשאיר אתכם עם קובץ .txt שלא ייקרא כ-JSON.

שלב 6: אמת את הקובץ לפני השימוש

הדביקו את הקובץ ב- עורך JSON כדי לוודא שהוא תקין לפני השימוש בו בסקריפט או באפליקציה. בדיקה מהירה כאן תחסוך לכם ניפוי שגיאות מאוחר יותר.

חוקי תחביר JSON שכדאי לזכור

• מירכאות כפולות בלבד. מפתחות וערכי טקסט צריכים מירכאות כפולות, לא מירכאות בודדות.

• ללא פסיק בסוף. שום דבר לא יכול להופיע אחרי הפריט האחרון באובייקט או במערך.

• ללא הערות. פורמט JSON סטנדרטי לא תומך בהערות // או /* */ בתוך הקובץ.

• ערכים בוליאניים באותיות קטנות. השתמשו ב-true ו-false, לא ב-True או FALSE.

• מספרים לא זקוקים למירכאות. כתבו 28, לא "28", אלא אם הערך אמור להיות טקסט.

שגיאות נפוצות ואיך להימנע מהן

בעיה: חסר פסיק בין זוגות מפתח-ערך. פתרון: כל זוג מלבד האחרון חייב פסיק אחריו.

בעיה: סוגריים לא תואמים. פתרון: ספרו את זוגות ה-{} וה-[]. כלי אימות יצביע על השורה המדויקת שבה אין התאמה.

בעיה: מירכאות לא מסומנות בתוך מחרוזת. פתרון: בצעו Escape למירכאות פנימיות באמצעות לוכסן אחורי, לדוגמה: "He said \"hello\"".

בעיה: מפתח ללא מירכאות. פתרון: כל מפתח חייב להיות עטוף במירכאות כפולות, אפילו מפתחות פשוטים כמו id או name.

סיכום

קובץ JSON הוא פשוט טקסט שעוקב אחר פורמט נוקשה. כתבו את המפתחות והערכים שלכם עם מירכאות כפולות, התאימו את הסוגריים, דלגו על הפסיק האחרון, ושמרו עם סיומת .json. העבירו את הקובץ דרך כלי אימות פעם אחת לפני השימוש, וזהו – אתם מוכנים.