كيفية استخدام مقارنة JSON
- الصق المستند الأصلي في حقل «الأصلي» (Original / left) والمستند المعدّل في حقل «المعدّل» (Modified / right).
- فعّل خيار «تجاهل ترتيب المصفوفات» (Ignore array order) إذا كان موضع العناصر في المصفوفة لا يهم في بياناتك.
- اضغط «مقارنة» لعرض الملخص وجدول الاختلافات وعرض الأسطر.
- نزّل الجدول عندما تحتاج إلى إرفاق التغييرات بتذكرة.
مزايا مقارنة JSON
- مقارنة دلالية — يُتجاهل ترتيب المفاتيح والمسافات البيضاء والتنسيق
- إدراج كل اختلاف مع مسار JSON ونوع التغيير والقيمة القديمة والقيمة الجديدة
- وضع اختياري «تجاهل ترتيب المصفوفات» (Ignore array order) للمصفوفات الشبيهة بالمجموعات
- عرض المقارنة سطراً بسطر للمستندين بعد تنسيقهما
- عدّادات ملخّصة للقيم المضافة والمحذوفة والمتغيرة
- تصدير جدول الاختلافات بصيغة CSV
مثال على مقارنة JSON
مقارنة نسختين من ملف إعدادات
الإدخال:
Left: {"version":"1.4.0","limits":{"rps":100}}
Right: {"limits":{"rps":150,"burst":200},"version":"1.5.0"}النتيجة:
$.version changed "1.4.0" → "1.5.0"
$.limits.rps changed 100 → 150
$.limits.burst added → 200الأسئلة الشائعة حول مقارنة JSON
ماذا تعني المقارنة «الدلالية»؟
يُحلَّل المستندان ويُقارنان كبيانات لا كنص. فلا يُحتسب ترتيب المفاتيح ولا المسافات البيضاء ولا المسافات البادئة اختلافات أبداً — بل القيم الفعلية فقط.
هل يمكنني تجاهل ترتيب عناصر المصفوفات؟
فعّل خيار «تجاهل ترتيب المصفوفات» (Ignore array order). عندها تُطابَق العناصر حسب محتواها، فتُعدّ ["a","b"] و["b","a"] متساويتين.
ماذا تعني أنواع التغيير؟
مضاف (added): المفتاح موجود في المستند المعدّل (right) فقط. محذوف (removed): موجود في المستند الأصلي (left) فقط. متغيّر (changed): موجود في كليهما لكن القيمة مختلفة. تغيّر النوع (type changed): تبدّل نوع القيمة، مثلاً من سلسلة نصية إلى كائن.
كيف يُبلَّغ عن الاختلافات؟
يُدرج كل اختلاف مع مسار JSON الخاص به والقيمة القديمة والجديدة، كما يُبرز عرضٌ سطراً بسطر للمستندين بعد تنسيقهما التغييرات بصرياً.
ملاحظات تقنية
يُحلَّل المدخلان ويُجتازان بالتوازي. تُقارَن الكائنات حسب المفتاح، والمصفوفات حسب الفهرس (أو حسب المحتوى القياسي عند تجاهل ترتيب المصفوفات)، والقيم الأولية حسب قيمتها. أما عرض الأسطر فينسّق المستندين بمفاتيح مرتبة ويطبّق خوارزمية مقارنة تعتمد على أطول تسلسل جزئي مشترك (LCS)، مع الرجوع إلى مقارنة تقريبية للمدخلات الضخمة جداً.