كيف تتحقق من JSON بسرعة: خطوات عملية
2025-04-16
قبل دمج الإعدادات أو استيراد البيانات، تأكد من أن النص JSON صالح. هذا المقال يقارن الطرق الشائعة ويقترح سير عمل يومي.
التحقق النحوي مقابل التحقق البنيوي
التحقق النحوي يفحص الاقتباسات والأقواس والأنواع المسموح بها. JSON Schema يفحص الأسماء والأنواع والحقول المطلوبة بعد نجاح النحو.
المحللات المدمجة
JSON.parse في JavaScript و json.loads في Python وغيرها ممتازة للسكربتات، لكنك غالبًا تحتاج تحويل الموضع إلى رقم سطر أثناء التصحيح.
try {
const data = JSON.parse(raw);
} catch (e) {
console.error(e.message);
}فحوصات سطر الأوامر
الأمر jq ينسق الملف بنجاح عندما يكون JSON صحيحًا نحويًا، وعند الفشل يطبع خطأ parse واضحًا.
python -m json.tool مناسب جدًا لخطوط CI التي تتحقق من ملفات الإعداد.
التحقق عبر الإنترنت (للتصحيح اليومي)
الصق جسم الطلب أو مقطع السجل لتحصل على ملاحظات فورية. أداتنا تعمل محليًا في المتصفح دون رفع البيانات.
أخطاء شائعة مضللة
كائنات console ليست JSON، وJSON Lines يحتاج تحليل سطرًا بسطر، ووجود UTF-8 BOM قد يعطل أول مفتاح.
سير عمل مقترح لـ API
1) تحقق نحوًا. 2) افحص الحقول المتداخلة. 3) قارن بالمستندات أو Schema. 4) احفظ أمثلة ثابتة للفريق.