تعمیر و اصلاح JSON
JSON خراب
JSON تعمیرشده
جزئیات فنی
تعمیر JSON چگونه کار میکند
این ابزار چه کاری انجام میدهد
تعمیر JSON متنی را که شبیه JSON است اما در تجزیه سختگیرانه رد میشود میگیرد و آن را به JSON معتبر بازنویسی میکند. این ابزار ویرگولهای انتهایی را حذف میکند، رشتههای دارای نقلقول تکی را به نقلقول دوتایی تبدیل میکند، کلیدهای بدون نقلقول اشیا را داخل نقلقول میگذارد، توضیحات // و /* */ را پاک میکند، None و True و False پایتون را به null و true و false نگاشت میکند، undefined و NaN را جایگزین میکند، کروشهها و آکولادهای بریدهشده را میبندد، حصارهای کد markdown و متن اطراف را حذف میکند، و NDJSON یا اشیای پشتسرهم را در یک آرایه ادغام میکند. اعداد عینا کپی میشوند، بنابراین اعداد صحیح بزرگ و مقادیری مانند 1.0 تغییر نمیکنند. همهچیز بهصورت محلی در مرورگر اجرا میشود.
موارد استفادهٔ رایج برای توسعهدهندگان
رایجترین کاربرد، اصلاح JSON تولیدشده توسط LLMهایی مانند ChatGPT، Claude یا Gemini است که اغلب خروجی را در حصار کد میپیچند، توضیح اضافه میکنند یا بهدلیل محدودیت توکن بریده میشوند. همچنین برای فایلهای پیکربندی ویرایششده دستی که توضیحات یا ویرگول انتهایی دارند، literalهای شیء جاوااسکریپت کپیشده از کد منبع، خروجی repr یا dict پایتون که از لاگها چسبانده شده، و پاسخهای API و خطوط لاگ بریدهشده مفید است. پس از تعمیر، نتیجه را برای زیباسازی به قالببندی JSON، برای بررسی ساختار به JSON Schema Validator یا به مبدلهای JSON به YAML یا CSV بفرستید.
انواع ورودی پشتیبانیشده
مرحله تعمیر JSON سختگیرانه، ورودی به سبک JSON5 (توضیحات، نقلقول تکی، کلیدهای بدون نقلقول، ویرگول انتهایی)، literalهای شیء جاوااسکریپت، literalهای dict و list پایتون، JSON پیچیدهشده در حصار markdown، اسناد بریدهشده فاقد کروشههای بسته، و JSON جداشده با خط جدید (NDJSON) را میپذیرد. خروجی همیشه JSON سختگیرانه RFC 8259 با کلیدها و رشتههای دارای نقلقول دوتایی است که برای JSON.parse، jq یا هر تجزیهگر استانداردی آماده است.
دامهای رایج و حالتهای لبهای
تعمیر بر پایه ابتکار (heuristic) است: وقتی ورودی در وسط یک رشته یا مقدار بریده شده باشد، ابزار فقط میتواند ساختار را ببندد و دادههای گمشده را بازیابی نمیکند، پس آخرین ورودیها را بررسی کنید. ورودی مبهم، مانند آپوستروف داخل رشتهای با نقلقول تکی یا دنبالهای شبیه توضیح داخل یک URL، باید پس از تعمیر بازبینی شود. برای تصمیمهای امنیتی به خروجی تعمیرشده تکیه نکنید؛ آن را با یک schema اعتبارسنجی کنید. اگر منبع توسط کد خودتان تولید میشود، بهجای تعمیر در مراحل بعد، serializer را درست کنید (مثلا از JSON.stringify یا json.dumps استفاده کنید).