JSON फ़ॉर्मैटर

फ़ॉर्मैटिंग असल में क्या करती है

JSON फ़ॉर्मैट करना दरअसल पार्स करना और फिर दोबारा सीरियलाइज़ करना है। डॉक्यूमेंट को एक वैल्यू में पढ़ा जाता है, फिर हर कॉमा के बाद नई लाइन और हर नेस्टिंग लेवल पर तय इंडेंट के साथ लिखा जाता है। डेटा मॉडल में कुछ नहीं बदलता — सिर्फ़ टोकन के बीच के बाइट बदलते हैं।

यह अंतर मायने रखता है, क्योंकि इस राउंड ट्रिप में दो चीज़ें नॉर्मलाइज़ होती हैं:

• नंबर अपने सबसे छोटे रूप में लिखे जाते हैं। 1.50 बनता है 1.5, 1e3 बनता है 1000, और -0 बनता है 0। वैल्यू वही रहती है, लिखावट मानक हो जाती है।
• ग़ैर-ज़रूरी एस्केप हट जाते हैं। "\u0041" बनता है "A"। जो एस्केप JSON के लिए ज़रूरी हैं — कोट, बैकस्लैश और कंट्रोल कैरेक्टर — वे बने रहते हैं।
• 2⁵³−1 से बड़े इंटीजर की प्रिसिशन खो जाती है। यह JavaScript के नंबर टाइप की सीमा है, इस टूल की नहीं। बड़े ID को स्ट्रिंग के रूप में रखें।

इंडेंट कितना रखें

इंडेंट सिलेक्टर तुरंत लागू होता है और आपकी अगली विज़िट के लिए याद रहता है। मोटा नियम:

• 2 स्पेस — API रिस्पॉन्स, कोड रिव्यू में पेस्ट करने वाला कुछ भी, और वह सब जो JSON.stringify(v, null, 2) के आउटपुट से मेल खाना चाहिए।
• 4 स्पेस — हाथ से लिखी जाने वाली कॉन्फ़िग फ़ाइलें, जहाँ नेस्टिंग कम पर लाइनें लंबी होती हैं।
• टैब — रिपॉज़िटरी में कमिट होने वाली फ़ाइलें, जहाँ हर योगदानकर्ता अपनी चौड़ाई चुन सके।

कमांड लाइन पर वही काम

jq . input.json 2-स्पेस इंडेंट के साथ फ़ॉर्मैट करता है, जो इस पेज के डिफ़ॉल्ट आउटपुट के बराबर है। ब्राउज़र वाला तरीका तब जीतता है जब JSON फ़ाइल में नहीं, क्लिपबोर्ड में हो; जब 4,000 लाइनें पढ़ने की जगह आप ट्री में क्लिक करना चाहें; या जब पेलोड ऐसा हो जिसे आप किसी ऐसे टूल में नहीं डालना चाहते जिसकी आपने जाँच नहीं की।

जो डॉक्यूमेंट पार्स ही नहीं होता

फ़ॉर्मैटर वह इंडेंट नहीं कर सकता जिसे वह पढ़ न सके, इसलिए अमान्य डॉक्यूमेंट पर आउटपुट की जगह एरर मिलता है। एरर पैनल लाइन, कॉलम, गलती वाली सोर्स लाइन और ठीक उस कैरेक्टर के नीचे कैरेट दिखाता है, साथ ही यह भी कि पार्सर को वहाँ क्या चाहिए था। एरर पर जाएँ आपका कर्सर उसी कैरेक्टर पर रख देता है। अगर गड़बड़ी आम “लगभग-JSON” वाली है तो ठीक करें उसे सुधार कर एक ही कदम में फ़ॉर्मैट कर देता है — पूरी सूची वैलिडेटर पर है।