JSON डिफ़

लाइन डिफ़ स्वरूपण देखते हैं, अर्थ नहीं

एक मानक पंक्ति-आधारित डिफ़ JSON को गद्य मानता है। किसी फ़ाइल को दो स्पेस से चार स्पेस में पुनः इंडेंट करें और हर पंक्ति परिवर्तित चिह्नित होती है। किसी कुंजी को ऑब्जेक्ट के शीर्ष से तल तक ले जाएँ और आपको एक हटाना प्लस एक डालना मिलता है, भले ही पार्स किया गया मान बिल्कुल वही हो। किसी लंबे ऐरे को एकल पंक्ति पर लपेटें और पूरा ब्लॉक जल उठता है।

एक संरचनात्मक डिफ़ पहले दोनों पक्षों को पार्स करता है और फिर परिणामी मानों पर चलता है। तुलना शुरू होने तक स्वरूपण, कुंजी क्रम और रिक्त स्थान गायब हो चुके होते हैं, इसलिए रिपोर्ट किए जा सकने वाली एकमात्र चीज़ें डेटा में वास्तविक अंतर हैं। यही वह है जो आउटपुट को वास्तव में पढ़ने के लायक छोटा बनाता है।

पथ, पंक्ति संख्याएँ नहीं

यहाँ प्रत्येक अंतर किसी पथ के विरुद्ध रिपोर्ट होता है जैसे user.roles[2] या meta.updated। एक पथ दस्तावेज़ में कहीं और किए गए संपादनों से बच जाता है, जो एक पंक्ति संख्या नहीं करती, इसलिए आप उसी रिपोर्ट को किसी टिकट या कोड समीक्षा में पेस्ट कर सकते हैं और वह एक सप्ताह बाद भी सही स्थान की ओर इशारा करती है।

तीन ऑपरेशन इस बात पर मैप होते हैं कि एक ट्री के साथ वास्तव में क्या हो सकता है। बाएँ में मौजूद लेकिन दाएँ में न होने वाली कुंजी एक हटाना है, इसका विपरीत एक जोड़ना है, और दोनों में मौजूद भिन्न मान वाली कुंजी एक बदलाव है। प्रकार परिवर्तन — एक फ़ील्ड जो पहले संख्या 1 थी और अब स्ट्रिंग "1" है — भी बदलाव के रूप में रिपोर्ट होते हैं, और उन पर ध्यान देने लायक हैं, क्योंकि वे डाउनस्ट्रीम बग्स का एक सामान्य स्रोत हैं जिन्हें कोई स्कीमा जाँच नहीं पकड़ती।

ऐरेज़ और क्रम का प्रश्न

ऐरेज़ वहाँ हैं जहाँ संरचनात्मक डिफ़िंग राय रखती है। डिफ़ॉल्ट रूप से तुलना स्थितीय है: बाएँ का अनुक्रमांक 0 दाएँ के अनुक्रमांक 0 से तुलना किया जाता है। यह कदमों के अनुक्रम जैसे क्रमबद्ध डेटा के लिए सही है, लेकिन एक सूची के लिए जो वास्तव में एक सेट है एक भ्रामक परिणाम देता है — तत्वों को पुनः क्रमबद्ध करें और हर स्थिति बदली हुई प्रतीत होती है।

ऐरे क्रम अनदेखा करें विकल्प तुलना करने से पहले ऐरेज़ को गहराई से क्रमबद्ध करके दोनों पक्षों को कैननिकल बनाता है, इसलिए पुनः क्रमबद्ध सूची समान के रूप में तुलना की जाती है। इसका उपयोग टैग सूचियों, अनुमति सेटों और बिना गारंटीकृत क्रम वाले क्वेरी परिणामों के लिए करें। इसे तब बंद रखें जब किसी तत्व की स्थिति का कोई अर्थ हो, क्योंकि इसे चालू रखने पर एक वास्तविक पुनः-क्रमबद्धन बग अदृश्य हो जाता है।