SSE से JSON

SSE Stream
Blank line separates events0 lines0 chars
JSON Array0

Formatted JSON shows up here

Paste id/event/data blocks separated by blank lines on the left, and each event becomes one item of the JSON array.

0 eventsWaiting for input

Server-Sent Events (SSE) पुश डेटा के लिए एक केंद्रित कन्वर्टर। बाईं ओर कच्चे id/event/data ब्लॉक पेस्ट करें और दाईं ओर तुरंत एक मानक JSON ऐरे देखें, जहाँ हर पुश इवेंट अपने id, इवेंट नाम और पार्स किए गए data पेलोड के साथ एक ही ऑब्जेक्ट बन जाता है।

संबंधित सुझाव

SSE से JSON कन्वर्ज़न क्या है?

Server-Sent Events (SSE) एक एकदिशीय स्ट्रीमिंग प्रोटोकॉल है जिसमें सर्वर `text/event-stream` प्रकार के HTTP रिस्पॉन्स पर UTF-8 टेक्स्ट इवेंट लिखता है। वायर पर हर इवेंट `id: 1`, `event: MESSAGE` और `data: {...}` जैसी फ़ील्ड पंक्तियों का अनुक्रम होता है, और एक रिक्त पंक्ति उस इवेंट के अंत को चिह्नित करती है।

कच्चा SSE ट्रांसपोर्ट के लिए सुविधाजनक है, पर पढ़ने और डीबग करने में असहज। फ़ील्ड नाम हर इवेंट पर दोहराए जाते हैं, JSON पेलोड `data:` उपसर्ग के पीछे बैठा होता है, और लंबी स्ट्रीम टेक्स्ट की दीवार बन जाती है। SSE को JSON में बदलने का अर्थ है हर इवेंट को एक सादे ऑब्जेक्ट में सामान्य करना और सभी इवेंट को एक JSON ऐरे में एकत्र करना।

यह कन्वर्टर event-stream व्याख्या नियमों का पालन करता है: यह लाइन एंडिंग पर बाँटता है, रिक्त पंक्ति को डिस्पैच सीमा मानता है, फ़ील्ड कोलन के बाद का ठीक एक वैकल्पिक स्पेस हटाता है, दोहराई गई data पंक्तियों को न्यूलाइन से जोड़ता है, और कोलन-पूर्वक कमेंट को अनदेखा करता है। फिर हर data पेलोड को JSON के रूप में पार्स करता है ताकि नेस्टेड संरचनाएँ सुरक्षित रहें।

परिणाम एक मानक, इंडेंटेड JSON ऐरा है जो पढ़ने, कोड में कॉपी करने, किसी दूसरे कैप्चर से तुलना करने या डाउनस्ट्रीम टूलिंग को देने में आसान है, जबकि कोई भी अपार्स करने योग्य पेलोड छोड़े जाने के बजाय झंडित किया जाता है।

उपयोग के मामले

  • STREAM_CHUNK या CHUNK_DELTA जैसे SSE इवेंट खंडों में आने वाले LLM या AI एजेंट के स्ट्रीमिंग रिस्पॉन्स को डीबग करें
  • ब्राउज़र DevTools Network टैब से कॉपी किए text/event-stream रिस्पॉन्स को पठनीय JSON में बदलें
  • रीयल-टाइम पुश या चैट बैकएंड से आने वाले heartbeat, ack और पूर्ण-संदेश इवेंट की जाँच करें
  • डीबगिंग के लिए साथी के साथ साझा करने से पहले कैप्चर किए SSE पुश डेटा को JSON ऐरे में बदलें
  • बिना data: उपसर्ग हटाए हर इवेंट के नेस्टेड data पेलोड को निकालें और फैलाएँ
  • रिकॉर्ड की गई पुश स्ट्रीम को ऑफ़लाइन फिर से चलाएँ और id के अनुसार इवेंट क्रम की तुलना करें
  • विश्लेषण, लॉग या स्प्रेडशीट के लिए SSE इवेंट डेटा तैयार करें जो JSON ऐरे की अपेक्षा रखते हों
  • फ्रंटएंड-बैकएंड एकीकरण के दौरान सत्यापित करें कि सर्वर अपेक्षित इवेंट नाम और पेलोड संरचना भेजता है
  • बहु-पंक्ति वाले data फ़ील्ड को हर इवेंट ऑब्जेक्ट के लिए एक पार्स किए गए मान में समतल करें
  • प्रॉक्सी, गेटवे या curl आउटपुट से आए SSE ट्रेस को संरचित, संकुचन-योग्य रूप में देखें
  • Webhook-शैली या मैसेज-क्यू इवेंट स्ट्रीम जो SSE वायर प्रारूप का पुन: उपयोग करती हैं, को JSON में बदलें
  • देखें कि id, event और data JSON ऑब्जेक्ट से कैसे मैप होते हैं, इससे Server-Sent Events वायर प्रारूप सीखें

उपयोग कैसे करें

  1. बाईं textarea में कच्ची SSE स्ट्रीम पेस्ट करें, जिसमें id/event/data पंक्तियाँ हों और इवेंटों के बीच एक रिक्त पंक्ति हो
  2. दाईं ओर अपने आप अपडेट होता है और हर इवेंट के लिए एक ऑब्जेक्ट वाला JSON ऐरा दिखाता है
  3. यदि कोई data पेलोड मान्य JSON नहीं है या कोई फ़ील्ड विकृत दिखती है, तो चेतावनी पैनल देखें
  4. पूरा JSON ऐरा कॉपी करने के लिए कॉपी करें, या पहले अंतर्निहित उदाहरण लोड करने के लिए सैंपल पर क्लिक करें

विशेषताएं

  • कच्ची SSE इवेंट स्ट्रीम को मानक JSON ऐरे में बदलता है, हर पुश इवेंट के लिए एक ऑब्जेक्ट
  • रिक्त पंक्ति के आधार पर पंक्तियों को इवेंट में समूहबद्ध करता है, Server-Sent Events डिस्पैच मॉडल के अनुसार
  • हर फ़ील्ड को field: value के रूप में पार्स करता है और कोलन के बाद का एकल स्पेस हटा देता है
  • हर data पेलोड को JSON.parse से पार्स करता है, ताकि नेस्टेड पेलोड बचे हुए स्ट्रिंग के बजाय असली ऑब्जेक्ट बनें
  • id, event, data की स्थिर क्रम बनाए रखता है और संख्यात्मक id को JSON नंबर में बदलता है
  • बहु-पंक्ति वाले data फ़ील्ड, कोलन से शुरू होने वाली कमेंट पंक्तियों और बिना अंतिम रिक्त पंक्ति वाली स्ट्रीम को सपोर्ट करता है
  • अमान्य data पेलोड और अज्ञात या विकृत फ़ील्ड को ब्लॉक और पंक्ति क्रमांक के साथ रिपोर्ट करता है
  • विभाजित textarea इनपुट और JSON प्रीव्यू लेआउट, सैंपल, क्लियर, कॉपी और इवेंट आँकड़ों के साथ; पूरी तरह ब्राउज़र में चलता है

SSE से JSON बनाम JSONL फ़ॉर्मेटर बनाम JSON फ़ॉर्मेटर

ये टूल अलग इनपुट रूप संभालते हैं। सही टूल चुनने से उपसर्ग हटाने और ऐरे में लपेटने का हाथ का काम बचता है।

टूलसबसे उपयुक्त इनपुटमुख्य क्षमताउपयोग परिदृश्य
SSE से JSONरिक्त पंक्तियों से बँटे id/event/data ब्लॉकSSE फ़ील्ड समझता है और हर data पेलोड पार्स करता हैसर्वर पुश स्ट्रीम, text/event-stream, AI स्ट्रीमिंग खंड
JSONL फ़ॉर्मेटरहर पंक्ति पर एक संपूर्ण JSON ऑब्जेक्टहर पंक्ति को स्वतंत्र रूप से सत्यापित और फ़ॉर्मेट करता हैNDJSON लॉग, संग्रहीत इवेंट, लाइन-डिलिमिटेड एक्सपोर्ट
JSON फ़ॉर्मेटरएक संपूर्ण JSON ऑब्जेक्ट या ऐरेएकल पूर्ण JSON दस्तावेज़ को सुंदर बनाता हैAPI प्रतिक्रियाएँ, कॉन्फ़िग फ़ाइलें, एकल पेलोड

Best Practices

स्ट्रीम कॉपी करते समय इवेंटों के बीच रिक्त पंक्ति बनाए रखें

रिक्त पंक्ति ही एक SSE इवेंट को अगले से अलग करती है। यदि आप कॉपी करते समय रिक्त पंक्तियाँ हटा देते हैं, तो अलग-अलग इवेंट एक ब्लॉक में विलीन हो सकते हैं और कन्वर्ज़न अब मूल डिस्पैच क्रम से मेल नहीं खाएगा।

समस्या पर कूदने के लिए चेतावनियों में दिए ब्लॉक और पंक्ति क्रमांक इस्तेमाल करें

जब कोई data पेलोड पार्स नहीं हो पाता, चेतावनी उस इवेंट ब्लॉक और दोषी पंक्ति का नाम बताती है। उस ब्लॉग की तुलना आसपास के किसी वैध इवेंट से करें ताकि कटा हुआ ब्रेस, गुम कोट या जुड़े खंड पहचान सकें।

याद रखें कि केवल data फ़ील्ड ही JSON के रूप में पार्स होती है

id, event और retry फ़ील्ड SSE ट्रांसपोर्ट मेटाडेटा हैं और स्केलर मान बने रहते हैं। यह मत अपेक्षा करें कि कन्वर्टर इवेंट नाम या id के अंदर आने वाले JSON को पार्स करेगा; संरचित सामग्री data में ही होनी चाहिए।

पूरे संदेश को बदलने से पहले आंशिक स्ट्रीमिंग खंड जोड़ें

कई AI स्ट्रीम छोटे STREAM_CHUNK इवेंट भेजती हैं जो एक संदेश बनाते हैं। पहले पूरे कैप्चर को बदलें ताकि हर खंड ऐरा वस्तु के रूप में दिखे, फिर यदि अंतिम संदेश चाहिए तो अपने ऐप्लिकेशन कोड में खंड पेलोड मिलाएँ।

बदले हुए JSON को साझा करने से पहले संवेदनशील पेलोड साफ़ करें

कन्वर्ज़न स्थानीय है, पर जैसे ही आप JSON ऐरा को किसी टिकट या चैट में कॉपी करते हैं, वह आपकी मशीन से बाहर चला जाता है। साझा करने से पहले आउटपुट से टोकन, यूज़र id और निजी बातचीत का टेक्स्ट हटा दें।

सामान्य प्रश्न

SSE (Server-Sent Events) क्या है?

SSE सर्वर के लिए `text/event-stream` कंटेंट टाइप का उपयोग करके HTTP पर ब्राउज़र को टेक्स्ट इवेंट पुश करने का एक मानक तरीका है। हर इवेंट `id`, `event` और `data` जैसी टेक्स्ट पंक्तियों से बना होता है, और इवेंट एक दूसरे से रिक्त पंक्ति द्वारा अलग होते हैं।

यह टूल स्ट्रीम को इवेंट में कैसे बाँटता है?

यह SSE डिस्पैच मॉडल का पालन करता है: इनपुट को पंक्तियों में बाँटा जाता है, लगातार गैर-रिक्त पंक्तियाँ एक इवेंट ब्लॉक बनाती हैं, और एक रिक्त पंक्ति उस ब्लॉक को नए इवेंट के रूप में डिस्पैच करती है। अंतिम ब्लॉक बिना रिक्त पंक्ति के भी उत्सर्जित होता है, और कोलन से शुरू होने वाली कमेंट पंक्तियाँ अनदेखा की जाती हैं।

आउटपुट JSON कैसा दिखता है?

परिणाम एक JSON ऐरा होता है। हर इनपुट इवेंट मौजूद फ़ील्ड के साथ id, event, data के स्थिर क्रम में एक ऑब्जेक्ट बनता है। `data` टेक्स्ट को JSON.parse से पार्स किया जाता है, इसलिए `data: {"a":1}` जैसा पेलोड एक बचे हुए स्ट्रिंग के बजाय नेस्टेड ऑब्जेक्ट `"data": {"a":1}` बन जाता है।

आउटपुट में id एक संख्या क्यों होता है?

SSE id तकनीकी रूप से स्ट्रिंग होते हैं, पर असली पुश स्ट्रीम लगभग हमेशा `id: 0` जैसे संख्यात्मक id इस्तेमाल करते हैं। जब id केवल अंकों से बना हो, तो कन्वर्टर उसे JSON नंबर के रूप में देता है; कोई अन्य id स्ट्रिंग ही रखा जाता है।

जब data एक से अधिक पंक्तियों में फैला हो तो क्या होता है?

SSE विनिर्देश के अनुसार, एक ही इवेंट के भीतर कई `data:` पंक्तियों को एक मान के रूप में पार्स करने से पहले न्यूलाइन अक्षर से जोड़ा जाता है। यदि जोड़ा गया टेक्स्ट मान्य JSON नहीं है, तो कन्वर्टर कच्चा टेक्स्ट रखता है और कुछ भी चुपचाप न खो जाए, इसके लिए एक चेतावनी जोड़ता है।

यदि कोई data पेलोड मान्य JSON नहीं है तो क्या होगा?

पूरे कन्वर्ज़न को विफल करने के बजाय, वह इवेंट कच्चे data को JSON स्ट्रिंग के रूप में रखता है और पेज ब्लॉक क्रमांक तथा पार्सर त्रुटि संदेश के साथ चेतावनी दिखाता है। आसपास के वैध इवेंट सामान्य रूप से बदलते रहते हैं।

SSE से JSON और JSONL फ़ॉर्मेटर में क्या अंतर है?

JSONL में हर पंक्ति पर एक संपूर्ण JSON ऑब्जेक्ट होता है। SSE में इसके बजाय लेबल वाली `id/event/data` पंक्तियाँ होती हैं जो रिक्त पंक्तियों से इवेंट में समूहबद्ध होती हैं, और केवल data भाग JSON होता है। SSE से JSON इन फ़ील्ड लेबल और रिक्त-पंक्ति इवेंट सीमाओं को समझता है, जबकि JSONL फ़ॉर्मेटर हर पंक्ति को स्वतंत्र रूप से देखता।

क्या यह कन्वर्टर मेरी स्ट्रीम डेटा अपलोड करता है?

नहीं। पार्सिंग और फ़ॉर्मेटिंग पूरी तरह आपके ब्राउज़र में चलती है, इसलिए पुश डेटा, टोकन और बातचीत की सामग्री आपकी मशीन से कभी बाहर नहीं जाती।

शब्दकोश

SSE
Server-Sent Events; HTTP पर सर्वर से क्लाइंट तक एकदिशीय पुश स्ट्रीमिंग का एक मानक।
text/event-stream
SSE रिस्पॉन्स बॉडी का MIME मीडिया टाइप, जिसमें रिक्त पंक्तियों से अलग फ़ील्ड पंक्तियाँ होती हैं।
इवेंट ब्लॉक
लगातार गैर-रिक्त फ़ील्ड पंक्तियों का एक समूह जो मिलकर एक पुश इवेंट का वर्णन करता है और रिक्त पंक्ति से समाप्त होता है।
data फ़ील्ड
SSE फ़ील्ड जो इवेंट पेलोड ले जाती है; एक इवेंट में कई data पंक्तियाँ न्यूलाइन से जोड़ी जाती हैं और आमतौर पर JSON होती हैं।
event फ़ील्ड
वैकल्पिक फ़ील्ड जो इवेंट प्रकार का नाम देती है; अनुपस्थित होने पर ब्राउज़र उसे सामान्य 'message' इवेंट के रूप में डिस्पैच करता है।
id फ़ील्ड
स्ट्रीम को फिर से शुरू करने के लिए इस्तेमाल होने वाला वैकल्पिक last-event-id मान; यह कन्वर्टर संख्यात्मक id को JSON नंबर के रूप में देता है।
retry फ़ील्ड
एक वैकल्पिक फ़ील्ड जो क्लाइंट को मिलीसेकंड में पुनः कनेक्शन प्रतीक्षा बताती है; इसमें केवल ASCII अंक होने चाहिए।
कमेंट पंक्ति
कोलन से शुरू होने वाली पंक्ति, जिसे अक्सर heartbeat या keep-alive के रूप में इस्तेमाल किया जाता है और इवेंट बनाते समय अनदेखा की जाती है।

Authoritative References