إصلاح 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 المنسوخة من الشيفرة المصدرية، ومخرجات Python repr أو dict الملصقة من السجلات، واستجابات API المقتطعة وأسطر السجل. بعد الإصلاح، أرسل النتيجة إلى مُنسِّق JSON لتجميلها، أو إلى مدقق JSON Schema للتحقق من بنيتها، أو إلى محوّلات JSON إلى YAML أو CSV.
متغيرات الإدخال المدعومة
تقبل خطوة الإصلاح JSON الصارم، ومدخلات بنمط JSON5 (تعليقات، علامات اقتباس مفردة، مفاتيح بلا اقتباس، فواصل زائدة)، وكائنات JavaScript، وقوائم وقواميس Python، وJSON المغلّف بأسوار markdown، والمستندات المقتطعة التي تنقصها أقواس الإغلاق، وJSON المفصول بأسطر جديدة (NDJSON). المخرجات دائمًا JSON صارم وفق RFC 8259 بمفاتيح وسلاسل بعلامات اقتباس مزدوجة، جاهز لـ JSON.parse أو jq أو أي محلل قياسي.
المزالق الشائعة والحالات الطرفية
الإصلاح قائم على استدلال: عندما يُقطع الإدخال في منتصف سلسلة أو قيمة، تستطيع الأداة إغلاق البنية فقط ولا يمكنها استرجاع البيانات المفقودة، لذا تحقق من الإدخالات الأخيرة. ينبغي مراجعة الإدخال الملتبس بعد الإصلاح، مثل فاصلة عليا داخل سلسلة بعلامات اقتباس مفردة أو تسلسل يشبه التعليق داخل URL. لا تعتمد على المخرجات المُصلَحة في القرارات الأمنية؛ تحقق منها وفق مخطط. وإذا كان المصدر مولَّدًا من شيفرتك، فأصلح المُسلسِل (مثل استخدام JSON.stringify أو json.dumps) بدل الإصلاح لاحقًا.