डेवलपमेंट 6 मिनट में पढ़ें
अगर आपने कभी API, सेटिंग फ़ाइल या डेटा एक्सपोर्ट के साथ काम किया है, तो आप JSON से ज़रूर मिले होंगे। यह सरल दिखता है, लेकिन एक गलत जगह लगा कॉमा पूरी फ़ाइल को अमान्य कर देता है और समझ न आने वाला एरर मैसेज दिखा देता है।
इस गाइड में आप जानेंगे कि JSON क्या है, यह कौन-से वैल्यू टाइप सपोर्ट करता है, कौन-से सिंटैक्स नियम याद रखने चाहिए, सबसे आम गलतियाँ पहले और बाद के उदाहरणों के साथ, और अपने डेटा को कुछ सेकंड में वैलिडेट, फ़ॉर्मैट और मिनिफ़ाई कैसे करें।
अपना JSON अभी वैलिडेट और फ़ॉर्मैट करें गलतियाँ ढूँढने, फ़ॉर्मैट करने या मिनिफ़ाई करने के लिए अपना JSON पेस्ट करें। सब कुछ आपके ब्राउज़र में चलता है और कुछ भी अपलोड नहीं होता। JSON फ़ॉर्मैटर खोलेंJSON क्या है?
JSON (JavaScript Object Notation) डेटा को स्टोर और शेयर करने का एक हल्का टेक्स्ट फ़ॉर्मैट है। डेटा को की (key) और वैल्यू के जोड़ों में सजाया जाता है, जैसे {"name": "Ana", "age": 30}। इसे इंसान आसानी से पढ़ सकते हैं और प्रोग्राम आसानी से पार्स कर सकते हैं।
हालाँकि JSON की शुरुआत JavaScript से हुई, यह किसी एक भाषा पर निर्भर नहीं है। वेब API सर्वर और ऐप्स के बीच डेटा भेजने के लिए इसी का मानक रूप से उपयोग करते हैं, और यह कॉन्फ़िगरेशन फ़ाइलों, लॉग और डेटा एक्सपोर्ट में भी खूब इस्तेमाल होता है।
छह वैल्यू टाइप
JSON की हर वैल्यू इन छह टाइप में से एक होती है:
- स्ट्रिंग (string): डबल कोट में लिखा टेक्स्ट, जैसे "नमस्ते"।
- नंबर (number): पूर्णांक या दशमलव, जैसे 42 या 3.14, बिना कोट के।
- बूलियन (boolean): true या false, छोटे अक्षरों में और बिना कोट के।
- नल (null): शब्द null, जिसका मतलब है "कोई वैल्यू नहीं"।
- ऐरे (array): स्क्वेयर ब्रैकेट में क्रम से लगी सूची, जैसे [1, 2, 3]।
- ऑब्जेक्ट (object): कर्ली ब्रेस में की-वैल्यू जोड़ों का समूह, जैसे {"city": "Delhi"}। की हमेशा स्ट्रिंग होती है।
ऐरे और ऑब्जेक्ट के अंदर दूसरे ऐरे और ऑब्जेक्ट हो सकते हैं, इसलिए किसी भी गहराई का डेटा बताया जा सकता है।
याद रखने लायक सिंटैक्स नियम
JSON, JavaScript से कहीं ज़्यादा सख़्त है। ज़्यादातर गलतियाँ इन्हीं नियमों में से किसी एक को तोड़ने से होती हैं:
- स्ट्रिंग और की में डबल कोट ज़रूरी हैं। सिंगल कोट मान्य नहीं हैं।
- अंत में अतिरिक्त कॉमा नहीं: ऐरे या ऑब्जेक्ट के आखिरी आइटम के बाद कॉमा नहीं लगना चाहिए।
- कमेंट नहीं: // और /* */ दोनों अमान्य हैं।
- सिर्फ़ छह टाइप हैं: undefined, NaN, Infinity और फ़ंक्शन मान्य नहीं हैं।
- जोड़ों को कॉमा से अलग किया जाता है और की को वैल्यू से कोलन द्वारा।
- खोले गए हर ब्रैकेट या ब्रेस का बंद होना ज़रूरी है।
सबसे आम गलतियाँ और उन्हें कैसे ठीक करें
"अमान्य JSON" वाले ज़्यादातर मैसेज इन पाँच गलतियों से आते हैं:
- अतिरिक्त कॉमा। पहले: {"a": 1, "b": 2,}। बाद में: {"a": 1, "b": 2}। आखिरी आइटम के बाद का कॉमा हटाएँ।
- सिंगल कोट। पहले: {'name': 'Ana'}। बाद में: {"name": "Ana"}। हर सिंगल कोट को डबल कोट से बदलें।
- बिना कोट की की। पहले: {name: "Ana"}। बाद में: {"name": "Ana"}। हर की को डबल कोट में रखें।
- ब्रैकेट या ब्रेस गायब। पहले: {"items": [1, 2, 3}। बाद में: {"items": [1, 2, 3]}। जो भी ऐरे और ऑब्जेक्ट खोलें, उसे बंद करें।
- कोट का गलत एस्केप। पहले: {"text": "उसने कहा "hi""}। बाद में: {"text": "उसने कहा \"hi\""}। स्ट्रिंग के अंदर डबल कोट से पहले बैकस्लैश लगाना ज़रूरी है। बैकस्लैश खुद के लिए भी यही नियम है, जिसे \\ लिखा जाता है।
वर्ड प्रोसेसर से पेस्ट किए गए "स्मार्ट कोट" से भी सावधान रहें: वे कोट जैसे दिखते हैं, पर JSON में मान्य नहीं होते।
JSON एरर मैसेज कैसे पढ़ें
ज़्यादातर पार्सर बताते हैं कि वे कहाँ अटके, जैसे "Unexpected token } in JSON at position 25" या "Expected double-quoted property name at line 3 column 5"। position शुरुआत से अक्षरों की गिनती है, जबकि line और column सटीक जगह बताते हैं।
असली गलती अक्सर बताई गई जगह से ठीक पहले होती है। अनपेक्षित क्लोज़िंग ब्रेस का मतलब आम तौर पर उससे ठीक पहले अतिरिक्त कॉमा होता है, और अनपेक्षित डेटा का अंत किसी ब्रैकेट के बंद न होने का संकेत देता है। बताई गई लाइन और उसके ऊपर वाली लाइन देखें।
JSON को वैलिडेट, फ़ॉर्मैट और मिनिफ़ाई कैसे करें
- मुफ़्त JSON फ़ॉर्मैटर खोलें। यह पूरी तरह आपके ब्राउज़र में चलता है, इसलिए आपका डेटा आपके डिवाइस से बाहर नहीं जाता।
- अपना JSON पेस्ट करें। अगर वह अमान्य है, तो टूल लाइन और कॉलम के साथ एरर दिखाता है ताकि आप उसे ठीक कर सकें।
- पढ़ने लायक बनाने के लिए इंडेंट के साथ फ़ॉर्मैट करें, या भेजने से पहले स्पेस हटाकर साइज़ घटाने के लिए मिनिफ़ाई करें।
- नतीजा कॉपी करें। अगर आपने कोई फ़ाइल बदली है और ठीक-ठीक फ़र्क देखना चाहते हैं, तो टेक्स्ट डिफ़ टूल से दोनों वर्शन की तुलना करें।
JSON बनाम XML बनाम YAML
XML ज़्यादा लंबा होता है, इसमें खुलने और बंद होने वाले टैग होते हैं, लेकिन यह एट्रिब्यूट सपोर्ट करता है और पुराने सिस्टम में अब भी आम है। YAML इंसानों के लिए साफ़ है और कमेंट की अनुमति देता है, इसलिए कॉन्फ़िगरेशन फ़ाइलों में लोकप्रिय है, पर इसमें इंडेंटेशन की गलती आसानी से हो जाती है।
JSON बीच का रास्ता है: छोटा, स्पष्ट और लगभग हर भाषा में समर्थित, इसीलिए API के लिए यह डिफ़ॉल्ट पसंद है। इसकी मुख्य कमी कमेंट का न होना है।
काम के सुझाव
- JSON भेजने या कॉन्फ़िगरेशन फ़ाइल में सेव करने से पहले हमेशा उसे वैलिडेट करें।
- JSON हाइलाइटिंग वाला एडिटर इस्तेमाल करें, जो बेमेल कोट और ब्रैकेट तुरंत दिखा देता है।
- जब कोड से JSON बन सकता हो तो उसे हाथ से न लिखें, क्योंकि लाइब्रेरी अक्षरों को सही तरह एस्केप करती हैं।
- अगर URL पैरामीटर में JSON है, तो पहले URL एनकोडर से उसे एनकोड करें ताकि खास अक्षर रिक्वेस्ट न बिगाड़ें।
- डेटा अपलोड करने वाले ऑनलाइन टूल में पासवर्ड या टोकन वाला JSON कभी पेस्ट न करें। लोकल चलने वाले टूल चुनें।
निष्कर्ष
नियम पता हों तो JSON आसान है: छह वैल्यू टाइप, डबल कोट, अंत में कॉमा नहीं और कमेंट नहीं। कुछ टूटे तो एरर की लाइन और कॉलम पढ़ें, उससे ठीक पहले की जगह जाँचें और भारी काम वैलिडेटर को करने दें। फ़ॉर्मैटर के साथ बिताए कुछ सेकंड डीबगिंग का बहुत समय बचा देते हैं।
अक्सर पूछे जाने वाले सवाल
JSON किस काम आता है?
इसका उपयोग एप्लिकेशन के बीच डेटा के आदान-प्रदान, ख़ासकर वेब API में, और फ़ाइलों में सेटिंग तथा संरचित डेटा सहेजने के लिए होता है। लगभग हर प्रोग्रामिंग भाषा JSON पढ़ और लिख सकती है।
क्या JSON में कमेंट हो सकते हैं?
नहीं। मानक JSON कमेंट की अनुमति नहीं देता। नोट चाहिए तो "comment" जैसा सामान्य फ़ील्ड जोड़ें या कॉन्फ़िगरेशन फ़ाइलों के लिए YAML जैसा फ़ॉर्मैट इस्तेमाल करें।
मेरा JSON "unexpected token" क्यों दिखा रहा है?
पार्सर को कोई अनपेक्षित अक्षर मिला है, आम तौर पर अतिरिक्त कॉमा, सिंगल कोट, बिना कोट की की या गायब ब्रैकेट। बताई गई position और उसके ठीक ऊपर की लाइन जाँचें।
JSON को फ़ॉर्मैट और मिनिफ़ाई करने में क्या फ़र्क है?
फ़ॉर्मैट करने से पढ़ने में आसानी के लिए नई लाइनें और इंडेंटेशन जुड़ते हैं। मिनिफ़ाई करने से सारे गैर-ज़रूरी स्पेस हटकर फ़ाइल छोटी हो जाती है। डेटा बिल्कुल वही रहता है।
क्या ऑनलाइन JSON फ़ॉर्मैटर इस्तेमाल करना सुरक्षित है?
अगर टूल आपके ब्राउज़र में चलता है और कंटेंट सर्वर को नहीं भेजता, तो यह सुरक्षित है। हमारा JSON फ़ॉर्मैटर सब कुछ आपके डिवाइस पर ही प्रोसेस करता है।
इस लेख में बताए गए मुफ़्त टूल
और पढ़ें
- मज़बूत पासवर्ड कैसे बनाएँलंबाई, रैंडमनेस और यूनिकनेस: वे आसान नियम जो सच में आपके अकाउंट बचाते हैं, और बिना कुछ रटे उन्हें अपनाने का तरीका।
- पोमोडोरो तकनीक: पूरी गाइड25 मिनट के फोकस वाले ब्लॉक और छोटे ब्रेक के साथ काम करें। जानें यह तकनीक कैसे काम करती है, आज से कैसे शुरू करें और इसे अपनी दिनचर्या के हिसाब से कैसे ढालें।
- हैश क्या है? MD5, SHA-256 और उनके उपयोगहैश किसी भी डेटा की एक छोटी "फिंगरप्रिंट" है। जानिए यह कैसे काम करता है, कौन से एल्गोरिदम भरोसेमंद हैं और फाइलें जांचने व पासवर्ड बचाने में इसका उपयोग कैसे होता है।