ما الذي يقارنه مدقق الفروق بين JSON؟

يقارن مستندَي JSON بحسب محتواهما، لا طريقة كتابتهما. تُدرج كل قيمة أُضيفت أو حُذفت أو تغيّرت مع مسارها، وتُميَّز في كلا المحررين، لتتمكن من معرفة التغييرات التي طرأت على استجابة API أو ملف إعدادات أو تصدير بيانات بين إصدارين بنظرة سريعة.

كيفية الاستخدام

  1. الصق أو اكتب JSON الأصلي في المربع الأول، وJSON بعد التغيير في المربع الثاني.
  2. تظهر الفروق فورًا، مع إحصائها حسب النوع وعرضها بالترتيب.
  3. انقر على فرق للانتقال إليه في كلا المحررين، أو انقر على علامة في أحد المحررين للعثور على صفه في القائمة.
  4. افتح علامة تبويب JSON Patch لنسخ الفروق نفسها أو تنزيلها على هيئة عمليات JSON Patch.

إذا لم يكن أحد المستندين بتنسيق JSON صالح، فستُعلمك الأداة بأيّهما المشكلة، وتحدد سطرها وعمودها، مع تمييزها في المحرر المعني.

ما الذي يُعدّ فرقًا؟

  • لا يُعتد بترتيب المفاتيح أو المسافات البادئة أو المسافات أو فواصل الأسطر: {"a": 1, "b": 2} و{"b": 2, "a": 1} متطابقان.
  • يُعتد بالأنواع: فالعدد 1 والسلسلة النصية "1" قيمتان مختلفتان. وتُقارن الأعداد بحسب قيمتها، لذا يُعدّ 1.0 و1 متطابقين.
  • يُعتد بالترتيب في المصفوفات. وتُطابَق العناصر التي تكون كائنات وتحتوي على حقل id أو _id وفقًا له، لذا تُظهر القائمة المعاد ترتيبها العناصر التي انتقلت بدلًا من إظهار تغيير في كل صف.
  • تُطابَق عناصر المصفوفة الأخرى بحسب القيمة، لذا تُعدّ القيمة المُدرجة في منتصف القائمة إضافة واحدة. وتُقارَن الكائنات التي لا تحتوي على id بحسب موضعها في المصفوفة.
  • تُقارَن السلاسل النصية الطويلة بوصفها قيمًا كاملة: وتُظهر السلسلة التي تغيّرت نصها القديم والجديد.

قراءة النتائج

  • تظهر القيم المضافة باللون الأخضر، والمحذوفة بالأحمر، أما المتغيّرة فتظهر قيمتها القديمة متبوعة بالجديدة. ويُبيّن عنصر المصفوفة المنقول موضعه السابق والحالي.
  • تُكتب المسارات بصيغة JSONPath، بدءًا من $ الذي يشير إلى المستند بأكمله: يشير $.items[2].name إلى name العنصر الثالث في items. وتُكتب المفاتيح التي تحتوي على مسافات أو أحرف أخرى بين أقواس، مثل $["الاسم الأول"].
  • يشير مسار القيمة المحذوفة إلى موضعها في المستند الأصلي؛ أما مسار القيمة المضافة أو المتغيّرة فيشير إلى موضعها في المستند بعد التغيير.

JSON Patch

تعرض علامة تبويب JSON Patch الفروق على هيئة عمليات وفق معيار JSON Patch ‏(RFC 6902): add وremove وreplace وmove، ولكل منها مسار بصيغة JSON Pointer، مثل /items/0/price. وعند تطبيقها بالترتيب على المستند الأصلي، تنتج المستند بعد التغيير، كما يمكن للمكتبات في معظم لغات البرمجة تطبيقها نيابةً عنك. نزّلها باسم patch.json.

آلية العمل

تحلّل الأداة كلا المستندين في متصفحك، ثم تقارنهما باستخدام مكتبة jsondiffpatch، التي تطابق عناصر المصفوفات بخوارزمية أطول تتابع مشترك، وتكتشف العناصر التي نُقلت. لا يُرفع أي شيء تلصقه إلى أي مكان.

أمثلة

  • {"price": 3} و{"price": 3.25}: تغيّرت $.price من 3 إلى 3.25
  • ["عضوي", "محلي"] و["عضوي", "نباتي", "محلي"]: أُضيفت $[1]، "نباتي"
  • {"hours": {"sat": "8-14"}} و{"hours": {}}: حُذفت $.hours.sat
  • قائمة منتجات لها معرّفات، أُعيد ترتيبها وتغيّر فيها سعر واحد: يظهر عنصر واحد منقول وسعر واحد متغيّر، لا تغييرات في كل صف

الميزات

  • مقارنة JSON بحسب المحتوى، مع تجاهل ترتيب المفاتيح والتنسيق
  • عرض القيم المضافة والمحذوفة والمتغيّرة والمنقولة مع مساراتها
  • تمييز الفروق في كلا المحررين، مع إمكانية النقر للانتقال إليها
  • مطابقة عناصر المصفوفات وفقًا لـid أو _id
  • إخراج JSON Patch ‏(RFC 6902) لنسخه أو تنزيله
  • تحديد السطر والعمود لأخطاء الصياغة
  • يعمل في متصفحك