תיקון ומתקן JSON
JSON פגום
JSON מתוקן
פרטים טכניים
איך פועל תיקון JSON
מה תיקון JSON עושה
תיקון JSON לוקח טקסט שנראה כמו JSON אך נכשל בניתוח קפדני וכותב אותו מחדש כ-JSON תקין. הוא מסיר פסיקים מיותרים, ממיר מחרוזות בגרשיים בודדים למרכאות כפולות, מוסיף מרכאות למפתחות אובייקט ללא מרכאות, מסיר הערות מסוג // ו-/* */, ממפה את None, True ו-False של Python ל-null, true ו-false, מחליף undefined ו-NaN, סוגר סוגריים וסוגריים מסולסלים שנקטעו, מסיר גדרות קוד של markdown וטקסט חופשי סביב, וממזג NDJSON או אובייקטים משורשרים למערך אחד. מספרים מועתקים כפי שהם, ולכן מספרים שלמים גדולים וערכים כמו 1.0 אינם משתנים. הכול רץ מקומית בדפדפן שלכם.
מקרי שימוש נפוצים
השימוש הנפוץ ביותר הוא תיקון JSON שנוצר על ידי LLM כגון ChatGPT, Claude או Gemini, שלעיתים קרובות עוטפים את הפלט בגדרות קוד, מוסיפים הסברים או נקטעים בגבול הטוקנים. הכלי עוזר גם עם קובצי תצורה שנערכו ידנית ומכילים הערות או פסיקים מיותרים, עם ליטרלים של אובייקטי JavaScript שהועתקו מקוד מקור, עם פלט repr או dict של Python שהודבק מלוגים, ועם תשובות API ושורות לוג קטועות. לאחר התיקון, שלחו את התוצאה למפרמט JSON כדי לייפות אותה, למאמת JSON Schema כדי לבדוק את המבנה, או לממירים מ-JSON ל-YAML או CSV.
וריאנטי קלט נתמכים
שלב התיקון מקבל JSON קפדני, קלט בסגנון JSON5 (הערות, גרשיים בודדים, מפתחות ללא מרכאות, פסיקים מיותרים), ליטרלים של אובייקטי JavaScript, ליטרלים של dict ו-list של Python, JSON עטוף בגדרות markdown, מסמכים קטועים שחסרים בהם סוגריים סוגרים, ו-JSON מופרד בשורות (NDJSON). הפלט הוא תמיד JSON קפדני לפי RFC 8259 עם מפתחות ומחרוזות במרכאות כפולות, מוכן ל-JSON.parse, ל-jq או לכל מנתח סטנדרטי.
מלכודות ומגבלות
התיקון הוא היוריסטי: כאשר הקלט נקטע באמצע מחרוזת או ערך, הכלי יכול רק לסגור את המבנה ולא לשחזר את הנתונים החסרים, ולכן כדאי לבדוק את הרשומות האחרונות. קלט דו-משמעי, כמו גרש בתוך מחרוזת בגרשיים בודדים או רצף שנראה כהערה בתוך כתובת URL, כדאי לסקור לאחר התיקון. אל תסתמכו על הפלט המתוקן להחלטות אבטחה; אמתו אותו מול סכמה. אם המקור נוצר על ידי הקוד שלכם, תקנו את המסדרן (למשל השתמשו ב-JSON.stringify או ב-json.dumps) במקום לתקן אותו בהמשך הדרך.