JSON क्वेरी
JSONPath की मदद से JSON डेटा से सिर्फ़ ज़रूरी वैल्यू निकालें।
उपयोग के उदाहरण
बड़ी API रिस्पॉन्स से सिर्फ़ ज़रूरी फ़ील्ड निकालना
पूरी रिस्पॉन्स JSON को छानने के बजाय, $.data.items[*].id जैसे पाथ से ज़रूरी वैल्यू एक साथ निकालें।
किसी शर्त से मेल खाने वाले आइटम छाँटना
$.products[?(@.price<10000)] जैसा फ़िल्टर एक्सप्रेशन इस्तेमाल करके, कीमत, स्टॉक या किसी भी शर्त से मेल खाने वाले आइटम छाँट लें।
नेस्टेड स्ट्रक्चर में हर जगह से कोई खास की ढूंढना
रिकर्सिव डिसेंट सिंटैक्स, $..price, डॉक्यूमेंट में गहराई या पोज़िशन चाहे जो भी हो, उस नाम की हर की ढूंढ निकालता है।
ऐरे का आख़िरी आइटम निकालना
लॉग या ऑर्डर के बढ़ते ऐरे से सबसे हाल की प्रविष्टि निकालने के लिए $.orders[-1:] इस्तेमाल करें, उसमें कितने आइटम हैं यह गिने बिना।
एक साथ कई ख़ास फ़ील्ड निकालना
$.user['name','email','id'] जैसा यूनियन एक्सप्रेशन ऑब्जेक्ट से सिर्फ़ वे तीन फ़ील्ड लौटाता है, बड़े यूज़र रिकॉर्ड की बाक़ी हर चीज़ छोड़कर।
अनजान API पेलोड की बनावट जाँचना
पक्का नहीं कि कभी न देखे रिस्पॉन्स में कोई फ़ील्ड कितनी गहराई में है? उसे कहीं भी खोजने के लिए $..fieldName से शुरू करें, फिर जब दिख जाए कि वह कहाँ है तो सटीक पाथ तक सीमित करें।
अक्सर पूछे जाने वाले सवाल
क्या मैंने जो JSON और एक्सप्रेशन डाला वह सर्वर पर भेजा जाता है?
नहीं। क्वेरी पूरी तरह आपके ब्राउज़र में चलती है, और आपने जो डाला वह कभी सर्वर पर नहीं भेजा जाता।
मुझे JSONPath सिंटैक्स याद नहीं है।
आम पैटर्न ये हैं: $ का मतलब पूरा डॉक्यूमेंट, .key किसी खास की के लिए, [*] एरे के हर आइटम के लिए, [0] पहले आइटम के लिए, [?(@.price<10)] किसी शर्त से मेल खाने वाले आइटम छाँटने के लिए, और $..key किसी भी गहराई पर उस नाम की हर की ढूंढने के लिए।
मेरा नतीजा खाली है — ऐसा क्यों?
इसका मतलब हो सकता है कि पाथ किसी असली डेटा की ओर इशारा नहीं करता, या एक्सप्रेशन में सिंटैक्स एरर है — दोनों ही स्थिति में खाली नतीजा दिखता है। पाथ को एक-एक कदम छोटा करके देखें कि कहां मेल खाना बंद होता है।
क्या क्वेरी का नतीजा हमेशा एक एरे होता है?
हां। JSONPath हर मेल खाती वैल्यू को एक एरे में इकट्ठा करता है, चाहे सिर्फ़ एक ही वैल्यू मेल खाए — तब भी आपको लंबाई 1 वाला एरे मिलेगा।
क्या यह JSONPath है, JMESPath है, या jq सिंटैक्स?
JSONPath, जिसे jsonpath-plus लाइब्रेरी से इवैल्यूएट किया जाता है। यह मानक $, ., [*], [n] और $..key सिंटैक्स के साथ फ़िल्टर एक्सप्रेशन ([?(@.price<10)]) और स्क्रिप्ट एक्सप्रेशन जैसे एक्सटेंशन सपोर्ट करता है, पर यह jq या JMESPath क्वेरी सिंटैक्स के साथ संगत नहीं है, जो अलग ऑपरेटर इस्तेमाल करते हैं।
क्या मैं ऐरे को एक से ज़्यादा शर्तों से फ़िल्टर कर सकता हूँ?
हाँ। फ़िल्टर एक्सप्रेशन के भीतर शर्तों को && या || से जोड़ें, उदाहरण के लिए $.products[?(@.price<100 && @.inStock==true)] ताकि ऐसे आइटम मिलें जो सस्ते भी हों और स्टॉक में भी।
क्या पाथ ऋणात्मक ऐरे इंडेक्स या स्लाइस सपोर्ट करता है?
हाँ। [-1] आख़िरी तत्व को बताता है और [1:3] या [-2:] जैसा स्लाइस सिंटैक्स वैसे ही काम करता है जैसे Python में, जिससे आप ऐरे की ठीक लंबाई जाने बिना आइटमों की एक रेंज ले सकते हैं।