Firebase रीयल टाइम डेटाबेस
फ़ंक्शन
फ़ंक्शन | ब्यौरा |
---|---|
फ़ंक्शन(ऐप्लिकेशन, ...) | |
getDatabase(ऐप्लिकेशन, यूआरएल) | यह रीयल टाइम डेटाबेस SDK टूल का इंस्टेंस दिखाता है, जो दिए गए FirebaseApp से जुड़ा होता है. अगर कोई इंस्टेंस मौजूद नहीं है या मौजूदा इंस्टेंस, कस्टम डेटाबेस यूआरएल का इस्तेमाल करता है, तो डिफ़ॉल्ट सेटिंग के साथ नया इंस्टेंस शुरू करता है. |
फ़ंक्शन(db, ...) | |
connectDatabaseEmulator(db, होस्ट, पोर्ट, विकल्प) | रीयलटाइम डेटाबेस एम्युलेटर से संपर्क करने के लिए, दिए गए इंस्टेंस में बदलाव करें. ध्यान दें: कोई भी अन्य कार्रवाई करने से पहले, इस तरीके को कॉल करना ज़रूरी है. |
goऑफ़लाइन(db) | सर्वर से डिसकनेक्ट हो जाता है (सभी डेटाबेस कार्रवाइयां ऑफ़लाइन पूरी हो जाएंगी).क्लाइंट अपने आप डेटाबेस सर्वर से स्थायी कनेक्शन बनाए रखता है, जो अनिश्चित काल तक सक्रिय रहता है और डिसकनेक्ट किए जाने पर फिर से कनेक्ट होता है. हालांकि, जिन मामलों में स्थायी कनेक्शन की ज़रूरत नहीं होती उनमें क्लाइंट कनेक्शन को कंट्रोल करने के लिए, goOffline() और goOnline() तरीकों का इस्तेमाल किया जा सकता है.ऑफ़लाइन होने पर, क्लाइंट को डेटाबेस से डेटा के अपडेट नहीं मिलेंगे. हालांकि, स्थानीय तौर पर की गई सभी डेटाबेस कार्रवाइयां तुरंत इवेंट ट्रिगर करती रहेंगी. इससे, आपका ऐप्लिकेशन सामान्य तरीके से काम करता रहेगा. इसके अलावा, स्थानीय तौर पर की जाने वाली हर कार्रवाई अपने-आप सूची में जुड़ जाएगी और डेटाबेस सर्वर से फिर से कनेक्ट होने पर फिर से कोशिश की जाएगी.डेटाबेस से फिर से कनेक्ट करने और रिमोट इवेंट पाना शुरू करने के लिए, goOnline() देखें. |
goOnline(db) | सर्वर से कनेक्ट करता है और ऑफ़लाइन डेटाबेस की स्थिति को सर्वर की स्थिति के साथ सिंक करता है.इस तरीके का इस्तेमाल, goOffline() के साथ ऐक्टिव कनेक्शन को बंद करने के बाद किया जाना चाहिए. फिर से कनेक्ट होने पर, क्लाइंट उचित डेटा ट्रांसमिट करेगा और उचित इवेंट फ़ायर करेगा, ताकि आपका क्लाइंट "कैच करे" स्वचालित रूप से. |
ref(db, path) | दिए गए पाथ से जुड़े डेटाबेस में जगह की जानकारी दिखाने वाला Reference दिखाता है. अगर कोई पाथ नहीं दिया गया है, तो Reference , डेटाबेस के रूट पर ले जाएगा. |
refFromURL(db, यूआरएल) | दिए गए Firebase यूआरएल से जुड़े डेटाबेस में जगह को दिखाने वाला Reference दिखाता है.अगर यूआरएल एक मान्य Firebase डेटाबेस यूआरएल नहीं है या उसका डोमेन मौजूदा Database इंस्टेंस से अलग है, तो एक अपवाद होता है.ध्यान दें कि सभी क्वेरी पैरामीटर (orderBy , limitToLast वगैरह) को अनदेखा कर दिया जाता है और उन्हें दिए गए Reference पर लागू नहीं किया जाता है. |
फ़ंक्शन() | |
forceLongPolling() | वेबसॉकेट के बजाय, longPolling का इस्तेमाल करें. अगर डेटाबेस यूआरएल में websocket प्रोटोकॉल का इस्तेमाल किया जाता है, तो इसे अनदेखा कर दिया जाएगा. |
forceWebSockets() | ज़बरदस्ती, longPolling के बजाय websockets का इस्तेमाल करें. |
orderByKey() | एक नया QueryConstraint बनाता है, जो कुंजी के हिसाब से क्रम में लगा होता है.क्वेरी के नतीजों को उनकी (बढ़ती हुई) मुख्य वैल्यू के हिसाब से क्रम में लगाता है.आप orderByKey() के बारे में ज़्यादा जानने के लिए, डेटा क्रम से लगाएं में जा सकते हैं. |
orderByPolicy() | एक नया QueryConstraint बनाता है, जो प्राथमिकता के हिसाब से ऑर्डर करता है.ऐप्लिकेशन के लिए प्राथमिकता का इस्तेमाल करना ज़रूरी नहीं है, लेकिन वे सामान्य प्रॉपर्टी के हिसाब से कलेक्शन को क्रम से लगा सकते हैं. प्राथमिकता के विकल्पों के लिए डेटा क्रम से लगाएं देखें. |
orderByValue() | वैल्यू के हिसाब से क्रम में लगाने वाला एक नया QueryConstraint बनाता है.अगर किसी क्वेरी के चाइल्ड सभी अदिश वैल्यू (स्ट्रिंग, संख्या या बूलियन) हैं, तो नतीजों को उनके (बढ़ते क्रम में) वैल्यू के हिसाब से क्रम में लगाया जा सकता है.orderByValue() के बारे में ज़्यादा जानने के लिए, डेटा क्रम से लगाएं में जाएं. |
servertimestamp() | Firebase सर्वर की ओर से तय किए गए मौजूदा टाइमस्टैंप (Unix epoch के बाद से समय, मिलीसेकंड में) को अपने-आप भरने के लिए, प्लेसहोल्डर वैल्यू दिखाता है. |
फ़ंक्शन(डेल्टा, ...) | |
increment(delta) | ऐसा प्लेसहोल्डर वैल्यू दिखाता है जिसका इस्तेमाल, दिए गए डेल्टा के हिसाब से मौजूदा डेटाबेस वैल्यू को अपने-आप बढ़ाने के लिए किया जा सकता है. |
फ़ंक्शन(चालू किया गया, ...) | |
enableLogging(चालू किया गया, स्थायी) | कंसोल में डीबग करने की जानकारी लॉग करता है. |
फ़ंक्शन(limit, ...) | |
limitToFirst(limit) | एक नया QueryConstraint बनाता है, जो पहली बार बच्चों की संख्या तक सीमित होता है.limitToFirst() तरीके का इस्तेमाल, किसी दिए गए कॉलबैक में ज़्यादा से ज़्यादा बच्चों को सिंक करने के लिए किया जाता है. अगर हम 100 की सीमा सेट करते हैं, तो शुरुआत में हमें सिर्फ़ 100 child_added इवेंट मिलेंगे. अगर हमारे डेटाबेस में 100 से कम मैसेज सेव हैं, तो हर मैसेज के लिए child_added इवेंट ट्रिगर होगा. हालांकि, अगर हमारे पास 100 से ज़्यादा मैसेज हैं, तो हमें ऑर्डर किए गए पहले 100 मैसेज के लिए ही एक child_added इवेंट मिलेगा. आइटम में बदलाव होने पर, हमें हर उस आइटम के लिए child_removed इवेंट मिलेंगे जो ऐक्टिव लिस्ट से बाहर हो जाते हैं, ताकि कुल संख्या 100 बनी रहे.डेटा फ़िल्टर करने की सुविधा में जाकर, limitToFirst() के बारे में ज़्यादा जानें. |
limitToLast(limit) | एक ऐसा नया QueryConstraint बनाता है जो सिर्फ़ आखिरी बार तय किए गए चिल्ड्रेन की संख्या दिखाता है.limitToLast() तरीके का इस्तेमाल, किसी दिए गए कॉलबैक के लिए सिंक किए जाने वाले चिल्ड्रन सेट करने के लिए किया जाता है. अगर हम 100 की सीमा सेट करते हैं, तो शुरुआत में हमें सिर्फ़ 100 child_added इवेंट मिलेंगे. अगर हमारे डेटाबेस में 100 से कम मैसेज सेव हैं, तो हर मैसेज के लिए child_added इवेंट ट्रिगर होगा. हालांकि, अगर हमारे पास 100 से ज़्यादा मैसेज हैं, तो हमें ऑर्डर किए गए आखिरी 100 मैसेज के लिए ही एक child_added इवेंट मिलेगा. आइटम में बदलाव होने पर, हमें हर उस आइटम के लिए child_removed इवेंट मिलेंगे जो ऐक्टिव लिस्ट से बाहर हो जाते हैं, ताकि कुल संख्या 100 बनी रहे.डेटा फ़िल्टर करने की सुविधा में जाकर, limitToLast() के बारे में ज़्यादा जानें. |
फ़ंक्शन(लॉगर, ...) | |
enableLogging(logger) | कंसोल में डीबग करने की जानकारी लॉग करता है. |
फ़ंक्शन(पैरंट, ...) | |
बच्चा(पैरंट, पाथ) | तय किए गए रिलेटिव पाथ पर जगह के लिए, Reference मिलता है.रिलेटिव पाथ, कोई आसान चाइल्ड नाम (उदाहरण के लिए, "ada") या स्लैश से अलग किया गया पाथ हो सकता है, जैसे कि "ada/name/first". |
पुश(पैरंट, वैल्यू) | यूनीक कुंजी का इस्तेमाल करके, नई चाइल्ड लोकेशन जनरेट करता है और उसका Reference दिखाता है.आइटम के कलेक्शन में डेटा जोड़ने का यह सबसे आम पैटर्न है.अगर push() के लिए वैल्यू दी जाती है, तो वैल्यू जनरेट की गई जगह पर लिखी जाती है. अगर कोई वैल्यू पास नहीं की जाती है, तो डेटाबेस में कुछ भी लिखा नहीं जाता है और चाइल्ड एंट्री खाली रहती है (हालांकि, Reference का इस्तेमाल कहीं और भी किया जा सकता है).push() से जनरेट हुई यूनीक कुंजियों को मौजूदा समय के हिसाब से क्रम में लगाया जाता है. इससे, आइटम की बनने वाली सूची में, तारीख के हिसाब से क्रम में लगाया जाता है. कुंजियों को इस तरह से भी डिज़ाइन किया गया है कि अनुमान न लगाया जा सके (इनमें एंट्रॉपी के 72 रैंडम बिट होते हैं).डेटा की सूची में जोड़ें देखें. यूनीक आइडेंटिफ़ायर पक्का करने के 2^120 तरीके देखें. |
फ़ंक्शन(पाथ, ...) | |
orderByChild(पाथ) | एक नया QueryConstraint बनाता है, जो बताए गए चाइल्ड कुंजी के हिसाब से क्रम में लगाता है.क्वेरी को एक बार में सिर्फ़ एक कुंजी के ज़रिए ऑर्डर किया जा सकता है. एक ही क्वेरी पर orderByChild() को कई बार कॉल करने में गड़बड़ी होती है.Firebase क्वेरी की मदद से, किसी भी चाइल्ड कुंजी के ज़रिए तुरंत अपना डेटा ऑर्डर किया जा सकता है. हालांकि, अगर आपको पहले से पता है कि आपके इंडेक्स क्या होंगे, तो बेहतर परफ़ॉर्मेंस के लिए, अपने सुरक्षा नियमों में .indexOn नियम की मदद से उन्हें तय किया जा सकता है. ज़्यादा जानकारी के लिए, https://firebase.google.com/docs/database/security/indexing-data नियम देखें.डेटा क्रम से लगाएं में जाकर, orderByChild() के बारे में ज़्यादा जानें. |
फ़ंक्शन(क्वेरी, ...) | |
get(query) | इस क्वेरी के लिए सबसे अप-टू-डेट नतीजे पाएं. |
off(query, eventType, कॉलबैक) | इससे, on() (onValue , onChildAdded ) लिसनर के साथ पहले से अटैच किए गए कॉलबैक को अलग करता है. ध्यान दें: यह लिसनर हटाने का सुझाया गया तरीका नहीं है. इसके बजाय, कृपया on कॉलबैक से, लौटाए गए कॉलबैक फ़ंक्शन का इस्तेमाल करें.on*() के साथ पहले से अटैच किए गए कॉलबैक को अलग करें. पैरंट लिसनर पर off() को कॉल करने से, चाइल्ड नोड पर रजिस्टर किए गए लिसनर अपने-आप नहीं हटेंगे. कॉलबैक को हटाने के लिए, off() को चाइल्ड लिसनर पर भी कॉल किया जाना चाहिए.अगर कोई कॉलबैक तय नहीं किया गया है, तो तय eventType के लिए सभी कॉलबैक हटा दिए जाएंगे. इसी तरह, अगर कोई eventType तय नहीं है, तो Reference के लिए सभी कॉलबैक हटा दिए जाएंगे.सदस्यता छोड़ने वाले कॉलबैक को शुरू करके भी अलग-अलग लिसनर को हटाया जा सकता है. |
onchild जोड़ा गया(क्वेरी, कॉलबैक, cancelCallback) | किसी खास जगह पर डेटा में बदलाव के लिए सुनता है.यह किसी डेटाबेस से डेटा पढ़ने का मुख्य तरीका है. आपके कॉलबैक को शुरुआती डेटा के लिए ट्रिगर किया जाएगा. इसके बाद, डेटा में बदलाव होने पर यह फिर से ट्रिगर होगा. अपडेट पाने की सुविधा बंद करने के लिए, 'सदस्यता छोड़ें' कॉलबैक को शुरू करें. ज़्यादा जानकारी के लिए, वेब पर डेटा वापस पाना देखें.इस जगह पर, हर शुरुआती चाइल्ड के लिए onChildAdded इवेंट एक बार ट्रिगर होगा. नया चाइल्ड जोड़ने पर, यह इवेंट फिर से ट्रिगर होगा. कॉलबैक में पास किया गया DataSnapshot , काम के चाइल्ड खाते का डेटा दिखाएगा. ऑर्डर करने के लिए, इसे दूसरा आर्ग्युमेंट दिया जाता है, जो क्रम से लगाए गए पिछले सिबलिंग चाइल्ड की की स्ट्रिंग होती है. इसके अलावा, अगर यह पहला चाइल्ड है, तो इसे null दिया जाता है. |
on चाइल्ड जोड़ा गया(क्वेरी, कॉलबैक, विकल्प) | किसी खास जगह पर डेटा में बदलाव के लिए सुनता है.यह किसी डेटाबेस से डेटा पढ़ने का मुख्य तरीका है. आपके कॉलबैक को शुरुआती डेटा के लिए ट्रिगर किया जाएगा. इसके बाद, डेटा में बदलाव होने पर यह फिर से ट्रिगर होगा. अपडेट पाने की सुविधा बंद करने के लिए, 'सदस्यता छोड़ें' कॉलबैक को शुरू करें. ज़्यादा जानकारी के लिए, वेब पर डेटा वापस पाना देखें.इस जगह पर, हर शुरुआती चाइल्ड के लिए onChildAdded इवेंट एक बार ट्रिगर होगा. नया चाइल्ड जोड़ने पर, यह इवेंट फिर से ट्रिगर होगा. कॉलबैक में पास किया गया DataSnapshot , काम के चाइल्ड खाते का डेटा दिखाएगा. ऑर्डर करने के लिए, इसे दूसरा आर्ग्युमेंट दिया जाता है, जो क्रम से लगाए गए पिछले सिबलिंग चाइल्ड की की स्ट्रिंग होती है. इसके अलावा, अगर यह पहला चाइल्ड है, तो इसे null दिया जाता है. |
onChild जोड़ा गया(क्वेरी, कॉलबैक, cancelCallback, विकल्प) | किसी खास जगह पर डेटा में बदलाव के लिए सुनता है.यह किसी डेटाबेस से डेटा पढ़ने का मुख्य तरीका है. आपके कॉलबैक को शुरुआती डेटा के लिए ट्रिगर किया जाएगा. इसके बाद, डेटा में बदलाव होने पर यह फिर से ट्रिगर होगा. अपडेट पाने की सुविधा बंद करने के लिए, 'सदस्यता छोड़ें' कॉलबैक को शुरू करें. ज़्यादा जानकारी के लिए, वेब पर डेटा वापस पाना देखें.इस जगह पर, हर शुरुआती चाइल्ड के लिए onChildAdded इवेंट एक बार ट्रिगर होगा. नया चाइल्ड जोड़ने पर, यह इवेंट फिर से ट्रिगर होगा. कॉलबैक में पास किया गया DataSnapshot , काम के चाइल्ड खाते का डेटा दिखाएगा. ऑर्डर करने के लिए, इसे दूसरा आर्ग्युमेंट दिया जाता है, जो क्रम से लगाए गए पिछले सिबलिंग चाइल्ड की की स्ट्रिंग होती है. इसके अलावा, अगर यह पहला चाइल्ड है, तो इसे null दिया जाता है. |
onchildChanged(क्वेरी, कॉलबैक, cancelCallback) | किसी खास जगह पर डेटा में बदलाव के लिए सुनता है.यह किसी डेटाबेस से डेटा पढ़ने का मुख्य तरीका है. आपके कॉलबैक को शुरुआती डेटा के लिए ट्रिगर किया जाएगा. इसके बाद, डेटा में बदलाव होने पर यह फिर से ट्रिगर होगा. अपडेट पाने की सुविधा बंद करने के लिए, 'सदस्यता छोड़ें' कॉलबैक को शुरू करें. ज़्यादा जानकारी के लिए, वेब पर डेटा वापस पाना लेख पढ़ें.किसी बच्चे (या उसके किसी डिसेंडेंट) में सेव किए गए डेटा में बदलाव होने पर, onChildChanged इवेंट ट्रिगर होगा. ध्यान दें कि एक child_changed इवेंट में, चाइल्ड खाते में कई बदलाव किए जा सकते हैं. कॉलबैक को पास किए गए DataSnapshot में, नया चाइल्ड कॉन्टेंट शामिल होगा. ऑर्डर करने के लिए, कॉलबैक को दूसरा आर्ग्युमेंट भी पास किया जाता है, जो क्रम में लगाए गए पिछले सिबलिंग चाइल्ड की की स्ट्रिंग होती है. अगर यह पहला चाइल्ड है, तो इसे null का इस्तेमाल करके भी ऑर्डर किया जा सकता है. |
onchildChanged(क्वेरी, कॉलबैक, विकल्प) | किसी खास जगह पर डेटा में बदलाव के लिए सुनता है.यह किसी डेटाबेस से डेटा पढ़ने का मुख्य तरीका है. आपके कॉलबैक को शुरुआती डेटा के लिए ट्रिगर किया जाएगा. इसके बाद, डेटा में बदलाव होने पर यह फिर से ट्रिगर होगा. अपडेट पाने की सुविधा बंद करने के लिए, 'सदस्यता छोड़ें' कॉलबैक को शुरू करें. ज़्यादा जानकारी के लिए, वेब पर डेटा वापस पाना लेख पढ़ें.किसी बच्चे (या उसके किसी डिसेंडेंट) में सेव किए गए डेटा में बदलाव होने पर, onChildChanged इवेंट ट्रिगर होगा. ध्यान दें कि एक child_changed इवेंट में, चाइल्ड खाते में कई बदलाव किए जा सकते हैं. कॉलबैक को पास किए गए DataSnapshot में, नया चाइल्ड कॉन्टेंट शामिल होगा. ऑर्डर करने के लिए, कॉलबैक को दूसरा आर्ग्युमेंट भी पास किया जाता है, जो क्रम में लगाए गए पिछले सिबलिंग चाइल्ड की की स्ट्रिंग होती है. अगर यह पहला चाइल्ड है, तो इसे null का इस्तेमाल करके भी ऑर्डर किया जा सकता है. |
onChildChanged(क्वेरी, कॉलबैक, cancelCallback, विकल्प) | किसी खास जगह पर डेटा में बदलाव के लिए सुनता है.यह किसी डेटाबेस से डेटा पढ़ने का मुख्य तरीका है. आपके कॉलबैक को शुरुआती डेटा के लिए ट्रिगर किया जाएगा. इसके बाद, डेटा में बदलाव होने पर यह फिर से ट्रिगर होगा. अपडेट पाने की सुविधा बंद करने के लिए, 'सदस्यता छोड़ें' कॉलबैक को शुरू करें. ज़्यादा जानकारी के लिए, वेब पर डेटा वापस पाना लेख पढ़ें.किसी बच्चे (या उसके किसी डिसेंडेंट) में सेव किए गए डेटा में बदलाव होने पर, onChildChanged इवेंट ट्रिगर होगा. ध्यान दें कि एक child_changed इवेंट में, चाइल्ड खाते में कई बदलाव किए जा सकते हैं. कॉलबैक को पास किए गए DataSnapshot में, नया चाइल्ड कॉन्टेंट शामिल होगा. ऑर्डर करने के लिए, कॉलबैक को दूसरा आर्ग्युमेंट भी पास किया जाता है, जो क्रम में लगाए गए पिछले सिबलिंग चाइल्ड की की स्ट्रिंग होती है. अगर यह पहला चाइल्ड है, तो इसे null का इस्तेमाल करके भी ऑर्डर किया जा सकता है. |
onchildMoved(क्वेरी, कॉलबैक, cancelCallback) | किसी खास जगह पर डेटा में बदलाव के लिए सुनता है.यह किसी डेटाबेस से डेटा पढ़ने का मुख्य तरीका है. आपके कॉलबैक को शुरुआती डेटा के लिए ट्रिगर किया जाएगा. इसके बाद, डेटा में बदलाव होने पर यह फिर से ट्रिगर होगा. अपडेट पाने की सुविधा बंद करने के लिए, 'सदस्यता छोड़ें' कॉलबैक को शुरू करें. ज़्यादा जानकारी के लिए, वेब पर डेटा वापस पाना लेख पढ़ें.जब किसी बच्चे के, क्रम से लगाने के क्रम में ऐसे बदलाव होते हैं कि उसकी जगह उसके सिबलिंग से जुड़े क्रम में बदल जाती है, तो onChildMoved इवेंट ट्रिगर हो जाएगा. कॉलबैक को दिया गया DataSnapshot , बच्चे के डेटा के लिए होगा. इसे दूसरा आर्ग्युमेंट भी पास किया गया है, जो एक ऐसी स्ट्रिंग है जिसमें क्रम से लगाने के हिसाब से, पिछले सिबलिंग चाइल्ड की कुंजी है. अगर यह पहला चाइल्ड है, तो null भी इस आर्ग्युमेंट को पास किया जा सकता है. |
onchildMoved(क्वेरी, कॉलबैक, विकल्प) | किसी खास जगह पर डेटा में बदलाव के लिए सुनता है.यह किसी डेटाबेस से डेटा पढ़ने का मुख्य तरीका है. आपके कॉलबैक को शुरुआती डेटा के लिए ट्रिगर किया जाएगा. इसके बाद, डेटा में बदलाव होने पर यह फिर से ट्रिगर होगा. अपडेट पाने की सुविधा बंद करने के लिए, 'सदस्यता छोड़ें' कॉलबैक को शुरू करें. ज़्यादा जानकारी के लिए, वेब पर डेटा वापस पाना लेख पढ़ें.जब किसी बच्चे के, क्रम से लगाने के क्रम में ऐसे बदलाव होते हैं कि उसकी जगह उसके सिबलिंग से जुड़े क्रम में बदल जाती है, तो onChildMoved इवेंट ट्रिगर हो जाएगा. कॉलबैक को दिया गया DataSnapshot , बच्चे के डेटा के लिए होगा. इसे दूसरा आर्ग्युमेंट भी पास किया गया है, जो एक ऐसी स्ट्रिंग है जिसमें क्रम से लगाने के हिसाब से, पिछले सिबलिंग चाइल्ड की कुंजी है. अगर यह पहला चाइल्ड है, तो null भी इस आर्ग्युमेंट को पास किया जा सकता है. |
onchildMoved(क्वेरी, कॉलबैक, cancelCallback, विकल्प) | किसी खास जगह पर डेटा में बदलाव के लिए सुनता है.यह किसी डेटाबेस से डेटा पढ़ने का मुख्य तरीका है. आपके कॉलबैक को शुरुआती डेटा के लिए ट्रिगर किया जाएगा. इसके बाद, डेटा में बदलाव होने पर यह फिर से ट्रिगर होगा. अपडेट पाने की सुविधा बंद करने के लिए, 'सदस्यता छोड़ें' कॉलबैक को शुरू करें. ज़्यादा जानकारी के लिए, वेब पर डेटा वापस पाना लेख पढ़ें.जब किसी बच्चे के, क्रम से लगाने के क्रम में ऐसे बदलाव होते हैं कि उसकी जगह उसके सिबलिंग से जुड़े क्रम में बदल जाती है, तो onChildMoved इवेंट ट्रिगर हो जाएगा. कॉलबैक को दिया गया DataSnapshot , बच्चे के डेटा के लिए होगा. इसे दूसरा आर्ग्युमेंट भी पास किया गया है, जो एक ऐसी स्ट्रिंग है जिसमें क्रम से लगाने के हिसाब से, पिछले सिबलिंग चाइल्ड की कुंजी है. अगर यह पहला चाइल्ड है, तो null भी इस आर्ग्युमेंट को पास किया जा सकता है. |
onchildRemoved(क्वेरी, कॉलबैक, cancelCallback) | किसी खास जगह पर डेटा में बदलाव के लिए सुनता है.यह किसी डेटाबेस से डेटा पढ़ने का मुख्य तरीका है. आपके कॉलबैक को शुरुआती डेटा के लिए ट्रिगर किया जाएगा. इसके बाद, डेटा में बदलाव होने पर यह फिर से ट्रिगर होगा. अपडेट पाने की सुविधा बंद करने के लिए, 'सदस्यता छोड़ें' कॉलबैक को शुरू करें. ज़्यादा जानकारी के लिए, वेब पर डेटा वापस पाना देखें.जब भी किसी बच्चे को हटाया जाएगा, तब एक बार onChildRemoved इवेंट ट्रिगर होगा. कॉलबैक में दिया गया DataSnapshot , हटाए गए बच्चे का पुराना डेटा होगा. कोई बच्चा तब हटा दिया जाएगा, जब:- कोई क्लाइंट उस चाइल्ड या उसके किसी पूर्वज को साफ़ तौर पर remove() को कॉल करता है - कोई क्लाइंट उस बच्चे या उसके किसी पूर्वज को set(null) कॉल करता है - उस बच्चे ने अपने सभी चाइल्ड क्रम को हटा दिया है - एक क्वेरी है, जिससे हिट क्रम से हिट करने के क्रम में बदलाव हुआ ( |
onChildRemoved(क्वेरी, कॉलबैक, विकल्प) | किसी खास जगह पर डेटा में बदलाव के लिए सुनता है.यह किसी डेटाबेस से डेटा पढ़ने का मुख्य तरीका है. आपके कॉलबैक को शुरुआती डेटा के लिए ट्रिगर किया जाएगा. इसके बाद, डेटा में बदलाव होने पर यह फिर से ट्रिगर होगा. अपडेट पाने की सुविधा बंद करने के लिए, 'सदस्यता छोड़ें' कॉलबैक को शुरू करें. ज़्यादा जानकारी के लिए, वेब पर डेटा वापस पाना देखें.जब भी किसी बच्चे को हटाया जाएगा, तब एक बार onChildRemoved इवेंट ट्रिगर होगा. कॉलबैक में दिया गया DataSnapshot , हटाए गए बच्चे का पुराना डेटा होगा. कोई बच्चा तब हटा दिया जाएगा, जब:- कोई क्लाइंट उस चाइल्ड या उसके किसी पूर्वज को साफ़ तौर पर remove() को कॉल करता है - कोई क्लाइंट उस बच्चे या उसके किसी पूर्वज को set(null) कॉल करता है - उस बच्चे ने अपने सभी चाइल्ड क्रम को हटा दिया है - एक क्वेरी है, जिससे हिट क्रम से हिट करने के क्रम में बदलाव हुआ ( |
onchildRemoved(क्वेरी, कॉलबैक, cancelCallback, विकल्प) | किसी खास जगह पर डेटा में बदलाव के लिए सुनता है.यह किसी डेटाबेस से डेटा पढ़ने का मुख्य तरीका है. आपके कॉलबैक को शुरुआती डेटा के लिए ट्रिगर किया जाएगा. इसके बाद, डेटा में बदलाव होने पर यह फिर से ट्रिगर होगा. अपडेट पाने की सुविधा बंद करने के लिए, 'सदस्यता छोड़ें' कॉलबैक को शुरू करें. ज़्यादा जानकारी के लिए, वेब पर डेटा वापस पाना देखें.जब भी किसी बच्चे को हटाया जाएगा, तब एक बार onChildRemoved इवेंट ट्रिगर होगा. कॉलबैक में दिया गया DataSnapshot , हटाए गए बच्चे का पुराना डेटा होगा. कोई बच्चा तब हटा दिया जाएगा, जब:- कोई क्लाइंट उस चाइल्ड या उसके किसी पूर्वज को साफ़ तौर पर remove() को कॉल करता है - कोई क्लाइंट उस बच्चे या उसके किसी पूर्वज को set(null) कॉल करता है - उस बच्चे ने अपने सभी चाइल्ड क्रम को हटा दिया है - एक क्वेरी है, जिससे हिट क्रम से हिट करने के क्रम में बदलाव हुआ ( |
onValue(query, कॉलबैक, cancelCallback) | किसी खास जगह पर डेटा में बदलाव के लिए सुनता है.यह किसी डेटाबेस से डेटा पढ़ने का मुख्य तरीका है. आपके कॉलबैक को शुरुआती डेटा के लिए ट्रिगर किया जाएगा. इसके बाद, डेटा में बदलाव होने पर यह फिर से ट्रिगर होगा. अपडेट पाने की सुविधा बंद करने के लिए, 'सदस्यता छोड़ें' कॉलबैक को शुरू करें. ज़्यादा जानकारी के लिए, वेब पर डेटा वापस पाना लेख पढ़ें.इस जगह पर सेव किए गए शुरुआती डेटा के साथ, onValue इवेंट एक बार ट्रिगर होगा. साथ ही, डेटा में हर बार बदलाव होने पर, यह इवेंट फिर से ट्रिगर होगा. कॉलबैक को दिया गया DataSnapshot , उस जगह के लिए होगा जहां on() को कॉल किया गया था. यह तब तक ट्रिगर नहीं होगा, जब तक पूरा कॉन्टेंट सिंक नहीं हो जाता. अगर जगह की जानकारी में कोई डेटा नहीं है, तो यह खाली DataSnapshot के साथ ट्रिगर होगा (val() null दिखाएगा). |
onValue(query, कॉलबैक, options) | किसी खास जगह पर डेटा में बदलाव के लिए सुनता है.यह किसी डेटाबेस से डेटा पढ़ने का मुख्य तरीका है. आपके कॉलबैक को शुरुआती डेटा के लिए ट्रिगर किया जाएगा. इसके बाद, डेटा में बदलाव होने पर यह फिर से ट्रिगर होगा. अपडेट पाने की सुविधा बंद करने के लिए, 'सदस्यता छोड़ें' कॉलबैक को शुरू करें. ज़्यादा जानकारी के लिए, वेब पर डेटा वापस पाना लेख पढ़ें.इस जगह पर सेव किए गए शुरुआती डेटा के साथ, onValue इवेंट एक बार ट्रिगर होगा. साथ ही, डेटा में हर बार बदलाव होने पर, यह इवेंट फिर से ट्रिगर होगा. कॉलबैक को दिया गया DataSnapshot , उस जगह के लिए होगा जहां on() को कॉल किया गया था. यह तब तक ट्रिगर नहीं होगा, जब तक पूरा कॉन्टेंट सिंक नहीं हो जाता. अगर जगह की जानकारी में कोई डेटा नहीं है, तो यह खाली DataSnapshot के साथ ट्रिगर होगा (val() null दिखाएगा). |
onValue(query, कॉलबैक, cancelCallback, विकल्प) | किसी खास जगह पर डेटा में बदलाव के लिए सुनता है.यह किसी डेटाबेस से डेटा पढ़ने का मुख्य तरीका है. आपके कॉलबैक को शुरुआती डेटा के लिए ट्रिगर किया जाएगा. इसके बाद, डेटा में बदलाव होने पर यह फिर से ट्रिगर होगा. अपडेट पाने की सुविधा बंद करने के लिए, 'सदस्यता छोड़ें' कॉलबैक को शुरू करें. ज़्यादा जानकारी के लिए, वेब पर डेटा वापस पाना लेख पढ़ें.इस जगह पर सेव किए गए शुरुआती डेटा के साथ, onValue इवेंट एक बार ट्रिगर होगा. साथ ही, डेटा में हर बार बदलाव होने पर, यह इवेंट फिर से ट्रिगर होगा. कॉलबैक को दिया गया DataSnapshot , उस जगह के लिए होगा जहां on() को कॉल किया गया था. यह तब तक ट्रिगर नहीं होगा, जब तक पूरा कॉन्टेंट सिंक नहीं हो जाता. अगर जगह की जानकारी में कोई डेटा नहीं है, तो यह खाली DataSnapshot के साथ ट्रिगर होगा (val() null दिखाएगा). |
क्वेरी(क्वेरी, queryConstraints) | Query का एक ऐसा नया इंस्टेंस बनाता है जो बदला नहीं जा सकता. साथ ही, क्वेरी के लिए बने अन्य कंस्ट्रेंट को भी शामिल करने के लिए ऐसा किया जाता है. |
फ़ंक्शन(रेफ़रंस, ...) | |
ऑनडिसकनेक्ट(रेफ़रंस) | कोई OnDisconnect ऑब्जेक्ट लौटाता है - इसका इस्तेमाल करने के बारे में ज़्यादा जानकारी के लिए, JavaScript में ऑफ़लाइन क्षमताएं चालू करना देखें. |
हटाएं(रेफ़रंस) | इस डेटाबेस स्थान के डेटा को निकालता है.चाइल्ड स्थानों का कोई भी डेटा भी हटा दिया जाएगा.निकालें का प्रभाव तुरंत और संबंधित इवेंट 'मान' में दिखाई देगा ट्रिगर होगा. Firebase के सर्वर पर, हटाए गए प्रॉमिस का सिंक भी शुरू हो जाएगा. पूरा होने पर, लौटाए गए प्रॉमिस की समस्या हल हो जाएगी. अगर दिया गया हो, तो सिंक्रोनाइज़ेशन खत्म होने के बाद, oncomplete कॉलबैक को एसिंक्रोनस रूप से कॉल किया जाएगा. |
runTransaction(ref, transactionUpdate, options) | इस जगह के डेटा में अपने आप बदलाव करता है.इस जगह के डेटा में अपने आप बदलाव करता है. सामान्य set() के उलट, जो अपनी पिछली वैल्यू पर ध्यान दिए बिना सिर्फ़ डेटा को ओवरराइट करता है, runTransaction() का इस्तेमाल मौजूदा वैल्यू को नई वैल्यू में बदलने के लिए किया जाता है. इससे यह पक्का किया जाता है कि एक ही समय पर एक ही जगह पर लिखने वाले दूसरे क्लाइंट से कोई गड़बड़ी न हो.इसके लिए, runTransaction() को अपडेट फ़ंक्शन पास करें. इसका इस्तेमाल मौजूदा वैल्यू को नई वैल्यू में बदलने के लिए किया जाता है. अगर आपकी नई वैल्यू सही से लिखे जाने से पहले कोई दूसरा क्लाइंट उस जगह का नाम लिखता है, तो आपके अपडेट फ़ंक्शन को नई वैल्यू के साथ फिर से कॉल किया जाएगा और डेटा को फिर से लिखने की कोशिश की जाएगी. ऐसा लगातार तब तक होता रहेगा, जब तक आपकी ओर से बदलाव नहीं किया जाता या आप अपडेट फ़ंक्शन से वैल्यू नहीं लौटाकर लेन-देन रद्द कर देते हैं.ध्यान दें: set() के साथ डेटा में बदलाव करने से उस जगह पर सभी बकाया लेन-देन रद्द हो जाएंगे. इसलिए, एक ही डेटा को अपडेट करने के लिए set() और runTransaction() को मिलाने पर ज़्यादा सावधानी बरतनी चाहिए.ध्यान दें: सुरक्षा और Firebase नियमों के साथ लेन-देन का इस्तेमाल करते समय, ग्राहक को .write ऐक्सेस करने के लिए .read का ऐक्सेस चाहिए. ऐसा इसलिए होता है, क्योंकि क्लाइंट-साइड के मामले में, डेटा को अपडेट करने के लिए क्लाइंट को उसे पढ़ना ज़रूरी होता है. |
सेट(रेफ़रंस, वैल्यू) | इस डेटाबेस लोकेशन में डेटा लिखता है.यह इस जगह के किसी भी डेटा को और सभी चाइल्ड लोकेशन के डेटा को ओवरराइट कर देगा.लिखने का असर तुरंत दिखने लगेगा और इससे जुड़े इवेंट ("value", "child_ बजाय" वगैरह) ट्रिगर हो जाएंगे. Firebase के सर्वर के साथ डेटा का सिंक भी शुरू हो जाएगा. साथ ही, लौटाए गए प्रॉमिस की प्रोसेस पूरी होने पर इसका समाधान हो जाएगा. अगर दिया गया हो, तो सिंक करने की प्रोसेस पूरी होने के बाद, onComplete कॉलबैक को एसिंक्रोनस रूप से कॉल किया जाएगा.नई वैल्यू के लिए null को पास करना, remove() को कॉल करने के बराबर है; यानी, इस जगह का पूरा डेटा और सभी चाइल्ड लोकेशन को मिटा दिया जाएगा.set() इस जगह पर सेव की गई प्राथमिकता को हटा देगा, इसलिए अगर प्राथमिकता को सुरक्षित रखना है, तो आपको setWithPriority() का इस्तेमाल करना होगा.ध्यान दें कि set() के साथ डेटा में बदलाव करने से उस जगह के सभी बकाया लेन-देन रद्द हो जाएंगे, इसलिए अगर set() और transaction() को मिलाकर एक ही डेटा बदला जाता है, तो बहुत सावधानी बरतनी चाहिए.एक set() एक "मान" जनरेट करेगा. उस जगह पर हुआ इवेंट जहां set() का इस्तेमाल किया गया था. |
setप्राथमिकता(ref, Priority) | इस डेटाबेस की जगह के डेटा के लिए प्राथमिकता सेट करता है.ऐप्लिकेशन को प्राथमिकता का इस्तेमाल करने की ज़रूरत नहीं है, लेकिन वे सामान्य प्रॉपर्टी के हिसाब से कलेक्शन को क्रम में लगा सकते हैं. (डेटा को क्रम से लगाना और फ़िल्टर करना देखें). |
setWithप्राथमिकता(रेफ़र, वैल्यू, प्राथमिकता) | डेटाबेस की जगह का डेटा लिखता है. set() की तरह, लेकिन उस डेटा के लिए प्राथमिकता के बारे में भी बताता है.ऐप्लिकेशन को प्राथमिकता का इस्तेमाल करने की ज़रूरत नहीं है, लेकिन वे सामान्य प्रॉपर्टी के हिसाब से कलेक्शन को क्रम में लगा सकते हैं. (डेटा को क्रम से लगाना और फ़िल्टर करना देखें). |
update(ref, value) | डेटाबेस में एक साथ कई वैल्यू लिखता है.values आर्ग्युमेंट में प्रॉपर्टी-वैल्यू के एक से ज़्यादा पेयर होते हैं, जिन्हें डेटाबेस में एक साथ लिखा जाएगा. हर चाइल्ड प्रॉपर्टी कोई साधारण प्रॉपर्टी (उदाहरण के लिए, "name") या मौजूदा जगह से अपडेट करने के लिए रिलेटिव पाथ (उदाहरण के लिए, "name/first") हो सकती है.set() तरीके के उलट, update() का इस्तेमाल सिर्फ़ मौजूदा जगह की सिर्फ़ रेफ़र की गई प्रॉपर्टी को अपडेट करने के लिए किया जा सकता है (मौजूदा जगह की सभी चाइल्ड प्रॉपर्टी को बदलने के बजाय).राइट इवेंट का असर 'value' ट्रिगर हो जाएगा. Firebase के सर्वर के साथ डेटा का सिंक भी शुरू हो जाएगा. साथ ही, लौटाए गए प्रॉमिस की प्रोसेस पूरी होने पर इसका समाधान हो जाएगा. अगर दिया गया हो, तो सिंक करने की प्रोसेस पूरी होने के बाद, onComplete कॉलबैक को एसिंक्रोनस रूप से कॉल किया जाएगा.एक update() से एक "वैल्यू" जनरेट होगी उस जगह पर हुआ इवेंट जहां update() में बदलाव किया गया था. इससे कोई फ़र्क़ नहीं पड़ता कि कितने बच्चों के डेटा में बदलाव किया गया है.ध्यान दें कि update() की मदद से डेटा में बदलाव करने पर, उस जगह पर किया गया कोई भी लेन-देन रद्द हो जाएगा. इसलिए, अगर एक ही डेटा में बदलाव करने के लिए update() और transaction() को मिला दिया जाता है, तो ज़्यादा सावधानी बरतनी चाहिए.null को update() में पास करने से इस जगह का डेटा हट जाएगा.एक से ज़्यादा जगहों की जानकारी में बदलाव करने के साथ-साथ और भी बहुत कुछ देखें. |
फ़ंक्शन(वैल्यू, ...) | |
endAt(वैल्यू, की) | बताए गए आखिरी पॉइंट के साथ QueryConstraint बनाता है.startAt() , startAfter() , endBefore() , endAt() , और equalTo() का इस्तेमाल करने पर, आपको अपनी क्वेरी के लिए मनमुताबिक शुरुआती और आखिरी पॉइंट चुनने की सुविधा मिलती है.आखिरी पॉइंट शामिल किया जा सकता है, ताकि सटीक वैल्यू वाले बच्चे क्वेरी में शामिल हो जाएं. क्वेरी की रेंज को और सीमित करने के लिए, वैकल्पिक कुंजी का इस्तेमाल किया जा सकता है. अगर यह तय किया गया है, तो जिन चाइल्ड खातों की वैल्यू तय की गई है उनके लिए भी एक कुंजी का नाम होना चाहिए. यह नाम, उस कुंजी से कम या उसके बराबर होना चाहिए.डेटा फ़िल्टर करने की सुविधा में जाकर, endAt() के बारे में ज़्यादा जानें. |
endbefore(वैल्यू, की) | बताए गए आखिरी पॉइंट (खास तौर पर) के साथ एक QueryConstraint बनाता है.startAt() , startAfter() , endBefore() , endAt() , और equalTo() का इस्तेमाल करने से, आपको अपनी क्वेरी के लिए आर्बिट्रेरी शुरुआती और आखिरी पॉइंट चुनने की सुविधा मिलती है.आखिरी पॉइंट खास है. अगर सिर्फ़ वैल्यू दी गई है, तो तय वैल्यू से कम वैल्यू वाले चाइल्ड खातों को क्वेरी में शामिल किया जाएगा. अगर कोई कुंजी तय की गई है, तो बच्चों की वैल्यू, दी गई वैल्यू से कम या उसके बराबर होनी चाहिए. साथ ही, कुंजी का नाम बताई गई कुंजी से कम होना चाहिए. |
equalTo(वैल्यू, की) | एक QueryConstraint बनाता है जिसमें बताए गए मान से मेल खाने वाले चाइल्ड शामिल होते हैं.startAt() , startAfter() , endBefore() , endAt() और equalTo() का इस्तेमाल करके आप अपनी क्वेरी के लिए मनचाहे तरीके से शुरुआती और आखिरी पॉइंट चुन सकते हैं.वैकल्पिक मुख्य आर्ग्युमेंट का इस्तेमाल क्वेरी की रेंज को और सीमित करने के लिए किया जा सकता है. अगर यह बताया गया है, तो जिन चाइल्ड खातों में यह वैल्यू डाली गई है उनमें भी वही कुंजी होनी चाहिए जो उनके मुख्य नाम के तौर पर सेट हो. इसका इस्तेमाल, एक ही वैल्यू के लिए कई मैच वाले नतीजे के सेट को फ़िल्टर करने के लिए किया जा सकता है.equalTo() के बारे में ज़्यादा जानने के लिए, डेटा फ़िल्टर करना सेक्शन पढ़ें. |
startAfter(वैल्यू, कुंजी) | तय शुरुआती पॉइंट (खास तौर पर) के साथ QueryConstraint बनाता है.startAt() , startAfter() , endBefore() , endAt() , और equalTo() का इस्तेमाल करने से, आपको अपनी क्वेरी के लिए आर्बिट्रेरी शुरुआती और आखिरी पॉइंट चुनने की सुविधा मिलती है.शुरुआती पॉइंट खास है. अगर सिर्फ़ वैल्यू दी गई है, तो तय की गई वैल्यू से ज़्यादा वैल्यू वाले चाइल्ड खातों को क्वेरी में शामिल किया जाएगा. अगर कोई कुंजी तय की गई है, तो चाइल्ड वैल्यू में तय की गई वैल्यू से ज़्यादा या उसके बराबर होनी चाहिए. साथ ही, कुंजी का नाम बताई गई कुंजी से बड़ा होना चाहिए. |
startAt(वैल्यू, कुंजी) | तय किए गए शुरुआती पॉइंट के साथ QueryConstraint बनाता है.startAt() , startAfter() , endBefore() , endAt() , और equalTo() का इस्तेमाल करने पर, आपको अपनी क्वेरी के लिए मनमुताबिक शुरुआती और आखिरी पॉइंट चुनने की सुविधा मिलती है.शुरुआती पॉइंट के डेटा को भी शामिल किया जा सकता है. इसलिए, क्वेरी में जिन चाइल्ड खातों की वैल्यू तय की गई है उन्हें क्वेरी में शामिल किया जाएगा. क्वेरी की रेंज को और सीमित करने के लिए, वैकल्पिक कुंजी का इस्तेमाल किया जा सकता है. अगर यह तय किया गया है, तो जिन चाइल्डों के पास यह वैल्यू है उनके लिए भी एक कुंजी का नाम होना चाहिए. यह नाम, उस कुंजी से ज़्यादा या उसके बराबर होना चाहिए.डेटा फ़िल्टर करने की सुविधा में जाकर, startAt() के बारे में ज़्यादा जानें. |
क्लास
क्लास | ब्यौरा |
---|---|
डेटाबेस | Firebase रीयल टाइम डेटाबेस को दिखाने वाली क्लास. |
DataSnapshot | DataSnapshot में, डेटाबेस की जगह का डेटा होता है.जब भी डेटाबेस से डेटा पढ़ा जाता है, तब आपको DataSnapshot के तौर पर डेटा मिलता है. on() या once() के साथ अटैच किए गए इवेंट कॉलबैक में, DataSnapshot पास किया जाता है. स्नैपशॉट के कॉन्टेंट को JavaScript ऑब्जेक्ट के तौर पर एक्सट्रैक्ट किया जा सकता है. इसके लिए, val() तरीके को कॉल करें. इसके अलावा, चाइल्ड स्नैपशॉट देखने के लिए, child() को कॉल करके स्नैपशॉट देखा जा सकता है. इसके बाद, इसे val() का नाम दिया जा सकता है.DataSnapshot , डेटाबेस की जगह पर डेटा की बेहतर तरीके से जनरेट की गई और नहीं बदली जा सकने वाली कॉपी होती है. इस डेटा में बदलाव नहीं किया जा सकता और न ही यह बदलेगा. डेटा में बदलाव करने के लिए, हमेशा set() तरीके को सीधे Reference पर कॉल करें. |
डिसकनेक्ट होने पर | जब आपका क्लाइंट डेटाबेस सर्वर से डिसकनेक्ट करता है, तो onDisconnect क्लास आपको डेटा लिखने या मिटाने की अनुमति देती है. ये अपडेट होते हैं, चाहे आपका क्लाइंट पूरी तरह से डिसकनेक्ट हो जाए या नहीं, इसलिए कनेक्शन के टूटने या क्लाइंट क्रैश होने पर भी आप डेटा मिटाने के लिए उन पर भरोसा कर सकते हैं.onDisconnect क्लास का सबसे ज़्यादा इस्तेमाल ऐप्लिकेशन में मौजूदगी प्रबंधित करने के लिए किया जाता है, जहां यह पता लगाना उपयोगी होता है कि कितने क्लाइंट कनेक्ट हैं और कब दूसरे क्लाइंट डिसकनेक्ट होते हैं. ज़्यादा जानकारी के लिए, JavaScript में ऑफ़लाइन क्षमताएं चालू करना देखें.डेटाबेस सर्वर पर अनुरोधों के ट्रांसफ़र होने से पहले, कनेक्शन हटाए जाने पर आने वाली समस्याओं से बचने के लिए, कोई भी डेटा लिखने से पहले इन फ़ंक्शन को कॉल किया जाना चाहिए.ध्यान दें कि onDisconnect कार्रवाइयां सिर्फ़ एक बार ट्रिगर होती हैं. अगर आप चाहते हैं कि हर बार डिसकनेक्ट होने पर कोई कार्रवाई हो, तो हर बार फिर से कनेक्ट होने पर आपको onDisconnect कार्रवाइयां फिर से शुरू करनी होंगी. |
QueryConstraint | QueryConstraint का इस्तेमाल, डेटाबेस क्वेरी से मिले दस्तावेज़ों के सेट को सटीक बनाने के लिए किया जाता है. QueryConstraint QueryConstraint |
लेन-देन का नतीजा | runTransaction() की रिज़ॉल्व वैल्यू का टाइप. |
इंटरफ़ेस
इंटरफ़ेस | ब्यौरा |
---|---|
DatabaseReference | DatabaseReference आपके डेटाबेस में एक खास जगह को दिखाता है और उस डेटाबेस में डेटा लिखने या पढ़ने के लिए इसका इस्तेमाल किया जा सकता है.अपने डेटाबेस में रूट या चाइल्ड की जगह की जानकारी देखने के लिए आप ref() या ref("child/path") को कॉल कर सकते हैं.लिखने के काम set() तरीके से किया जाता है और इसे on*() तरीके से पढ़ा जा सकता है. https://firebase.google.com/docs/database/web/read-and-write पर जाएं |
IteratedDataSnapshot | यह Reference के ऐसे चाइल्ड स्नैपशॉट को दिखाता है जिसे दोहराया जा रहा है. कुंजी को कभी भी तय नहीं किया जाएगा. |
सुनने के विकल्प | विकल्प के ऐसे ऑब्जेक्ट जिनका इस्तेमाल लिसनर को पसंद के मुताबिक बनाने के लिए किया जा सकता है. |
क्वेरी | Query , डेटाबेस की जगह के डेटा को क्रम से लगाता है और फ़िल्टर करता है, ताकि चाइल्ड डेटा का सिर्फ़ एक सबसेट शामिल किया जा सके. इसका इस्तेमाल कुछ एट्रिब्यूट (उदाहरण के लिए, डायनासॉर की ऊंचाई) के हिसाब से डेटा इकट्ठा करने के लिए किया जा सकता है. साथ ही, इसका इस्तेमाल आइटम की एक बड़ी सूची (जैसे कि चैट मैसेज) को क्लाइंट के साथ सिंक करने के लिए सही संख्या तक सीमित करने के लिए भी किया जा सकता है. क्वेरी बनाने के लिए, यहां बताए गए एक या उससे ज़्यादा फ़िल्टर के तरीकों को एक साथ चेन करके बनाया जाता है.किसी DatabaseReference की तरह ही, on*() के तरीकों का इस्तेमाल करके, Query से डेटा पाया जा सकता है. आपको अपनी क्वेरी से मैच होने वाले डेटा के सबसेट के लिए, सिर्फ़ इवेंट और DataSnapshot मिलेंगे.ज़्यादा जानकारी के लिए, https://firebase.google.com/docs/database/web/lists-of-data#sorting_and_filtering_data पर जाएं. |
टैब की सुविधा वाली वैल्यू का रेफ़रंस | एक Promise , जो push() से मिलने पर DatabaseReference के तौर पर भी काम कर सकता है. रेफ़रंस फ़ाइल तुरंत उपलब्ध हो जाती है और बैकएंड में राइटिंग के पूरा होने पर, Promise का समाधान हो जाता है. |
लेन-देन के विकल्प | लेन-देन को कॉन्फ़िगर करने के लिए, विकल्प ऑब्जेक्ट. |
उपनामों का प्रकार
उपनाम टाइप करें | ब्यौरा |
---|---|
EventType | इनमें से एक स्ट्रिंग: "value", "child_added", "child_changed", "child_हटाया गया" या "child_moved." |
QueryConstraintType | इस SDK टूल में उपलब्ध अलग-अलग क्वेरी कंस्ट्रेंट के बारे में बताता है. |
सदस्यता छोड़ें | एक कॉलबैक, जिसे लिसनर हटाने के लिए शुरू किया जा सकता है. |
फ़ंक्शन(ऐप्लिकेशन, ...)
getDatabase(ऐप्लिकेशन, यूआरएल)
यह रीयल टाइम डेटाबेस SDK टूल का इंस्टेंस दिखाता है, जो दिए गए FirebaseApp से जुड़ा होता है. अगर कोई इंस्टेंस मौजूद नहीं है या मौजूदा इंस्टेंस, कस्टम डेटाबेस यूआरएल का इस्तेमाल करता है, तो डिफ़ॉल्ट सेटिंग के साथ नया इंस्टेंस शुरू करता है.
हस्ताक्षर:
export declare function getDatabase(app?: FirebaseApp, url?: string): Database;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
ऐप्लिकेशन | FirebaseApp | FirebaseApp इंस्टेंस, जिससे मिला रीयल टाइम डेटाबेस इंस्टेंस जुड़ा होता है. |
url | स्ट्रिंग | रीयल टाइम डेटाबेस के इंस्टेंस का यूआरएल, जिससे कनेक्ट करना है. अगर इस पैरामीटर को उपलब्ध नहीं कराया जाता है, तो SDK टूल, Firebase ऐप्लिकेशन के डिफ़ॉल्ट इंस्टेंस से कनेक्ट हो जाता है. |
लौटाए जाने वाले प्रॉडक्ट:
दिए गए ऐप्लिकेशन का Database
इंस्टेंस.
फ़ंक्शन(db, ...)
ConnectDatabaseEmulator(db, होस्ट, पोर्ट, विकल्प)
रीयलटाइम डेटाबेस एम्युलेटर से संपर्क करने के लिए, दिए गए इंस्टेंस में बदलाव करें.
ध्यान दें: कोई भी अन्य कार्रवाई करने से पहले, इस तरीके को कॉल करना ज़रूरी है.
हस्ताक्षर:
export declare function connectDatabaseEmulator(db: Database, host: string, port: number, options?: {
mockUserToken?: EmulatorMockTokenOptions | string;
}): void;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
db | डेटाबेस | बदलाव करने के लिए इंस्टेंस. |
होस्ट | स्ट्रिंग | एम्युलेटर होस्ट (उदाहरण: localhost) |
पोर्ट | नंबर | एम्युलेटर पोर्ट (उदाहरण: 8080) |
विकल्प | {ockUserToken?: EmulatorMockTokenOptions | स्ट्रिंग; } पर स्विच करने के मकसद से, हमसे संपर्क करने के लिए धन्यवाद. |
लौटाए जाने वाले प्रॉडक्ट:
अमान्य
goऑफ़लाइन(db)
सर्वर से डिसकनेक्ट हो जाता है (सभी डेटाबेस कार्रवाइयां ऑफ़लाइन पूरी हो जाएंगी).
क्लाइंट अपने आप डेटाबेस सर्वर से एक स्थायी कनेक्शन बनाए रखता है, जो अनिश्चित काल तक सक्रिय रहता है और डिसकनेक्ट किए जाने पर फिर से कनेक्ट होता है. हालांकि, अगर आपको लगातार कनेक्शन बनाए रखना है, तो क्लाइंट कनेक्शन को कंट्रोल करने के लिए, goOffline()
और goOnline()
तरीकों का इस्तेमाल किया जा सकता है.
ऑफ़लाइन होने पर, क्लाइंट को डेटाबेस से डेटा के अपडेट नहीं मिलेंगे. हालांकि, स्थानीय तौर पर की गई सभी डेटाबेस कार्रवाइयां तुरंत इवेंट ट्रिगर करती रहेंगी. इससे, आपका ऐप्लिकेशन सामान्य तरीके से काम करता रहेगा. इसके अलावा, डेटाबेस सर्वर से फिर से कनेक्ट होने पर, स्थानीय तौर पर की जाने वाली हर कार्रवाई अपने-आप सूची में जुड़ जाएगी और फिर से कोशिश करने की कोशिश की जाएगी.
डेटाबेस से फिर से कनेक्ट करने और रिमोट इवेंट पाने के लिए, goOnline()
पर जाएं.
हस्ताक्षर:
export declare function goOffline(db: Database): void;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
db | डेटाबेस | डिसकनेक्ट करने का इंस्टेंस. |
लौटाए जाने वाले प्रॉडक्ट:
अमान्य
गोऑनलाइन(db)
सर्वर से फिर से कनेक्ट करता है और ऑफ़लाइन डेटाबेस की स्थिति को सर्वर की स्थिति के साथ सिंक करता है.
goOffline()
के साथ चालू कनेक्शन को बंद करने के बाद, इस तरीके का इस्तेमाल किया जाना चाहिए. फिर से कनेक्ट होने पर, क्लाइंट उचित डेटा ट्रांसमिट करेगा और उचित इवेंट फ़ायर करेगा, ताकि आपका क्लाइंट "कैच करे" स्वचालित रूप से.
हस्ताक्षर:
export declare function goOnline(db: Database): void;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
db | डेटाबेस | फिर से कनेक्ट करने का इंस्टेंस. |
लौटाए जाने वाले प्रॉडक्ट:
अमान्य
ref(db, पाथ)
दिए गए पाथ से जुड़े डेटाबेस में जगह की जानकारी दिखाने वाला Reference
दिखाता है. अगर कोई पाथ नहीं दिया गया है, तो Reference
, डेटाबेस के रूट पर ले जाएगा.
हस्ताक्षर:
export declare function ref(db: Database, path?: string): DatabaseReference;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
db | डेटाबेस | वह डेटाबेस इंस्टेंस जिसके लिए रेफ़रंस लेना है. |
पाथ | स्ट्रिंग | वैकल्पिक पाथ, उस जगह को दिखाता है जो लौटाए गए Reference को पॉइंट करेगा. अगर वैल्यू नहीं दी गई है, तो लौटाया गया Reference , डेटाबेस के रूट पर ले जाएगा. |
लौटाए जाने वाले प्रॉडक्ट:
अगर पाथ दिया गया है, तो दिए गए पाथ पर ले जाने वाला Reference
. अगर ऐसा नहीं है, तो डेटाबेस के रूट की ओर इशारा करता हुआ Reference
.
refFromURL(db, यूआरएल)
दिए गए Firebase यूआरएल से जुड़े डेटाबेस में जगह की जानकारी दिखाने वाला Reference
दिखाता है.
अगर यूआरएल, Firebase डेटाबेस का मान्य यूआरएल नहीं है या उसका डोमेन, मौजूदा Database
इंस्टेंस से अलग है, तो एक अपवाद लागू किया जाता है.
ध्यान दें कि सभी क्वेरी पैरामीटर (orderBy
, limitToLast
वगैरह) को अनदेखा किया जाता है और उन्हें लौटाए गए Reference
पर लागू नहीं किया जाता.
हस्ताक्षर:
export declare function refFromURL(db: Database, url: string): DatabaseReference;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
db | डेटाबेस | वह डेटाबेस इंस्टेंस जिसके लिए रेफ़रंस लेना है. |
url | स्ट्रिंग | वह Firebase यूआरएल जिस पर दिखाया गया Reference ले जाएगा. |
लौटाए जाने वाले प्रॉडक्ट:
दिए गए Firebase यूआरएल पर ले जाने वाला Reference
.
फ़ंक्शन()
forcelongPolling()
वेबसॉकेट के बजाय, longPolling का इस्तेमाल करें. अगर डेटाबेस यूआरएल में websocket प्रोटोकॉल का इस्तेमाल किया जाता है, तो इसे अनदेखा कर दिया जाएगा.
हस्ताक्षर:
export declare function forceLongPolling(): void;
लौटाए जाने वाले प्रॉडक्ट:
अमान्य
forceWebSockets()
ज़बरदस्ती, longPolling के बजाय websockets का इस्तेमाल करें.
हस्ताक्षर:
export declare function forceWebSockets(): void;
लौटाए जाने वाले प्रॉडक्ट:
अमान्य
OrderByKey()
एक नया QueryConstraint
बनाता है, जिसे कुंजी के हिसाब से क्रम में लगाया जाता है.
क्वेरी के नतीजों को उनकी (बढ़ती हुई) कुंजी की वैल्यू के हिसाब से क्रम में लगाता है.
orderByKey()
के बारे में ज़्यादा जानने के लिए, डेटा क्रम से लगाएं पर जाएं.
हस्ताक्षर:
export declare function orderByKey(): QueryConstraint;
लौटाए जाने वाले प्रॉडक्ट:
ऑर्डरबायप्रायॉरिटी()
एक नया QueryConstraint
बनाता है, जो प्राथमिकता के हिसाब से ऑर्डर करता है.
ऐप्लिकेशन को प्राथमिकता देने की ज़रूरत नहीं है, लेकिन वे सामान्य प्रॉपर्टी के हिसाब से कलेक्शन को क्रम से लगा सकते हैं. प्राथमिकता के विकल्पों के बारे में जानने के लिए, डेटा क्रम से लगाएं देखें.
हस्ताक्षर:
export declare function orderByPriority(): QueryConstraint;
लौटाए जाने वाले प्रॉडक्ट:
OrderByValue()
एक नया QueryConstraint
बनाता है, जो वैल्यू के हिसाब से ऑर्डर करता है.
अगर किसी क्वेरी के चाइल्ड सभी अदिश मान (स्ट्रिंग, संख्या या बूलियन) हैं, तो उनके (बढ़ते क्रम में) मानों के मुताबिक नतीजों को क्रम में लगाया जा सकता है.
orderByValue()
के बारे में ज़्यादा जानने के लिए, डेटा क्रम से लगाएं पर जाएं.
हस्ताक्षर:
export declare function orderByValue(): QueryConstraint;
लौटाए जाने वाले प्रॉडक्ट:
सर्वर टाइमस्टैंप()
Firebase सर्वर की ओर से तय किए गए मौजूदा टाइमस्टैंप (Unix epoch के बाद से समय, मिलीसेकंड में) को अपने-आप भरने के लिए, प्लेसहोल्डर वैल्यू दिखाता है.
हस्ताक्षर:
export declare function serverTimestamp(): object;
लौटाए जाने वाले प्रॉडक्ट:
ऑब्जेक्ट
फ़ंक्शन(डेल्टा, ...)
वृद्धि(डेल्टा)
ऐसा प्लेसहोल्डर वैल्यू दिखाता है जिसका इस्तेमाल, दिए गए डेल्टा के हिसाब से मौजूदा डेटाबेस वैल्यू को अपने-आप बढ़ाने के लिए किया जा सकता है.
हस्ताक्षर:
export declare function increment(delta: number): object;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
डेल्टा | नंबर | वह राशि होती है, जिसे वर्तमान मान को स्वचालित रूप से संशोधित करने के लिए किया जाता है. |
लौटाए जाने वाले प्रॉडक्ट:
ऑब्जेक्ट
सर्वर साइड पर डेटा में अपने-आप बदलाव करने के लिए प्लेसहोल्डर वैल्यू.
फ़ंक्शन(चालू किया गया, ...)
enabledLogging(चालू किया गया है, स्थायी)
कंसोल में डीबग करने की जानकारी लॉग करता है.
हस्ताक्षर:
export declare function enableLogging(enabled: boolean, persistent?: boolean): any;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
चालू किया गया | बूलियन | अगर true है, तो लॉगिंग सक्षम करता है, अगर false , तो लॉगिंग अक्षम करता है. |
लगातार | बूलियन | अगर true पेज रीफ़्रेश होता है, तो पेज रीफ़्रेश होने के बीच लॉगिंग स्थिति को याद रखता है. |
लौटाए जाने वाले प्रॉडक्ट:
कोई भी
फ़ंक्शन(सीमा, ...)
लिमिट टू फ़र्स्ट(सीमा)
एक नया QueryConstraint
बनाता है, जो पहली बार बच्चों की संख्या तक सीमित होता है.
limitToFirst()
तरीके का इस्तेमाल करके, किसी दिए गए कॉलबैक में ज़्यादा से ज़्यादा चाइल्ड एंट्री सेट की जाती हैं. अगर हम 100 की सीमा सेट करते हैं, तो शुरुआत में हमें सिर्फ़ 100 child_added
इवेंट मिलेंगे. अगर हमारे डेटाबेस में 100 से कम मैसेज सेव हैं, तो हर मैसेज के लिए child_added
इवेंट ट्रिगर होगा. हालांकि, अगर हमारे पास 100 से ज़्यादा मैसेज हैं, तो हमें ऑर्डर किए गए पहले 100 मैसेज के लिए ही एक child_added
इवेंट मिलेगा. आइटम में बदलाव होने पर, हमें हर उस आइटम के लिए child_removed
इवेंट मिलेंगे जो ऐक्टिव लिस्ट से बाहर हो जाते हैं, ताकि कुल संख्या 100 रहे.
डेटा फ़िल्टर करना में जाकर, limitToFirst()
के बारे में ज़्यादा पढ़ा जा सकता है.
हस्ताक्षर:
export declare function limitToFirst(limit: number): QueryConstraint;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
सीमा | नंबर | इस क्वेरी में शामिल किए जाने वाले नोड की ज़्यादा से ज़्यादा संख्या. |
लौटाए जाने वाले प्रॉडक्ट:
लिमिट(सीमा)
एक नया QueryConstraint
बनाता है, जिसमें सिर्फ़ बच्चों की आखिरी संख्या दिखाई जा सकती है.
limitToLast()
तरीके का इस्तेमाल करके, किसी दिए गए कॉलबैक में ज़्यादा से ज़्यादा चाइल्ड एंट्री सेट की जाती हैं. अगर हम 100 की सीमा सेट करते हैं, तो शुरुआत में हमें सिर्फ़ 100 child_added
इवेंट मिलेंगे. अगर हमारे डेटाबेस में 100 से कम मैसेज सेव हैं, तो हर मैसेज के लिए child_added
इवेंट ट्रिगर होगा. हालांकि, अगर हमारे पास 100 से ज़्यादा मैसेज हैं, तो हमें ऑर्डर किए गए आखिरी 100 मैसेज के लिए ही एक child_added
इवेंट मिलेगा. आइटम में बदलाव होने पर, हमें हर उस आइटम के लिए child_removed
इवेंट मिलेंगे जो ऐक्टिव लिस्ट से बाहर हो जाते हैं, ताकि कुल संख्या 100 रहे.
डेटा फ़िल्टर करना में जाकर, limitToLast()
के बारे में ज़्यादा पढ़ा जा सकता है.
हस्ताक्षर:
export declare function limitToLast(limit: number): QueryConstraint;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
सीमा | नंबर | इस क्वेरी में शामिल किए जाने वाले नोड की ज़्यादा से ज़्यादा संख्या. |
लौटाए जाने वाले प्रॉडक्ट:
फ़ंक्शन(लॉगर, ...)
enabledLogging(logger)
कंसोल में डीबग करने की जानकारी लॉग करता है.
हस्ताक्षर:
export declare function enableLogging(logger: (message: string) => unknown): any;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
लॉगर | (मैसेज: स्ट्रिंग) => जानकारी नहीं है | यह नियंत्रित करने के लिए एक कस्टम लॉगर फ़ंक्शन है कि चीज़ें कैसे लॉग की जाएं. |
लौटाए जाने वाले प्रॉडक्ट:
कोई भी
फ़ंक्शन(पैरंट, ...)
चाइल्ड(पैरंट, पाथ)
बताए गए रिलेटिव पाथ की जगह के लिए Reference
मिलता है.
रिलेटिव पाथ या तो कोई सामान्य चाइल्ड नाम (उदाहरण के लिए, "ada") या स्लैश से अलग किया गया पाथ हो सकता है (उदाहरण के लिए, "ada/name/first").
हस्ताक्षर:
export declare function child(parent: DatabaseReference, path: string): DatabaseReference;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
अभिभावक | DatabaseReference | पैरंट की जगह. |
पाथ | स्ट्रिंग | इस जगह से मनमुताबिक चाइल्ड लोकेशन तक का मिलता-जुलता पाथ. |
लौटाए जाने वाले प्रॉडक्ट:
चाइल्ड की बताई गई जगह.
पुश(पैरंट, वैल्यू)
यूनीक पासकोड का इस्तेमाल करके, एक नई चाइल्ड लोकेशन जनरेट करता है और Reference
दिखाता है.
आइटम के संग्रह में डेटा जोड़ने का यह सबसे सामान्य पैटर्न है.
अगर push()
को कोई वैल्यू दी जाती है, तो जनरेट की गई जगह पर वैल्यू लिखी जाती है. अगर कोई वैल्यू पास नहीं की जाती है, तो डेटाबेस में कुछ भी नहीं लिखा जाता है और चाइल्ड फ़ील्ड खाली रहता है. हालांकि, Reference
का इस्तेमाल कहीं और किया जा सकता है.
push()
से जनरेट की गई खास कुंजियों को मौजूदा समय के हिसाब से क्रम में लगाया जाता है, ताकि आइटम की बनने वाली सूची में समय के हिसाब से क्रम में लगाया जा सके. कुंजियों को इस तरह से भी डिज़ाइन किया गया है कि अनुमान न लगाया जा सके (इनमें एंट्रॉपी के 72 रैंडम बिट होते हैं).
डेटा की सूची में जोड़ें देखें. यूनीक आइडेंटिफ़ायर पक्का करने के 2^120 तरीके देखें.
हस्ताक्षर:
export declare function push(parent: DatabaseReference, value?: unknown): ThenableReference;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
अभिभावक | DatabaseReference | पैरंट की जगह. |
value | अज्ञात | जनरेट की गई जगह पर लिखी जाने वाली वैकल्पिक वैल्यू. |
लौटाए जाने वाले प्रॉडक्ट:
टैब की सुविधा वाली वैल्यू का रेफ़रंस
Promise
और Reference
को मिलाकर; लिखना पूरा होने पर रिज़ॉल्व हो जाता है, लेकिन इसका इस्तेमाल चाइल्ड लोकेशन के लिए Reference
के तौर पर तुरंत किया जा सकता है.
फ़ंक्शन(पाथ, ...)
OrderBychild(पाथ)
एक नया QueryConstraint
बनाता है जो बताए गए चाइल्ड कुंजी के मुताबिक क्रम से लगाता है.
क्वेरी को एक बार में सिर्फ़ एक कुंजी के ज़रिए ऑर्डर किया जा सकता है. एक ही क्वेरी पर orderByChild()
को कई बार कॉल करने में गड़बड़ी होती है.
Firebase क्वेरी की मदद से, अपने डेटा को तुरंत किसी भी चाइल्ड कुंजी के हिसाब से क्रम में लगाया जा सकता है. हालांकि, अगर आपको पहले से पता है कि आपके इंडेक्स क्या होंगे, तो बेहतर परफ़ॉर्मेंस के लिए, अपने सुरक्षा नियमों में .indexOn नियम की मदद से उन्हें तय किया जा सकता है. ज़्यादा जानकारी के लिए, https://firebase.google.com/docs/database/security/indexing-data का नियम देखें.
orderByChild()
के बारे में ज़्यादा जानने के लिए, डेटा क्रम से लगाएं पर जाएं.
हस्ताक्षर:
export declare function orderByChild(path: string): QueryConstraint;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
पाथ | स्ट्रिंग | इसके हिसाब से क्रम में लगाने का पाथ. |
लौटाए जाने वाले प्रॉडक्ट:
फ़ंक्शन(क्वेरी, ...)
पाएं(क्वेरी)
इस क्वेरी के लिए सबसे अप-टू-डेट नतीजे पाएं.
हस्ताक्षर:
export declare function get(query: Query): Promise<DataSnapshot>;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
query | क्वेरी | चलाने के लिए क्वेरी. |
लौटाए जाने वाले प्रॉडक्ट:
प्रॉमिस<DataSnapshot>
एक Promise
, जो वैल्यू के उपलब्ध होने पर नतीजे के तौर पर मिलने वाले DataSnapshot का समाधान करता है. इसके अलावा, क्लाइंट वैल्यू न दे पाने पर, उसे अस्वीकार कर देता है (उदाहरण के लिए, अगर सर्वर तक नहीं पहुंचा जा सकता और कैश मेमोरी में सेव नहीं किया जाता है).
ऑफ़(क्वेरी, eventType, कॉलबैक)
इससे, on*()
(onValue
, onChildAdded
) लिसनर के साथ पहले से अटैच किए गए कॉलबैक को अलग करता है. ध्यान दें: यह लिसनर हटाने का सुझाया गया तरीका नहीं है. इसके बजाय, कृपया on*
कॉलबैक से, लौटाए गए कॉलबैक फ़ंक्शन का इस्तेमाल करें.
on*()
के साथ पहले अटैच किए गए कॉलबैक को अलग करें. पैरंट लिसनर पर off()
को कॉल करने से, चाइल्ड नोड पर रजिस्टर किए गए लिसनर अपने-आप नहीं हटेंगे. कॉलबैक को हटाने के लिए, off()
को चाइल्ड लिसनर पर भी कॉल करना ज़रूरी है.
अगर कोई कॉलबैक तय नहीं किया गया है, तो तय किए गए eventType के लिए सभी कॉलबैक हटा दिए जाएंगे. इसी तरह, अगर कोई eventType तय नहीं किया गया है, तो Reference
के लिए सभी कॉलबैक हटा दिए जाएंगे.
'सदस्यता छोड़ें' कॉलबैक को चालू करके, अलग-अलग लिसनर को भी हटाया जा सकता है.
हस्ताक्षर:
export declare function off(query: Query, eventType?: EventType, callback?: (snapshot: DataSnapshot, previousChildName?: string | null) => unknown): void;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
query | क्वेरी | वह क्वेरी जिसके साथ लिसनर को रजिस्टर किया गया था. |
eventType | EventType | इनमें से एक स्ट्रिंग: "value", "child_added", "child_changed", "child_हटाया गया" या "child_moved." अगर ऐसा नहीं किया जाता है, तो Reference के लिए सभी कॉलबैक हटा दिए जाएंगे. |
कॉलबैक | (स्नैपशॉट: DataSnapshot, lastChildName?: स्ट्रिंग | शून्य) => जानकारी नहीं है | सभी कॉलबैक हटाने के लिए, on() या undefined को पास किया गया कॉलबैक फ़ंक्शन. |
लौटाए जाने वाले प्रॉडक्ट:
अमान्य
onचाइल्ड जोड़ा गया(क्वेरी, कॉलबैक, cancelCallback)
किसी खास जगह के डेटा में हुए बदलावों के बारे में सुनता है.
यह किसी डेटाबेस से डेटा पढ़ने का मुख्य तरीका है. आपके कॉलबैक को शुरुआती डेटा के लिए ट्रिगर किया जाएगा. इसके बाद, डेटा में बदलाव होने पर यह फिर से ट्रिगर होगा. अपडेट पाने की सुविधा बंद करने के लिए, 'सदस्यता छोड़ें' कॉलबैक को शुरू करें. ज़्यादा जानकारी के लिए, वेब पर डेटा वापस पाना देखें.
इस जगह पर, हर शुरुआती चाइल्ड के लिए एक बार onChildAdded
इवेंट ट्रिगर होगा. साथ ही, जब भी नया चाइल्ड जोड़ा जाएगा, यह फिर से ट्रिगर होगा. कॉलबैक में पास किया गया DataSnapshot
, काम के चाइल्ड खाते का डेटा दिखाएगा. ऑर्डर करने के लिए, इसे दूसरा आर्ग्युमेंट दिया जाता है, जो क्रम से लगाए गए पिछले सिबलिंग चाइल्ड की की स्ट्रिंग होती है. इसके अलावा, अगर यह पहला चाइल्ड है, तो इसे null
दिया जाता है.
हस्ताक्षर:
export declare function onChildAdded(query: Query, callback: (snapshot: DataSnapshot, previousChildName?: string | null) => unknown, cancelCallback?: (error: Error) => unknown): Unsubscribe;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
query | क्वेरी | चलाने के लिए क्वेरी. |
कॉलबैक | (स्नैपशॉट: DataSnapshot, lastChildName?: स्ट्रिंग | शून्य) => जानकारी नहीं है | तय किया गया इवेंट होने पर ट्रिगर होने वाला कॉलबैक. कॉलबैक को DataSnapshot और पिछले चाइल्ड की कुंजी वाली स्ट्रिंग, क्रम से लगाया जाएगा. इसी तरह, अगर यह पहला चाइल्ड है, तो इसे null पास किया जाएगा. |
कॉलबैक का अनुरोध रद्द करें | (गड़बड़ी: गड़बड़ी) => जानकारी नहीं है | एक वैकल्पिक कॉलबैक, जिसे कभी भी आपकी इवेंट सदस्यता रद्द किए जाने पर सूचना दी जाएगी. ऐसा इसलिए, क्योंकि आपके क्लाइंट के पास इस डेटा को पढ़ने की अनुमति नहीं है (या उसे इसकी अनुमति थी, लेकिन उसने अब उसे खो दिया है). इस कॉलबैक को एक Error ऑब्जेक्ट पास किया जाएगा. इसमें बताया जाएगा कि गड़बड़ी क्यों हुई. |
लौटाए जाने वाले प्रॉडक्ट:
एक फ़ंक्शन जिसका इस्तेमाल लिसनर को हटाने के लिए किया जा सकता है.
onचाइल्ड जोड़ा गया(क्वेरी, कॉलबैक, विकल्प)
किसी खास जगह के डेटा में हुए बदलावों के बारे में सुनता है.
यह किसी डेटाबेस से डेटा पढ़ने का मुख्य तरीका है. आपके कॉलबैक को शुरुआती डेटा के लिए ट्रिगर किया जाएगा. इसके बाद, डेटा में बदलाव होने पर यह फिर से ट्रिगर होगा. अपडेट पाने की सुविधा बंद करने के लिए, 'सदस्यता छोड़ें' कॉलबैक को शुरू करें. ज़्यादा जानकारी के लिए, वेब पर डेटा वापस पाना देखें.
इस जगह पर, हर शुरुआती चाइल्ड के लिए एक बार onChildAdded
इवेंट ट्रिगर होगा. साथ ही, जब भी नया चाइल्ड जोड़ा जाएगा, यह फिर से ट्रिगर होगा. कॉलबैक में पास किया गया DataSnapshot
, काम के चाइल्ड खाते का डेटा दिखाएगा. ऑर्डर करने के लिए, इसे दूसरा आर्ग्युमेंट दिया जाता है, जो क्रम से लगाए गए पिछले सिबलिंग चाइल्ड की की स्ट्रिंग होती है. इसके अलावा, अगर यह पहला चाइल्ड है, तो इसे null
दिया जाता है.
हस्ताक्षर:
export declare function onChildAdded(query: Query, callback: (snapshot: DataSnapshot, previousChildName: string | null) => unknown, options: ListenOptions): Unsubscribe;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
query | क्वेरी | चलाने के लिए क्वेरी. |
कॉलबैक | (स्नैपशॉट: DataSnapshot, beforeChildName: स्ट्रिंग | शून्य) => जानकारी नहीं है | तय किया गया इवेंट होने पर ट्रिगर होने वाला कॉलबैक. कॉलबैक को DataSnapshot और पिछले चाइल्ड की कुंजी वाली स्ट्रिंग, क्रम से लगाया जाएगा. इसी तरह, अगर यह पहला चाइल्ड है, तो इसे null पास किया जाएगा. |
विकल्प | सुनने के विकल्प | एक ऑब्जेक्ट, जिसका इस्तेमाल onlyOnce को कॉन्फ़िगर करने के लिए किया जा सकता है. यह ऑब्जेक्ट को पहली बार शुरू करने पर, लिसनर को हटा देता है. |
लौटाए जाने वाले प्रॉडक्ट:
एक फ़ंक्शन जिसका इस्तेमाल लिसनर को हटाने के लिए किया जा सकता है.
onचाइल्ड जोड़ा गया(क्वेरी, कॉलबैक, cancelCallback, विकल्प)
किसी खास जगह के डेटा में हुए बदलावों के बारे में सुनता है.
यह किसी डेटाबेस से डेटा पढ़ने का मुख्य तरीका है. आपके कॉलबैक को शुरुआती डेटा के लिए ट्रिगर किया जाएगा. इसके बाद, डेटा में बदलाव होने पर यह फिर से ट्रिगर होगा. अपडेट पाने की सुविधा बंद करने के लिए, 'सदस्यता छोड़ें' कॉलबैक को शुरू करें. ज़्यादा जानकारी के लिए, वेब पर डेटा वापस पाना देखें.
इस जगह पर, हर शुरुआती चाइल्ड के लिए एक बार onChildAdded
इवेंट ट्रिगर होगा. साथ ही, जब भी नया चाइल्ड जोड़ा जाएगा, यह फिर से ट्रिगर होगा. कॉलबैक में पास किया गया DataSnapshot
, काम के चाइल्ड खाते का डेटा दिखाएगा. ऑर्डर करने के लिए, इसे दूसरा आर्ग्युमेंट दिया जाता है, जो क्रम से लगाए गए पिछले सिबलिंग चाइल्ड की की स्ट्रिंग होती है. इसके अलावा, अगर यह पहला चाइल्ड है, तो इसे null
दिया जाता है.
हस्ताक्षर:
export declare function onChildAdded(query: Query, callback: (snapshot: DataSnapshot, previousChildName: string | null) => unknown, cancelCallback: (error: Error) => unknown, options: ListenOptions): Unsubscribe;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
query | क्वेरी | चलाने के लिए क्वेरी. |
कॉलबैक | (स्नैपशॉट: DataSnapshot, beforeChildName: स्ट्रिंग | शून्य) => जानकारी नहीं है | तय किया गया इवेंट होने पर ट्रिगर होने वाला कॉलबैक. कॉलबैक को DataSnapshot और पिछले चाइल्ड की कुंजी वाली स्ट्रिंग, क्रम से लगाया जाएगा. इसी तरह, अगर यह पहला चाइल्ड है, तो इसे null पास किया जाएगा. |
कॉलबैक का अनुरोध रद्द करें | (गड़बड़ी: गड़बड़ी) => जानकारी नहीं है | एक वैकल्पिक कॉलबैक, जिसे कभी भी आपकी इवेंट सदस्यता रद्द किए जाने पर सूचना दी जाएगी. ऐसा इसलिए, क्योंकि आपके क्लाइंट के पास इस डेटा को पढ़ने की अनुमति नहीं है (या उसे इसकी अनुमति थी, लेकिन उसने अब उसे खो दिया है). इस कॉलबैक को एक Error ऑब्जेक्ट पास किया जाएगा. इसमें बताया जाएगा कि गड़बड़ी क्यों हुई. |
विकल्प | सुनने के विकल्प | एक ऑब्जेक्ट, जिसका इस्तेमाल onlyOnce को कॉन्फ़िगर करने के लिए किया जा सकता है. यह ऑब्जेक्ट को पहली बार शुरू करने पर, लिसनर को हटा देता है. |
लौटाए जाने वाले प्रॉडक्ट:
एक फ़ंक्शन जिसका इस्तेमाल लिसनर को हटाने के लिए किया जा सकता है.
onchildChanged(क्वेरी, कॉलबैक, cancelCallback)
किसी खास जगह के डेटा में हुए बदलावों के बारे में सुनता है.
यह किसी डेटाबेस से डेटा पढ़ने का मुख्य तरीका है. आपके कॉलबैक को शुरुआती डेटा के लिए ट्रिगर किया जाएगा. इसके बाद, डेटा में बदलाव होने पर यह फिर से ट्रिगर होगा. अपडेट पाने की सुविधा बंद करने के लिए, 'सदस्यता छोड़ें' कॉलबैक को शुरू करें. ज़्यादा जानकारी के लिए, वेब पर डेटा वापस पाना देखें.
किसी चाइल्ड (या उसके किसी भी डिसेंडेंट) में सेव किए गए डेटा में बदलाव होने पर, onChildChanged
इवेंट ट्रिगर होगा. ध्यान दें कि एक child_changed
इवेंट में, चाइल्ड खाते में कई बदलाव किए जा सकते हैं. कॉलबैक को पास किए गए DataSnapshot
में, नया चाइल्ड कॉन्टेंट शामिल होगा. ऑर्डर करने के लिए, कॉलबैक को दूसरा आर्ग्युमेंट भी पास किया जाता है, जो क्रम में लगाए गए पिछले सिबलिंग चाइल्ड की की स्ट्रिंग होती है. अगर यह पहला चाइल्ड है, तो इसे null
का इस्तेमाल करके भी ऑर्डर किया जा सकता है.
हस्ताक्षर:
export declare function onChildChanged(query: Query, callback: (snapshot: DataSnapshot, previousChildName: string | null) => unknown, cancelCallback?: (error: Error) => unknown): Unsubscribe;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
query | क्वेरी | चलाने के लिए क्वेरी. |
कॉलबैक | (स्नैपशॉट: DataSnapshot, beforeChildName: स्ट्रिंग | शून्य) => जानकारी नहीं है | तय किया गया इवेंट होने पर ट्रिगर होने वाला कॉलबैक. कॉलबैक को DataSnapshot और पिछले चाइल्ड की कुंजी वाली स्ट्रिंग, क्रम से लगाया जाएगा. इसी तरह, अगर यह पहला चाइल्ड है, तो इसे null पास किया जाएगा. |
कॉलबैक का अनुरोध रद्द करें | (गड़बड़ी: गड़बड़ी) => जानकारी नहीं है | एक वैकल्पिक कॉलबैक, जिसे कभी भी आपकी इवेंट सदस्यता रद्द किए जाने पर सूचना दी जाएगी. ऐसा इसलिए, क्योंकि आपके क्लाइंट के पास इस डेटा को पढ़ने की अनुमति नहीं है (या उसे इसकी अनुमति थी, लेकिन उसने अब उसे खो दिया है). इस कॉलबैक को एक Error ऑब्जेक्ट पास किया जाएगा. इसमें बताया जाएगा कि गड़बड़ी क्यों हुई. |
लौटाए जाने वाले प्रॉडक्ट:
एक फ़ंक्शन जिसका इस्तेमाल लिसनर को हटाने के लिए किया जा सकता है.
onchildChanged(क्वेरी, कॉलबैक, विकल्प)
किसी खास जगह के डेटा में हुए बदलावों के बारे में सुनता है.
यह किसी डेटाबेस से डेटा पढ़ने का मुख्य तरीका है. आपके कॉलबैक को शुरुआती डेटा के लिए ट्रिगर किया जाएगा. इसके बाद, डेटा में बदलाव होने पर यह फिर से ट्रिगर होगा. अपडेट पाने की सुविधा बंद करने के लिए, 'सदस्यता छोड़ें' कॉलबैक को शुरू करें. ज़्यादा जानकारी के लिए, वेब पर डेटा वापस पाना देखें.
किसी चाइल्ड (या उसके किसी भी डिसेंडेंट) में सेव किए गए डेटा में बदलाव होने पर, onChildChanged
इवेंट ट्रिगर होगा. ध्यान दें कि एक child_changed
इवेंट में, चाइल्ड खाते में कई बदलाव किए जा सकते हैं. कॉलबैक को पास किए गए DataSnapshot
में, नया चाइल्ड कॉन्टेंट शामिल होगा. ऑर्डर करने के लिए, कॉलबैक को दूसरा आर्ग्युमेंट भी पास किया जाता है, जो क्रम में लगाए गए पिछले सिबलिंग चाइल्ड की की स्ट्रिंग होती है. अगर यह पहला चाइल्ड है, तो इसे null
का इस्तेमाल करके भी ऑर्डर किया जा सकता है.
हस्ताक्षर:
export declare function onChildChanged(query: Query, callback: (snapshot: DataSnapshot, previousChildName: string | null) => unknown, options: ListenOptions): Unsubscribe;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
query | क्वेरी | चलाने के लिए क्वेरी. |
कॉलबैक | (स्नैपशॉट: DataSnapshot, beforeChildName: स्ट्रिंग | शून्य) => जानकारी नहीं है | तय किया गया इवेंट होने पर ट्रिगर होने वाला कॉलबैक. कॉलबैक को DataSnapshot और पिछले चाइल्ड की कुंजी वाली स्ट्रिंग, क्रम से लगाया जाएगा. इसी तरह, अगर यह पहला चाइल्ड है, तो इसे null पास किया जाएगा. |
विकल्प | सुनने के विकल्प | एक ऑब्जेक्ट, जिसका इस्तेमाल onlyOnce को कॉन्फ़िगर करने के लिए किया जा सकता है. यह ऑब्जेक्ट को पहली बार शुरू करने पर, लिसनर को हटा देता है. |
लौटाए जाने वाले प्रॉडक्ट:
एक फ़ंक्शन जिसका इस्तेमाल लिसनर को हटाने के लिए किया जा सकता है.
onchildChanged(क्वेरी, कॉलबैक, cancelCallback, विकल्प)
किसी खास जगह के डेटा में हुए बदलावों के बारे में सुनता है.
यह किसी डेटाबेस से डेटा पढ़ने का मुख्य तरीका है. आपके कॉलबैक को शुरुआती डेटा के लिए ट्रिगर किया जाएगा. इसके बाद, डेटा में बदलाव होने पर यह फिर से ट्रिगर होगा. अपडेट पाने की सुविधा बंद करने के लिए, 'सदस्यता छोड़ें' कॉलबैक को शुरू करें. ज़्यादा जानकारी के लिए, वेब पर डेटा वापस पाना देखें.
किसी चाइल्ड (या उसके किसी भी डिसेंडेंट) में सेव किए गए डेटा में बदलाव होने पर, onChildChanged
इवेंट ट्रिगर होगा. ध्यान दें कि एक child_changed
इवेंट में, चाइल्ड खाते में कई बदलाव किए जा सकते हैं. कॉलबैक को पास किए गए DataSnapshot
में, नया चाइल्ड कॉन्टेंट शामिल होगा. ऑर्डर करने के लिए, कॉलबैक को दूसरा आर्ग्युमेंट भी पास किया जाता है, जो क्रम में लगाए गए पिछले सिबलिंग चाइल्ड की की स्ट्रिंग होती है. अगर यह पहला चाइल्ड है, तो इसे null
का इस्तेमाल करके भी ऑर्डर किया जा सकता है.
हस्ताक्षर:
export declare function onChildChanged(query: Query, callback: (snapshot: DataSnapshot, previousChildName: string | null) => unknown, cancelCallback: (error: Error) => unknown, options: ListenOptions): Unsubscribe;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
query | क्वेरी | चलाने के लिए क्वेरी. |
कॉलबैक | (स्नैपशॉट: DataSnapshot, beforeChildName: स्ट्रिंग | शून्य) => जानकारी नहीं है | तय किया गया इवेंट होने पर ट्रिगर होने वाला कॉलबैक. कॉलबैक को DataSnapshot और पिछले चाइल्ड की कुंजी वाली स्ट्रिंग, क्रम से लगाया जाएगा. इसी तरह, अगर यह पहला चाइल्ड है, तो इसे null पास किया जाएगा. |
कॉलबैक का अनुरोध रद्द करें | (गड़बड़ी: गड़बड़ी) => जानकारी नहीं है | एक वैकल्पिक कॉलबैक, जिसे कभी भी आपकी इवेंट सदस्यता रद्द किए जाने पर सूचना दी जाएगी. ऐसा इसलिए, क्योंकि आपके क्लाइंट के पास इस डेटा को पढ़ने की अनुमति नहीं है (या उसे इसकी अनुमति थी, लेकिन उसने अब उसे खो दिया है). इस कॉलबैक को एक Error ऑब्जेक्ट पास किया जाएगा. इसमें बताया जाएगा कि गड़बड़ी क्यों हुई. |
विकल्प | सुनने के विकल्प | एक ऑब्जेक्ट, जिसका इस्तेमाल onlyOnce को कॉन्फ़िगर करने के लिए किया जा सकता है. यह ऑब्जेक्ट को पहली बार शुरू करने पर, लिसनर को हटा देता है. |
लौटाए जाने वाले प्रॉडक्ट:
एक फ़ंक्शन जिसका इस्तेमाल लिसनर को हटाने के लिए किया जा सकता है.
onchildMoved(क्वेरी, कॉलबैक, cancelCallback)
किसी खास जगह के डेटा में हुए बदलावों के बारे में सुनता है.
यह किसी डेटाबेस से डेटा पढ़ने का मुख्य तरीका है. आपके कॉलबैक को शुरुआती डेटा के लिए ट्रिगर किया जाएगा. इसके बाद, डेटा में बदलाव होने पर यह फिर से ट्रिगर होगा. अपडेट पाने की सुविधा बंद करने के लिए, 'सदस्यता छोड़ें' कॉलबैक को शुरू करें. ज़्यादा जानकारी के लिए, वेब पर डेटा वापस पाना देखें.
किसी बच्चे के क्रम में लगाने के क्रम में ऐसे बदलाव होने पर onChildMoved
इवेंट ट्रिगर होगा, जैसे कि उसके सिबलिंग की संख्या में बदलाव हो. कॉलबैक को दिया गया DataSnapshot
, बच्चे के डेटा के लिए होगा. इसे दूसरा आर्ग्युमेंट भी पास किया गया है, जो एक ऐसी स्ट्रिंग है जिसमें क्रम से लगाने के हिसाब से, पिछले सिबलिंग चाइल्ड की कुंजी है. अगर यह पहला चाइल्ड है, तो null
भी इस आर्ग्युमेंट को पास किया जा सकता है.
हस्ताक्षर:
export declare function onChildMoved(query: Query, callback: (snapshot: DataSnapshot, previousChildName: string | null) => unknown, cancelCallback?: (error: Error) => unknown): Unsubscribe;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
query | क्वेरी | चलाने के लिए क्वेरी. |
कॉलबैक | (स्नैपशॉट: DataSnapshot, beforeChildName: स्ट्रिंग | शून्य) => जानकारी नहीं है | तय किया गया इवेंट होने पर ट्रिगर होने वाला कॉलबैक. कॉलबैक को DataSnapshot और पिछले चाइल्ड की कुंजी वाली स्ट्रिंग, क्रम से लगाया जाएगा. इसी तरह, अगर यह पहला चाइल्ड है, तो इसे null पास किया जाएगा. |
कॉलबैक का अनुरोध रद्द करें | (गड़बड़ी: गड़बड़ी) => जानकारी नहीं है | एक वैकल्पिक कॉलबैक, जिसे कभी भी आपकी इवेंट सदस्यता रद्द किए जाने पर सूचना दी जाएगी. ऐसा इसलिए, क्योंकि आपके क्लाइंट के पास इस डेटा को पढ़ने की अनुमति नहीं है (या उसे इसकी अनुमति थी, लेकिन उसने अब उसे खो दिया है). इस कॉलबैक को एक Error ऑब्जेक्ट पास किया जाएगा. इसमें बताया जाएगा कि गड़बड़ी क्यों हुई. |
लौटाए जाने वाले प्रॉडक्ट:
एक फ़ंक्शन जिसका इस्तेमाल लिसनर को हटाने के लिए किया जा सकता है.
onchildMoved(क्वेरी, कॉलबैक, विकल्प)
किसी खास जगह के डेटा में हुए बदलावों के बारे में सुनता है.
यह किसी डेटाबेस से डेटा पढ़ने का मुख्य तरीका है. आपके कॉलबैक को शुरुआती डेटा के लिए ट्रिगर किया जाएगा. इसके बाद, डेटा में बदलाव होने पर यह फिर से ट्रिगर होगा. अपडेट पाने की सुविधा बंद करने के लिए, 'सदस्यता छोड़ें' कॉलबैक को शुरू करें. ज़्यादा जानकारी के लिए, वेब पर डेटा वापस पाना देखें.
किसी बच्चे के क्रम में लगाने के क्रम में ऐसे बदलाव होने पर onChildMoved
इवेंट ट्रिगर होगा, जैसे कि उसके सिबलिंग की संख्या में बदलाव हो. कॉलबैक को दिया गया DataSnapshot
, बच्चे के डेटा के लिए होगा. इसे दूसरा आर्ग्युमेंट भी पास किया गया है, जो एक ऐसी स्ट्रिंग है जिसमें क्रम से लगाने के हिसाब से, पिछले सिबलिंग चाइल्ड की कुंजी है. अगर यह पहला चाइल्ड है, तो null
भी इस आर्ग्युमेंट को पास किया जा सकता है.
हस्ताक्षर:
export declare function onChildMoved(query: Query, callback: (snapshot: DataSnapshot, previousChildName: string | null) => unknown, options: ListenOptions): Unsubscribe;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
query | क्वेरी | चलाने के लिए क्वेरी. |
कॉलबैक | (स्नैपशॉट: DataSnapshot, beforeChildName: स्ट्रिंग | शून्य) => जानकारी नहीं है | तय किया गया इवेंट होने पर ट्रिगर होने वाला कॉलबैक. कॉलबैक को DataSnapshot और पिछले चाइल्ड की कुंजी वाली स्ट्रिंग, क्रम से लगाया जाएगा. इसी तरह, अगर यह पहला चाइल्ड है, तो इसे null पास किया जाएगा. |
विकल्प | सुनने के विकल्प | एक ऑब्जेक्ट, जिसका इस्तेमाल onlyOnce को कॉन्फ़िगर करने के लिए किया जा सकता है. यह ऑब्जेक्ट को पहली बार शुरू करने पर, लिसनर को हटा देता है. |
लौटाए जाने वाले प्रॉडक्ट:
एक फ़ंक्शन जिसका इस्तेमाल लिसनर को हटाने के लिए किया जा सकता है.
onchildMoved(क्वेरी, कॉलबैक, cancelCallback, विकल्प)
किसी खास जगह के डेटा में हुए बदलावों के बारे में सुनता है.
यह किसी डेटाबेस से डेटा पढ़ने का मुख्य तरीका है. आपके कॉलबैक को शुरुआती डेटा के लिए ट्रिगर किया जाएगा. इसके बाद, डेटा में बदलाव होने पर यह फिर से ट्रिगर होगा. अपडेट पाने की सुविधा बंद करने के लिए, 'सदस्यता छोड़ें' कॉलबैक को शुरू करें. ज़्यादा जानकारी के लिए, वेब पर डेटा वापस पाना देखें.
किसी बच्चे के क्रम में लगाने के क्रम में ऐसे बदलाव होने पर onChildMoved
इवेंट ट्रिगर होगा, जैसे कि उसके सिबलिंग की संख्या में बदलाव हो. कॉलबैक को दिया गया DataSnapshot
, बच्चे के डेटा के लिए होगा. इसे दूसरा आर्ग्युमेंट भी पास किया गया है, जो एक ऐसी स्ट्रिंग है जिसमें क्रम से लगाने के हिसाब से, पिछले सिबलिंग चाइल्ड की कुंजी है. अगर यह पहला चाइल्ड है, तो null
भी इस आर्ग्युमेंट को पास किया जा सकता है.
हस्ताक्षर:
export declare function onChildMoved(query: Query, callback: (snapshot: DataSnapshot, previousChildName: string | null) => unknown, cancelCallback: (error: Error) => unknown, options: ListenOptions): Unsubscribe;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
query | क्वेरी | चलाने के लिए क्वेरी. |
कॉलबैक | (स्नैपशॉट: DataSnapshot, beforeChildName: स्ट्रिंग | शून्य) => जानकारी नहीं है | तय किया गया इवेंट होने पर ट्रिगर होने वाला कॉलबैक. कॉलबैक को DataSnapshot और पिछले चाइल्ड की कुंजी वाली स्ट्रिंग, क्रम से लगाया जाएगा. इसी तरह, अगर यह पहला चाइल्ड है, तो इसे null पास किया जाएगा. |
कॉलबैक का अनुरोध रद्द करें | (गड़बड़ी: गड़बड़ी) => जानकारी नहीं है | एक वैकल्पिक कॉलबैक, जिसे कभी भी आपकी इवेंट सदस्यता रद्द किए जाने पर सूचना दी जाएगी. ऐसा इसलिए, क्योंकि आपके क्लाइंट के पास इस डेटा को पढ़ने की अनुमति नहीं है (या उसे इसकी अनुमति थी, लेकिन उसने अब उसे खो दिया है). इस कॉलबैक को एक Error ऑब्जेक्ट पास किया जाएगा. इसमें बताया जाएगा कि गड़बड़ी क्यों हुई. |
विकल्प | सुनने के विकल्प | एक ऑब्जेक्ट, जिसका इस्तेमाल onlyOnce को कॉन्फ़िगर करने के लिए किया जा सकता है. यह ऑब्जेक्ट को पहली बार शुरू करने पर, लिसनर को हटा देता है. |
लौटाए जाने वाले प्रॉडक्ट:
एक फ़ंक्शन जिसका इस्तेमाल लिसनर को हटाने के लिए किया जा सकता है.
onchildRemoved(क्वेरी, कॉलबैक, cancelCallback)
किसी खास जगह के डेटा में हुए बदलावों के बारे में सुनता है.
यह किसी डेटाबेस से डेटा पढ़ने का मुख्य तरीका है. आपके कॉलबैक को शुरुआती डेटा के लिए ट्रिगर किया जाएगा. इसके बाद, डेटा में बदलाव होने पर यह फिर से ट्रिगर होगा. अपडेट पाने की सुविधा बंद करने के लिए, 'सदस्यता छोड़ें' कॉलबैक को शुरू करें. ज़्यादा जानकारी के लिए, वेब पर डेटा वापस पाना देखें.
जब भी किसी बच्चे को हटाया जाएगा, तब onChildRemoved
इवेंट ट्रिगर होगा. कॉलबैक में दिया गया DataSnapshot
, हटाए गए बच्चे का पुराना डेटा होगा. किसी बच्चे को इन मामलों में हटा दिया जाएगा:
- एक क्लाइंट उस चाइल्ड या उसके पूर्वजों पर स्पष्ट रूप से
remove()
को कॉल करता है - क्लाइंट उस बच्चे या उसके किसी पूर्वज कोset(null)
कॉल करता है - उस बच्चे के सभी बच्चे निकाल दिए गए हैं - एक ऐसी क्वेरी है जो अब चाइल्ड को फ़िल्टर कर देती है (क्योंकि वह क्रम क्रम में बदल गई है या अधिकतम सीमा हिट हो गई थी)
हस्ताक्षर:
export declare function onChildRemoved(query: Query, callback: (snapshot: DataSnapshot) => unknown, cancelCallback?: (error: Error) => unknown): Unsubscribe;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
query | क्वेरी | चलाने के लिए क्वेरी. |
कॉलबैक | (स्नैपशॉट: DataSnapshot) => जानकारी नहीं है | तय किया गया इवेंट होने पर ट्रिगर होने वाला कॉलबैक. कॉलबैक को DataSnapshot और पिछले चाइल्ड की कुंजी वाली स्ट्रिंग, क्रम से लगाया जाएगा. इसी तरह, अगर यह पहला चाइल्ड है, तो इसे null पास किया जाएगा. |
कॉलबैक का अनुरोध रद्द करें | (गड़बड़ी: गड़बड़ी) => जानकारी नहीं है | एक वैकल्पिक कॉलबैक, जिसे कभी भी आपकी इवेंट सदस्यता रद्द किए जाने पर सूचना दी जाएगी. ऐसा इसलिए, क्योंकि आपके क्लाइंट के पास इस डेटा को पढ़ने की अनुमति नहीं है (या उसे इसकी अनुमति थी, लेकिन उसने अब उसे खो दिया है). इस कॉलबैक को एक Error ऑब्जेक्ट पास किया जाएगा. इसमें बताया जाएगा कि गड़बड़ी क्यों हुई. |
लौटाए जाने वाले प्रॉडक्ट:
एक फ़ंक्शन जिसका इस्तेमाल लिसनर को हटाने के लिए किया जा सकता है.
ऑनचाइल्ड किया गया(क्वेरी, कॉलबैक, विकल्प)
किसी खास जगह के डेटा में हुए बदलावों के बारे में सुनता है.
यह किसी डेटाबेस से डेटा पढ़ने का मुख्य तरीका है. आपके कॉलबैक को शुरुआती डेटा के लिए ट्रिगर किया जाएगा. इसके बाद, डेटा में बदलाव होने पर यह फिर से ट्रिगर होगा. अपडेट पाने की सुविधा बंद करने के लिए, 'सदस्यता छोड़ें' कॉलबैक को शुरू करें. ज़्यादा जानकारी के लिए, वेब पर डेटा वापस पाना देखें.
जब भी किसी बच्चे को हटाया जाएगा, तब onChildRemoved
इवेंट ट्रिगर होगा. कॉलबैक में दिया गया DataSnapshot
, हटाए गए बच्चे का पुराना डेटा होगा. किसी बच्चे को इन मामलों में हटा दिया जाएगा:
- एक क्लाइंट उस चाइल्ड या उसके पूर्वजों पर स्पष्ट रूप से
remove()
को कॉल करता है - क्लाइंट उस बच्चे या उसके किसी पूर्वज कोset(null)
कॉल करता है - उस बच्चे के सभी बच्चे निकाल दिए गए हैं - एक ऐसी क्वेरी है जो अब चाइल्ड को फ़िल्टर कर देती है (क्योंकि वह क्रम क्रम में बदल गई है या अधिकतम सीमा हिट हो गई थी)
हस्ताक्षर:
export declare function onChildRemoved(query: Query, callback: (snapshot: DataSnapshot) => unknown, options: ListenOptions): Unsubscribe;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
query | क्वेरी | चलाने के लिए क्वेरी. |
कॉलबैक | (स्नैपशॉट: DataSnapshot) => जानकारी नहीं है | तय किया गया इवेंट होने पर ट्रिगर होने वाला कॉलबैक. कॉलबैक को DataSnapshot और पिछले चाइल्ड की कुंजी वाली स्ट्रिंग, क्रम से लगाया जाएगा. इसी तरह, अगर यह पहला चाइल्ड है, तो इसे null पास किया जाएगा. |
विकल्प | सुनने के विकल्प | एक ऑब्जेक्ट, जिसका इस्तेमाल onlyOnce को कॉन्फ़िगर करने के लिए किया जा सकता है. यह ऑब्जेक्ट को पहली बार शुरू करने पर, लिसनर को हटा देता है. |
लौटाए जाने वाले प्रॉडक्ट:
एक फ़ंक्शन जिसका इस्तेमाल लिसनर को हटाने के लिए किया जा सकता है.
onchildRemoved(क्वेरी, कॉलबैक, cancelCallback, विकल्प)
किसी खास जगह के डेटा में हुए बदलावों के बारे में सुनता है.
यह किसी डेटाबेस से डेटा पढ़ने का मुख्य तरीका है. आपके कॉलबैक को शुरुआती डेटा के लिए ट्रिगर किया जाएगा. इसके बाद, डेटा में बदलाव होने पर यह फिर से ट्रिगर होगा. अपडेट पाने की सुविधा बंद करने के लिए, 'सदस्यता छोड़ें' कॉलबैक को शुरू करें. ज़्यादा जानकारी के लिए, वेब पर डेटा वापस पाना देखें.
जब भी किसी बच्चे को हटाया जाएगा, तब onChildRemoved
इवेंट ट्रिगर होगा. कॉलबैक में दिया गया DataSnapshot
, हटाए गए बच्चे का पुराना डेटा होगा. किसी बच्चे को इन मामलों में हटा दिया जाएगा:
- एक क्लाइंट उस चाइल्ड या उसके पूर्वजों पर स्पष्ट रूप से
remove()
को कॉल करता है - क्लाइंट उस बच्चे या उसके किसी पूर्वज कोset(null)
कॉल करता है - उस बच्चे के सभी बच्चे निकाल दिए गए हैं - एक ऐसी क्वेरी है जो अब चाइल्ड को फ़िल्टर कर देती है (क्योंकि वह क्रम क्रम में बदल गई है या अधिकतम सीमा हिट हो गई थी)
हस्ताक्षर:
export declare function onChildRemoved(query: Query, callback: (snapshot: DataSnapshot) => unknown, cancelCallback: (error: Error) => unknown, options: ListenOptions): Unsubscribe;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
query | क्वेरी | चलाने के लिए क्वेरी. |
कॉलबैक | (स्नैपशॉट: DataSnapshot) => जानकारी नहीं है | तय किया गया इवेंट होने पर ट्रिगर होने वाला कॉलबैक. कॉलबैक को DataSnapshot और पिछले चाइल्ड की कुंजी वाली स्ट्रिंग, क्रम से लगाया जाएगा. इसी तरह, अगर यह पहला चाइल्ड है, तो इसे null पास किया जाएगा. |
कॉलबैक का अनुरोध रद्द करें | (गड़बड़ी: गड़बड़ी) => जानकारी नहीं है | एक वैकल्पिक कॉलबैक, जिसे कभी भी आपकी इवेंट सदस्यता रद्द किए जाने पर सूचना दी जाएगी. ऐसा इसलिए, क्योंकि आपके क्लाइंट के पास इस डेटा को पढ़ने की अनुमति नहीं है (या उसे इसकी अनुमति थी, लेकिन उसने अब उसे खो दिया है). इस कॉलबैक को एक Error ऑब्जेक्ट पास किया जाएगा. इसमें बताया जाएगा कि गड़बड़ी क्यों हुई. |
विकल्प | सुनने के विकल्प | एक ऑब्जेक्ट, जिसका इस्तेमाल onlyOnce को कॉन्फ़िगर करने के लिए किया जा सकता है. यह ऑब्जेक्ट को पहली बार शुरू करने पर, लिसनर को हटा देता है. |
लौटाए जाने वाले प्रॉडक्ट:
एक फ़ंक्शन जिसका इस्तेमाल लिसनर को हटाने के लिए किया जा सकता है.
onValue(क्वेरी, कॉलबैक, cancelCallback)
किसी खास जगह के डेटा में हुए बदलावों के बारे में सुनता है.
यह किसी डेटाबेस से डेटा पढ़ने का मुख्य तरीका है. आपके कॉलबैक को शुरुआती डेटा के लिए ट्रिगर किया जाएगा. इसके बाद, डेटा में बदलाव होने पर यह फिर से ट्रिगर होगा. अपडेट पाने की सुविधा बंद करने के लिए, 'सदस्यता छोड़ें' कॉलबैक को शुरू करें. ज़्यादा जानकारी के लिए, वेब पर डेटा वापस पाना देखें.
इस जगह पर सेव किए गए शुरुआती डेटा के साथ, onValue
इवेंट एक बार ट्रिगर होगा. इसके बाद, जब-जब डेटा में बदलाव होगा, तब यह इवेंट फिर से ट्रिगर होगा. कॉलबैक को दिया गया DataSnapshot
, उस जगह के लिए होगा जहां on()
को कॉल किया गया था. यह तब तक ट्रिगर नहीं होगा, जब तक पूरा कॉन्टेंट सिंक नहीं हो जाता. अगर जगह की जानकारी में कोई डेटा नहीं है, तो यह एक खाली DataSnapshot
के साथ ट्रिगर होगा (val()
null
दिखाएगा).
हस्ताक्षर:
export declare function onValue(query: Query, callback: (snapshot: DataSnapshot) => unknown, cancelCallback?: (error: Error) => unknown): Unsubscribe;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
query | क्वेरी | चलाने के लिए क्वेरी. |
कॉलबैक | (स्नैपशॉट: DataSnapshot) => जानकारी नहीं है | तय किया गया इवेंट होने पर ट्रिगर होने वाला कॉलबैक. कॉलबैक को DataSnapshot पर भेजा जाएगा. |
कॉलबैक का अनुरोध रद्द करें | (गड़बड़ी: गड़बड़ी) => जानकारी नहीं है | एक वैकल्पिक कॉलबैक, जिसे कभी भी आपकी इवेंट सदस्यता रद्द किए जाने पर सूचना दी जाएगी. ऐसा इसलिए, क्योंकि आपके क्लाइंट के पास इस डेटा को पढ़ने की अनुमति नहीं है (या उसे इसकी अनुमति थी, लेकिन उसने अब उसे खो दिया है). इस कॉलबैक को एक Error ऑब्जेक्ट पास किया जाएगा. इसमें बताया जाएगा कि गड़बड़ी क्यों हुई. |
लौटाए जाने वाले प्रॉडक्ट:
एक फ़ंक्शन जिसका इस्तेमाल लिसनर को हटाने के लिए किया जा सकता है.
onValue(क्वेरी, कॉलबैक, विकल्प)
किसी खास जगह के डेटा में हुए बदलावों के बारे में सुनता है.
यह किसी डेटाबेस से डेटा पढ़ने का मुख्य तरीका है. आपके कॉलबैक को शुरुआती डेटा के लिए ट्रिगर किया जाएगा. इसके बाद, डेटा में बदलाव होने पर यह फिर से ट्रिगर होगा. अपडेट पाने की सुविधा बंद करने के लिए, 'सदस्यता छोड़ें' कॉलबैक को शुरू करें. ज़्यादा जानकारी के लिए, वेब पर डेटा वापस पाना देखें.
इस जगह पर सेव किए गए शुरुआती डेटा के साथ, onValue
इवेंट एक बार ट्रिगर होगा. इसके बाद, जब-जब डेटा में बदलाव होगा, तब यह इवेंट फिर से ट्रिगर होगा. कॉलबैक को दिया गया DataSnapshot
, उस जगह के लिए होगा जहां on()
को कॉल किया गया था. यह तब तक ट्रिगर नहीं होगा, जब तक पूरा कॉन्टेंट सिंक नहीं हो जाता. अगर जगह की जानकारी में कोई डेटा नहीं है, तो यह एक खाली DataSnapshot
के साथ ट्रिगर होगा (val()
null
दिखाएगा).
हस्ताक्षर:
export declare function onValue(query: Query, callback: (snapshot: DataSnapshot) => unknown, options: ListenOptions): Unsubscribe;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
query | क्वेरी | चलाने के लिए क्वेरी. |
कॉलबैक | (स्नैपशॉट: DataSnapshot) => जानकारी नहीं है | तय किया गया इवेंट होने पर ट्रिगर होने वाला कॉलबैक. कॉलबैक को DataSnapshot पर भेजा जाएगा. |
विकल्प | सुनने के विकल्प | एक ऑब्जेक्ट, जिसका इस्तेमाल onlyOnce को कॉन्फ़िगर करने के लिए किया जा सकता है. यह ऑब्जेक्ट को पहली बार शुरू करने पर, लिसनर को हटा देता है. |
लौटाए जाने वाले प्रॉडक्ट:
एक फ़ंक्शन जिसका इस्तेमाल लिसनर को हटाने के लिए किया जा सकता है.
onValue(क्वेरी, कॉलबैक, cancelCallback, विकल्प)
किसी खास जगह के डेटा में हुए बदलावों के बारे में सुनता है.
यह किसी डेटाबेस से डेटा पढ़ने का मुख्य तरीका है. आपके कॉलबैक को शुरुआती डेटा के लिए ट्रिगर किया जाएगा. इसके बाद, डेटा में बदलाव होने पर यह फिर से ट्रिगर होगा. अपडेट पाने की सुविधा बंद करने के लिए, 'सदस्यता छोड़ें' कॉलबैक को शुरू करें. ज़्यादा जानकारी के लिए, वेब पर डेटा वापस पाना देखें.
इस जगह पर सेव किए गए शुरुआती डेटा के साथ, onValue
इवेंट एक बार ट्रिगर होगा. इसके बाद, जब-जब डेटा में बदलाव होगा, तब यह इवेंट फिर से ट्रिगर होगा. कॉलबैक को दिया गया DataSnapshot
, उस जगह के लिए होगा जहां on()
को कॉल किया गया था. यह तब तक ट्रिगर नहीं होगा, जब तक पूरा कॉन्टेंट सिंक नहीं हो जाता. अगर जगह की जानकारी में कोई डेटा नहीं है, तो यह एक खाली DataSnapshot
के साथ ट्रिगर होगा (val()
null
दिखाएगा).
हस्ताक्षर:
export declare function onValue(query: Query, callback: (snapshot: DataSnapshot) => unknown, cancelCallback: (error: Error) => unknown, options: ListenOptions): Unsubscribe;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
query | क्वेरी | चलाने के लिए क्वेरी. |
कॉलबैक | (स्नैपशॉट: DataSnapshot) => जानकारी नहीं है | तय किया गया इवेंट होने पर ट्रिगर होने वाला कॉलबैक. कॉलबैक को DataSnapshot पर भेजा जाएगा. |
कॉलबैक का अनुरोध रद्द करें | (गड़बड़ी: गड़बड़ी) => जानकारी नहीं है | एक वैकल्पिक कॉलबैक, जिसे कभी भी आपकी इवेंट सदस्यता रद्द किए जाने पर सूचना दी जाएगी. ऐसा इसलिए, क्योंकि आपके क्लाइंट के पास इस डेटा को पढ़ने की अनुमति नहीं है (या उसे इसकी अनुमति थी, लेकिन उसने अब उसे खो दिया है). इस कॉलबैक को एक Error ऑब्जेक्ट पास किया जाएगा. इसमें बताया जाएगा कि गड़बड़ी क्यों हुई. |
विकल्प | सुनने के विकल्प | एक ऑब्जेक्ट, जिसका इस्तेमाल onlyOnce को कॉन्फ़िगर करने के लिए किया जा सकता है. यह ऑब्जेक्ट को पहली बार शुरू करने पर, लिसनर को हटा देता है. |
लौटाए जाने वाले प्रॉडक्ट:
एक फ़ंक्शन जिसका इस्तेमाल लिसनर को हटाने के लिए किया जा सकता है.
क्वेरी(क्वेरी, queryConstraints)
Query
का एक ऐसा नया इंस्टेंस बनाता है जो बदला नहीं जा सकता. साथ ही, क्वेरी के लिए बने अन्य कंस्ट्रेंट को भी शामिल करने के लिए ऐसा किया जाता है.
हस्ताक्षर:
export declare function query(query: Query, ...queryConstraints: QueryConstraint[]): Query;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
query | क्वेरी | नए कंस्ट्रेंट के लिए बेस के तौर पर इस्तेमाल करने के लिए, क्वेरी इंस्टेंस. |
क्वेरी कंस्ट्रेंट | QueryConstraint[] | लागू किए जाने वाले QueryConstraint की सूची. |
लौटाए जाने वाले प्रॉडक्ट:
अपवाद
अगर किसी दिए गए क्वेरी कंस्ट्रेंट को मौजूदा या नए कंस्ट्रेंट के साथ नहीं जोड़ा जा सकता.
फ़ंक्शन(रेफ़रंस, ...)
onडिसकनेक्ट(ref)
कोई OnDisconnect
ऑब्जेक्ट लौटाता है - इसका इस्तेमाल करने के बारे में ज़्यादा जानकारी के लिए, JavaScript में ऑफ़लाइन क्षमताएं चालू करना देखें.
हस्ताक्षर:
export declare function onDisconnect(ref: DatabaseReference): OnDisconnect;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
संदर्भ | DatabaseReference | ऑन डिसकनेक्ट ट्रिगर जोड़ने के लिए रेफ़रंस. |
लौटाए जाने वाले प्रॉडक्ट:
निकालें(संदर्भ)
इस डेटाबेस के डेटा को हटाता है.
चाइल्ड लोकेशन पर मौजूद डेटा भी मिटा दिया जाएगा.
हटाने का असर तुरंत और उससे जुड़े इवेंट 'वैल्यू' में दिखेगा ट्रिगर होगा. Firebase के सर्वर पर, हटाए गए प्रॉमिस का सिंक भी शुरू हो जाएगा. पूरा होने पर, लौटाए गए प्रॉमिस की समस्या हल हो जाएगी. अगर दिया गया हो, तो सिंक्रोनाइज़ेशन खत्म होने के बाद, oncomplete कॉलबैक को एसिंक्रोनस रूप से कॉल किया जाएगा.
हस्ताक्षर:
export declare function remove(ref: DatabaseReference): Promise<void>;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
संदर्भ | DatabaseReference | हटाई जाने वाली जगह. |
लौटाए जाने वाले प्रॉडक्ट:
प्रॉमिस<void>
सर्वर से हटाने की प्रोसेस पूरी होने पर यह समस्या हल हो जाती है.
रनलेन-देन(रेफ़री, लेन-देनअपडेट, विकल्प)
इस जगह के डेटा में ऐटम तरीके से बदलाव किया जाता है.
इस जगह के डेटा में अपने-आप बदलाव होने की सुविधा. सामान्य set()
के उलट, जो पिछली वैल्यू पर ध्यान दिए बिना डेटा को ओवरराइट कर देता है. runTransaction()
का इस्तेमाल करके, मौजूदा वैल्यू में बदलाव करके नई वैल्यू जनरेट की जाती है. इससे यह पक्का किया जाता है कि एक ही समय में दूसरे क्लाइंट के साथ काम करने में कोई समस्या न हो.
इसके लिए, आपको runTransaction()
को एक अपडेट फ़ंक्शन पास करना होगा, जिसका इस्तेमाल मौजूदा वैल्यू को नई वैल्यू में बदलने के लिए किया जाता है. अगर आपकी नई वैल्यू सही से लिखे जाने से पहले कोई दूसरा क्लाइंट उस जगह का नाम लिखता है, तो आपके अपडेट फ़ंक्शन को नई वैल्यू के साथ फिर से कॉल किया जाएगा और डेटा को फिर से लिखने की कोशिश की जाएगी. ऐसा बार-बार तब तक होता रहेगा, जब तक आपका डेटा बिना किसी विवाद के पूरा नहीं हो जाता या आपके अपडेट फ़ंक्शन से कोई वैल्यू नहीं मिलने पर, लेन-देन रद्द हो जाता है.
हस्ताक्षर:
export declare function runTransaction(ref: DatabaseReference, transactionUpdate: (currentData: any) => unknown, options?: TransactionOptions): Promise<TransactionResult>;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
संदर्भ | DatabaseReference | उस जगह की जानकारी जिसमें अपने-आप बदलाव किया जाना है. |
लेन-देन का अपडेट | (मौजूदा डेटा: कोई भी) => जानकारी नहीं है | डेवलपर का दिया गया फ़ंक्शन, जिसे इस जगह पर सेव किए गए मौजूदा डेटा (JavaScript ऑब्जेक्ट के तौर पर) को पास किया जाएगा. फ़ंक्शन को वह नई वैल्यू दिखानी चाहिए जिसे उसे लिखना है (JavaScript ऑब्जेक्ट के तौर पर). अगर undefined लौटाया जाता है (यानी आप बिना किसी तर्क के वापस लौटते हैं) तो लेन-देन रद्द हो जाएगा और इस जगह के डेटा में कोई बदलाव नहीं होगा. |
विकल्प | लेन-देन के विकल्प | लेन-देन को कॉन्फ़िगर करने के लिए, विकल्प ऑब्जेक्ट. |
लौटाए जाने वाले प्रॉडक्ट:
प्रॉमिस<लेन-देन का नतीजा>
सफलता और असफलता को मैनेज करने के लिए, onComplete
कॉलबैक के बजाय, वैकल्पिक तौर पर इस्तेमाल किया जा सकने वाला Promise
.
सेट(संदर्भ, मान)
इस डेटाबेस की जगह पर डेटा लिखता है.
ऐसा करने से, इस जगह और चाइल्ड लोकेशन के डेटा को ओवरराइट कर दिया जाएगा.
इस बदलाव का असर तुरंत दिखने लगेगा. साथ ही, इससे जुड़े इवेंट ("value", "child_added" वगैरह) ट्रिगर हो जाएंगे. Firebase के सर्वर के साथ डेटा का सिंक भी शुरू हो जाएगा. साथ ही, लौटाए गए प्रॉमिस की प्रोसेस पूरी होने पर इसका समाधान हो जाएगा. अगर दिया गया हो, तो सिंक होने के बाद onComplete
कॉलबैक को एसिंक्रोनस रूप से कॉल किया जाएगा.
नई वैल्यू के लिए null
पास करना, remove()
को कॉल करने के बराबर है; इसका मतलब है कि इस जगह का सारा डेटा और चाइल्ड लोकेशन का पूरा डेटा मिटा दिया जाएगा.
set()
इस जगह पर सेव की गई सभी प्राथमिकताएं हटा देगा. अगर प्राथमिकता को सुरक्षित रखना है, तो आपको इसके बजाय setWithPriority()
का इस्तेमाल करना होगा.
ध्यान दें कि set()
की मदद से डेटा में बदलाव करने से, उस जगह पर किया गया कोई भी लेन-देन रद्द हो जाएगा. इसलिए, अगर एक ही डेटा में बदलाव करने के लिए set()
और transaction()
को मिलाया जाता है, तो बहुत ज़्यादा सावधानी बरतनी चाहिए.
एक set()
से एक "वैल्यू" जनरेट होगी उस जगह पर हुआ इवेंट जहां set()
का इस्तेमाल किया गया था.
हस्ताक्षर:
export declare function set(ref: DatabaseReference, value: unknown): Promise<void>;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
संदर्भ | DatabaseReference | वह जगह जिस पर आपको ईमेल लिखना है. |
value | अज्ञात | लिखी जाने वाली वैल्यू (स्ट्रिंग, संख्या, बूलियन, ऑब्जेक्ट, अरे या शून्य). |
लौटाए जाने वाले प्रॉडक्ट:
प्रॉमिस<void>
सर्वर पर लिखने की प्रक्रिया पूरी होने पर समाधान होता है.
सेट प्राथमिकता(संदर्भ, प्राथमिकता)
इस डेटाबेस के डेटा के लिए प्राथमिकता सेट करता है.
ऐप्लिकेशन को प्राथमिकता देने की ज़रूरत नहीं है, लेकिन वे सामान्य प्रॉपर्टी के हिसाब से कलेक्शन को क्रम से लगा सकते हैं. (डेटा को क्रम से लगाना और फ़िल्टर करना देखें).
हस्ताक्षर:
export declare function setPriority(ref: DatabaseReference, priority: string | number | null): Promise<void>;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
संदर्भ | DatabaseReference | वह जगह जिस पर आपको ईमेल लिखना है. |
प्राथमिकता | स्ट्रिंग | नंबर | शून्य | लिखी जाने वाली प्राथमिकता (स्ट्रिंग, संख्या या शून्य). |
लौटाए जाने वाले प्रॉडक्ट:
प्रॉमिस<void>
सर्वर पर लिखने की प्रक्रिया पूरी होने पर समाधान होता है.
setWithप्राथमिकता(रेफ़री, वैल्यू, प्राथमिकता)
डेटाबेस की जगह का डेटा लिखता है. set()
की तरह, लेकिन उस डेटा के लिए प्राथमिकता भी तय करता है.
ऐप्लिकेशन को प्राथमिकता देने की ज़रूरत नहीं है, लेकिन वे सामान्य प्रॉपर्टी के हिसाब से कलेक्शन को क्रम से लगा सकते हैं. (डेटा को क्रम से लगाना और फ़िल्टर करना देखें).
हस्ताक्षर:
export declare function setWithPriority(ref: DatabaseReference, value: unknown, priority: string | number | null): Promise<void>;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
संदर्भ | DatabaseReference | वह जगह जिस पर आपको ईमेल लिखना है. |
value | अज्ञात | लिखी जाने वाली वैल्यू (स्ट्रिंग, संख्या, बूलियन, ऑब्जेक्ट, अरे या शून्य). |
प्राथमिकता | स्ट्रिंग | नंबर | शून्य | लिखी जाने वाली प्राथमिकता (स्ट्रिंग, संख्या या शून्य). |
लौटाए जाने वाले प्रॉडक्ट:
प्रॉमिस<void>
सर्वर पर लिखने की प्रक्रिया पूरी होने पर समाधान होता है.
अपडेट(रेफ़रंस, वैल्यू)
डेटाबेस में एक साथ कई वैल्यू लिखता है.
values
आर्ग्युमेंट में, एक से ज़्यादा प्रॉपर्टी वैल्यू के पेयर हैं, जिन्हें डेटाबेस में एक साथ लिखा जाएगा. हर चाइल्ड प्रॉपर्टी कोई सामान्य प्रॉपर्टी (उदाहरण के लिए, "नाम") हो सकती है या मौजूदा जगह से अपडेट किए जाने वाले डेटा तक का मिलता-जुलता पाथ (उदाहरण के लिए, "नाम/पहला") हो सकता है.
set()
तरीके के उलट, update()
का इस्तेमाल मौजूदा जगह पर सिर्फ़ रेफ़र की गई प्रॉपर्टी को चुनिंदा अपडेट करने के लिए किया जा सकता है (मौजूदा जगह की सभी चाइल्ड प्रॉपर्टी को बदलने के बजाय).
लिखने का असर तुरंत दिखने लगेगा. साथ ही, इससे जुड़े इवेंट ('value', 'child_added' वगैरह) ट्रिगर हो जाएंगे. Firebase के सर्वर के साथ डेटा का सिंक भी शुरू हो जाएगा. साथ ही, लौटाए गए प्रॉमिस की प्रोसेस पूरी होने पर इसका समाधान हो जाएगा. अगर दिया गया हो, तो सिंक होने के बाद onComplete
कॉलबैक को एसिंक्रोनस रूप से कॉल किया जाएगा.
एक update()
से एक "वैल्यू" जनरेट होगी इवेंट के तौर पर दिखाएं, जहां update()
चलाया गया था.
ध्यान दें कि update()
की मदद से डेटा में बदलाव करने से, उस जगह पर किया गया कोई भी लेन-देन रद्द हो जाएगा. इसलिए, अगर एक ही डेटा में बदलाव करने के लिए update()
और transaction()
को मिलाया जाता है, तो बहुत ज़्यादा सावधानी बरतनी चाहिए.
update()
पर null
पास करने से इस जगह का डेटा हट जाएगा.
पेश है एक से ज़्यादा जगहों की जानकारी से जुड़े अपडेट और अन्य सुविधाएं.
हस्ताक्षर:
export declare function update(ref: DatabaseReference, values: object): Promise<void>;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
संदर्भ | DatabaseReference | वह जगह जिस पर आपको ईमेल लिखना है. |
मान | ऑब्जेक्ट | ऑब्जेक्ट में एक से ज़्यादा वैल्यू हैं. |
लौटाए जाने वाले प्रॉडक्ट:
प्रॉमिस<void>
सर्वर पर अपडेट पूरा होने के बाद समस्या हल होती है.
फ़ंक्शन(वैल्यू, ...)
EndAt(वैल्यू, की)
तय किए गए आखिरी पॉइंट के साथ QueryConstraint
बनाता है.
startAt()
, startAfter()
, endBefore()
, endAt()
, और equalTo()
का इस्तेमाल करके, अपनी क्वेरी के लिए मनमुताबिक शुरुआती और आखिरी पॉइंट चुने जा सकते हैं.
आखिरी पॉइंट शामिल है, इसलिए सटीक वैल्यू वाले बच्चों को क्वेरी में शामिल किया जाएगा. क्वेरी की रेंज को और सीमित करने के लिए, वैकल्पिक कुंजी का इस्तेमाल किया जा सकता है. अगर यह शर्त तय की गई है, तो जिन चाइल्ड खातों की वैल्यू तय की गई है उनके लिए भी एक कुंजी का नाम होना चाहिए. यह नाम, उस कुंजी से कम या उसके बराबर होना चाहिए.
डेटा फ़िल्टर करना में जाकर, endAt()
के बारे में ज़्यादा पढ़ा जा सकता है.
हस्ताक्षर:
export declare function endAt(value: number | string | boolean | null, key?: string): QueryConstraint;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
value | नंबर | स्ट्रिंग | बूलियन | शून्य | वह मान जिस पर खत्म होना है. आर्ग्युमेंट का टाइप, इस बात पर निर्भर करता है कि इस क्वेरी में कौनसा orderBy() फ़ंक्शन इस्तेमाल किया गया है. orderBy () टाइप से मेल खाने वाली वैल्यू डालें. orderByKey() के साथ इस्तेमाल करने पर, वैल्यू एक स्ट्रिंग होनी चाहिए. |
बटन | स्ट्रिंग | पहले तय की गई प्राथमिकता वाले बच्चों के बीच खत्म होने वाली चाइल्ड कुंजी. इस आर्ग्युमेंट की अनुमति सिर्फ़ चाइल्ड, वैल्यू या प्राथमिकता के हिसाब से देने पर मिलती है. |
लौटाए जाने वाले प्रॉडक्ट:
end before(वैल्यू, कुंजी)
आखिरी पॉइंट (खास तौर पर) के साथ QueryConstraint
बनाता है.
startAt()
, startAfter()
, endBefore()
, endAt()
, और equalTo()
का इस्तेमाल करके, अपनी क्वेरी के लिए मनमुताबिक शुरुआती और आखिरी पॉइंट चुने जा सकते हैं.
आखिरी पॉइंट खास है. अगर सिर्फ़ वैल्यू दी गई है, तो तय वैल्यू से कम वैल्यू वाले चाइल्ड खातों को क्वेरी में शामिल किया जाएगा. अगर कोई कुंजी तय की गई है, तो बच्चों की वैल्यू, दी गई वैल्यू से कम या उसके बराबर होनी चाहिए. साथ ही, कुंजी का नाम बताई गई कुंजी से कम होना चाहिए.
हस्ताक्षर:
export declare function endBefore(value: number | string | boolean | null, key?: string): QueryConstraint;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
value | नंबर | स्ट्रिंग | बूलियन | शून्य | पहले खत्म होने वाली वैल्यू. आर्ग्युमेंट का टाइप, इस बात पर निर्भर करता है कि इस क्वेरी में कौनसा orderBy() फ़ंक्शन इस्तेमाल किया गया है. orderBy () टाइप से मेल खाने वाली वैल्यू डालें. orderByKey() के साथ इस्तेमाल करने पर, वैल्यू एक स्ट्रिंग होनी चाहिए. |
बटन | स्ट्रिंग | पहले खत्म की जाने वाली चाइल्ड कुंजी, पहले से तय प्राथमिकता वाले बच्चों के बीच. इस आर्ग्युमेंट की अनुमति सिर्फ़ चाइल्ड, वैल्यू या प्राथमिकता के हिसाब से देने पर मिलती है. |
लौटाए जाने वाले प्रॉडक्ट:
इसके बराबर(वैल्यू, की)
यह QueryConstraint
बनाता है, जिसमें तय की गई वैल्यू से मेल खाने वाले चाइल्ड शामिल होते हैं.
startAt()
, startAfter()
, endBefore()
, endAt()
, और equalTo()
का इस्तेमाल करके, अपनी क्वेरी के लिए मनमुताबिक शुरुआती और आखिरी पॉइंट चुने जा सकते हैं.
क्वेरी की रेंज को और सीमित करने के लिए, वैकल्पिक कुंजी का इस्तेमाल किया जा सकता है. अगर यह बताया गया है, तो जिन चाइल्ड खातों में यह वैल्यू डाली गई है उनमें भी वही कुंजी होनी चाहिए जो उनके मुख्य नाम के तौर पर सेट हो. इसका इस्तेमाल, एक ही वैल्यू के लिए कई मैच वाले नतीजे के सेट को फ़िल्टर करने के लिए किया जा सकता है.
डेटा फ़िल्टर करना में जाकर, equalTo()
के बारे में ज़्यादा पढ़ा जा सकता है.
हस्ताक्षर:
export declare function equalTo(value: number | string | boolean | null, key?: string): QueryConstraint;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
value | नंबर | स्ट्रिंग | बूलियन | शून्य | वह वैल्यू जिससे मैच करना है. आर्ग्युमेंट का टाइप, इस बात पर निर्भर करता है कि इस क्वेरी में कौनसा orderBy() फ़ंक्शन इस्तेमाल किया गया है. orderBy () टाइप से मेल खाने वाली वैल्यू डालें. orderByKey() के साथ इस्तेमाल करने पर, वैल्यू एक स्ट्रिंग होनी चाहिए. |
बटन | स्ट्रिंग | पहले तय की गई प्राथमिकता वाले बच्चों के बीच शुरू करने के लिए चाइल्ड कुंजी. इस आर्ग्युमेंट की अनुमति सिर्फ़ चाइल्ड, वैल्यू या प्राथमिकता के हिसाब से देने पर मिलती है. |
लौटाए जाने वाले प्रॉडक्ट:
StartAfter(वैल्यू, कुंजी)
तय किए गए शुरुआती पॉइंट (खास तौर पर) के साथ QueryConstraint
बनाता है.
startAt()
, startAfter()
, endBefore()
, endAt()
, और equalTo()
का इस्तेमाल करके, अपनी क्वेरी के लिए मनमुताबिक शुरुआती और आखिरी पॉइंट चुने जा सकते हैं.
शुरुआत की जगह खास है. अगर सिर्फ़ वैल्यू दी गई है, तो तय की गई वैल्यू से ज़्यादा वैल्यू वाले चाइल्ड खातों को क्वेरी में शामिल किया जाएगा. अगर कोई कुंजी तय की गई है, तो चाइल्ड वैल्यू में तय की गई वैल्यू से ज़्यादा या उसके बराबर होनी चाहिए. साथ ही, कुंजी का नाम बताई गई कुंजी से बड़ा होना चाहिए.
हस्ताक्षर:
export declare function startAfter(value: number | string | boolean | null, key?: string): QueryConstraint;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
value | नंबर | स्ट्रिंग | बूलियन | शून्य | इसके बाद शुरू होने वाली वैल्यू. आर्ग्युमेंट का टाइप, इस बात पर निर्भर करता है कि इस क्वेरी में कौनसा orderBy() फ़ंक्शन इस्तेमाल किया गया है. orderBy () टाइप से मेल खाने वाली वैल्यू डालें. orderByKey() के साथ इस्तेमाल करने पर, वैल्यू एक स्ट्रिंग होनी चाहिए. |
बटन | स्ट्रिंग | इसके बाद शुरू की जाने वाली चाइल्ड कुंजी. इस आर्ग्युमेंट की अनुमति सिर्फ़ चाइल्ड, वैल्यू या प्राथमिकता के हिसाब से देने पर मिलती है. |
लौटाए जाने वाले प्रॉडक्ट:
startAt(मान, कुंजी)
तय किए गए शुरुआती पॉइंट के साथ QueryConstraint
बनाता है.
startAt()
, startAfter()
, endBefore()
, endAt()
, और equalTo()
का इस्तेमाल करके, अपनी क्वेरी के लिए मनमुताबिक शुरुआती और आखिरी पॉइंट चुने जा सकते हैं.
शुरुआती पॉइंट में सब कुछ शामिल होता है, इसलिए सटीक वैल्यू वाले बच्चों को क्वेरी में शामिल किया जाएगा. क्वेरी की रेंज को और सीमित करने के लिए, वैकल्पिक कुंजी का इस्तेमाल किया जा सकता है. अगर यह शर्त तय की गई है, तो जिन चाइल्ड खातों की वैल्यू तय की गई है उनके लिए भी एक कुंजी का नाम होना चाहिए. यह नाम, उस कुंजी से ज़्यादा या उसके बराबर होना चाहिए.
डेटा फ़िल्टर करना में जाकर, startAt()
के बारे में ज़्यादा पढ़ा जा सकता है.
हस्ताक्षर:
export declare function startAt(value?: number | string | boolean | null, key?: string): QueryConstraint;
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
value | नंबर | स्ट्रिंग | बूलियन | शून्य | वह वैल्यू जिससे शुरू होती है. आर्ग्युमेंट का टाइप, इस बात पर निर्भर करता है कि इस क्वेरी में कौनसा orderBy() फ़ंक्शन इस्तेमाल किया गया है. orderBy () टाइप से मेल खाने वाली वैल्यू डालें. orderByKey() के साथ इस्तेमाल करने पर, वैल्यू एक स्ट्रिंग होनी चाहिए. |
बटन | स्ट्रिंग | शुरू करने के लिए चाइल्ड बटन. इस आर्ग्युमेंट की अनुमति सिर्फ़ चाइल्ड, वैल्यू या प्राथमिकता के हिसाब से देने पर मिलती है. |
लौटाए जाने वाले प्रॉडक्ट:
EventType
इनमें से एक स्ट्रिंग: "value", "child_added", "child_changed", "child_हटाया गया" या "child_moved."
हस्ताक्षर:
export declare type EventType = 'value' | 'child_added' | 'child_changed' | 'child_moved' | 'child_removed';
क्वेरीConstraintType
इस SDK टूल में उपलब्ध अलग-अलग क्वेरी कंस्ट्रेंट के बारे में बताता है.
हस्ताक्षर:
export declare type QueryConstraintType = 'endAt' | 'endBefore' | 'startAt' | 'startAfter' | 'limitToFirst' | 'limitToLast' | 'orderByChild' | 'orderByKey' | 'orderByPriority' | 'orderByValue' | 'equalTo';
सदस्यता छोड़ें
एक कॉलबैक, जिसे लिसनर हटाने के लिए शुरू किया जा सकता है.
हस्ताक्षर:
export declare type Unsubscribe = () => void;