JSON Diff مقارنة

ما هو JSON Diff؟

// Two JSON documents that look different but are semantically equal
const a = '{"a":1,"b":2}';
const b = '{"b":2,"a":1}';

// Naive comparison — wrong
JSON.stringify(JSON.parse(a)) === JSON.stringify(JSON.parse(b));
// → false (key order differs)

// JSON Diff (this tool) — correct: key order is irrelevant
// → 0 differences

// JSON Patch (RFC 6902) for { "a": 1 } → { "a": 2 }
// [{ "op": "replace", "path": "/a", "value": 2 }]

الميزات الرئيسية

أمثلة

{"user":{"id":1,"name":"Ada","createdAt":"2024-01-01"}}

{"user":{"id":1,"name":"Ada Lovelace","createdAt":"2024-02-02"}}

{"a":1,"b":2,"c":3}

{"c":3,"a":1,"b":2}

[{"id":1,"qty":3},{"id":2,"qty":5}]

[{"id":2,"qty":5},{"id":1,"qty":4}]

{"items":[{"id":1,"price":29.99}]}

{"items":[{"id":1,"price":24.99}]}

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

1. 1

   الصق كلا مستندَي JSON

   الصق JSON الأصلي (يسار) والمعدَّل (يمين). يُعرض الفرق مباشرةً أثناء الكتابة؛ المدخلات الكبيرة (أكثر من 200 كيلوبايت) تنتقل إلى زر 'الفرق' اليدوي.

2. 2

   صفِّ الضوضاء

   انقر على ضبط مسبق (الطوابع الزمنية / المعرّفات / التتبع) أو الصق أنماط JSON Pointer الموسّعة في 'مسارات التجاهل' لحذف الحقول غير ذات الصلة.

3. 3

   اختر العرض الذي تحتاجه

   جنباً إلى جنب للمراجعة البشرية، JSON Patch (RFC 6902) للعمليات القابلة للتطبيق الآلي. استخدم 'رابط المشاركة' لإرسال الإعداد إلى زميل.

أخطاء الفرق الشائعة

diff a.json b.json   # text diff: 'everything changed'

JSON Diff (this tool): 0 differences

{"a": null} == {}   # collapsed by some tools

{"a": null} ≠ {}     # type-strict diff

Sequential diff: 4 modified

Match by key (id): 0 differences

{"id": 42} vs {"id": "42"}   # serialization bug

Diff reports 'modified (type)' with both values

tolerance=0:  0.30000000000000004 ≠ 0.3

tolerance=1e-9: equal

Diff: 47 modifications (45 are timestamps)

Add /createdAt, /updatedAt, /requestId to Ignore paths → 2 real changes

حالات الاستخدام الشائعة

انحدار استجابة الـ API

قارن استجابات بيئة التجريب مع الإنتاج؛ تجاهل الطوابع الزمنية ومعرّفات الطلبات لإبراز التغييرات الفعلية في الحمولة فقط.

فشل اختبارات اللقطة في CI

الصق الفعلي مقابل المتوقع من اختبار Jest/Vitest الفاشل. صفِّ الضوضاء وابحث عن التغيير الحقيقي في ثوانٍ.

تعارضات package-lock / yarn.lock

حلّ تعارضات الدمج بمحاذاة الاعتماديات على الاسم؛ يتوقف ترتيب المفاتيح والحقول غير ذات الصلة عن كونها ضوضاء.

تدقيق قيم K8s / Helm

طابق بيئات وvolumeMounts ومنافذ بالاسم. اكتشف الترتيب غير المقصود مقابل تعديلات الإعداد الفعلية.

تغطية ترجمة i18n

قارن en.json مع zh.json هيكلياً للعثور على مفاتيح ترجمة مفقودة أو إضافية دون ضوضاء القيم.

مراجعة خطط Terraform / CDK

قارن ناتج الخطة عبر عمليات التشغيل؛ التسامح العددي يتعامل مع حسابات الفاصلة العائمة، وتتجاهل المسارات ARNs والطوابع الزمنية.

التفاصيل التقنية

إخراج Patch متوافق مع RFC 6902

يُولّد عمليات JSON Patch صالحة (add/remove/replace) مع مسارات RFC 6901. مُتحقَّق منه مقابل fast-json-patch@3.x وحزمة rfc6902 npm.

اجتياز تكراري

اجتياز بمكدس صريح (بدون تكرار) محدود بـ100,000 عقدة وعمق 64 لمنع تجاوز المكدس على المدخلات المعادية.

المساواة العددية بـ Object.is

التسامح العددي الافتراضي هو 0 — يستخدم Object.is لذا يُميَّز -0 عن +0. عيّن التسامح أكبر من 0 للمساواة المبنية على إبسيلون.

أفضل الممارسات

صفِّ قبل المراجعة

أضف مسارات التجاهل أولاً (الطوابع الزمنية، المعرّفات، حقول التتبع)، ثم اقرأ الفرق. مراجعة الفروق الصاخبة تدرّب العين على التخطي — وإغفال — التغييرات الحقيقية.

المطابقة بالمفتاح للمجموعات المنطقية

إذا كانت مصفوفتك تمثّل مجموعة غير مرتبة (بيئات، مستخدمون، اعتماديات)، استخدم المطابقة بالمفتاح. الفرق التسلسلي على المجموعات المنطقية يكون خاطئاً دائماً تقريباً.

شارك الرابط لا المدخلات

استخدم 'رابط المشاركة' لإرسال إعداد المرشح إلى زميل — لا تلصق JSON الحساس في مستندات مشتركة. يحتوي URL على الإعداد فقط.

الأسئلة الشائعة