@firebase/firestore/lite

फ़ंक्शन

फ़ंक्शन	ब्यौरा
फ़ंक्शन(ऐप्लिकेशन, ...)
getFirestore(ऐप्लिकेशन)	यह विकल्प, दिए गए FirebaseApp से जुड़ा डिफ़ॉल्ट Firestore इंस्टेंस दिखाता है. अगर कोई इंस्टेंस मौजूद नहीं है, तो डिफ़ॉल्ट सेटिंग के साथ नया इंस्टेंस शुरू करता है.
getFirestore(ऐप्लिकेशन, डेटाबेस आईडी)	(बीटा) दिए गए FirebaseApp से जुड़ा मौजूदा Firestore इंस्टेंस दिखाता है. अगर कोई इंस्टेंस मौजूद नहीं है, तो डिफ़ॉल्ट सेटिंग के साथ नया इंस्टेंस शुरू करता है.
initializeFirestore(ऐप्लिकेशन, सेटिंग)	दी गई सेटिंग के साथ Cloud Firestore के नए इंस्टेंस को शुरू करता है. इसे सिर्फ़ getFirestore() समेत किसी दूसरे फ़ंक्शन के पहले कॉल किया जा सकता है. अगर कस्टम सेटिंग खाली है, तो यह फ़ंक्शन getFirestore() को कॉल करने के बराबर होता है.
initializeFirestore(ऐप्लिकेशन, सेटिंग, डेटाबेस आईडी)	(बीटा) दी गई सेटिंग के साथ, Cloud Firestore के नए इंस्टेंस को शुरू करता है. इसे सिर्फ़ getFirestore() समेत किसी दूसरे फ़ंक्शन के पहले कॉल किया जा सकता है. अगर कस्टम सेटिंग खाली है, तो यह फ़ंक्शन getFirestore() को कॉल करने के बराबर होता है.
फ़ंक्शन(फ़ायरस्टोर, ...)
कलेक्शन(फ़ायरस्टोर, पाथ, पाथसेगमेंट)	इससे CollectionReference इंस्टेंस मिलता है, जो तय किए गए ऐब्सलूट पाथ पर कलेक्शन के बारे में बताता है.
collectionGroup(firestore, collectionsId)	एक नया Query इंस्टेंस बनाता और दिखाता है. इसमें, डेटाबेस में मौजूद वे सभी दस्तावेज़ शामिल होते हैं जो दिए गए collectionId के साथ कलेक्शन या सब-कलेक्शन में मौजूद होते हैं.
connectFirestoreEmulator(फ़ायरस्टोर, होस्ट, पोर्ट, विकल्प)	Cloud Firestore एम्युलेटर से संपर्क करने के लिए, इस इंस्टेंस में बदलाव करें.ध्यान दें: इस इंस्टेंस का इस्तेमाल कोई भी कार्रवाई करने से पहले किया जाना चाहिए.
डॉक(फ़ायरस्टोर, पाथ, पाथसेगमेंट)	इससे DocumentReference इंस्टेंस मिलता है, जो तय किए गए ऐब्सलूट पाथ पर मौजूद दस्तावेज़ से जुड़ा होता है.
runTransaction(firestore, updatedFunction, options)	दिए गए updateFunction को लागू करता है. इसके बाद, ट्रांज़ैक्शन में लागू किए गए बदलावों को लागू करने की कोशिश करता है. अगर लेन-देन में पढ़ा गया कोई दस्तावेज़ बदल गया है, तो Cloud Firestore, updateFunction को फिर से इस्तेमाल करने की कोशिश करता है. अगर पांच बार कोशिश करने के बाद भी लेन-देन नहीं हो पाता है, तो लेन-देन नहीं हो पाता.एक बार में 500 बार लिखा जा सकता है.
टर्मिनेट(फ़ायरस्टोर)	दिए गए Firestore इंस्टेंस को खत्म करता है.terminate() को कॉल करने के बाद सिर्फ़ clearIndexedDbPersistence() फ़ंक्शन का इस्तेमाल किया जा सकता है. कोई भी दूसरा फ़ंक्शन FirestoreError जनरेट करेगा. समझौता खत्म होने से, कोई भी बकाया अनुरोध रद्द नहीं होता. साथ ही, जिन वादों के लिए सर्वर से जवाब का इंतज़ार किया गया है उन पर कोई कार्रवाई नहीं होगी.खाता बंद होने के बाद रीस्टार्ट करने के लिए, getFirestore() का इस्तेमाल करके Firestore का नया इंस्टेंस बनाएं.ध्यान दें: सामान्य स्थिति में, terminate() पर कॉल करना ज़रूरी नहीं होता. यह फ़ंक्शन सिर्फ़ तब काम करता है, जब आपको इस इंस्टेंस को उसके सभी रिसॉर्स या clearIndexedDbPersistence() के साथ रिलीज़ करने के लिए ज़बरदस्ती करना हो, ताकि यह पक्का किया जा सके कि टेस्ट रन के बीच में सभी लोकल स्टेट खत्म हो जाएं.
writeBatch(firestore)	लिखने का एक बैच बनाता है, जिसका इस्तेमाल एक ऐटमिक ऑपरेशन के रूप में कई बार लिखने में किया जाता है. किसी एक WriteBatch में अधिकतम 500 लिखने की अनुमति है.इन लिखने के परिणाम केवल उन दस्तावेज़ लेखों में दिखाई देंगे जो लौटाए गए प्रॉमिस का समाधान हो जाने के बाद होते हैं. अगर क्लाइंट ऑफ़लाइन है, तो डेटा सेव नहीं हो पाता. अगर क्लाइंट के ऑनलाइन होने तक, आपको स्थानीय बदलाव या बफ़र राइट्स देखना है, तो पूरे Firestore SDK का इस्तेमाल करें.
फ़ंक्शन()
count()	एक ऐसा AggregateField ऑब्जेक्ट बनाएं, जिसका इस्तेमाल क्वेरी के नतीजे के सेट में मौजूद दस्तावेज़ों की संख्या की गणना करने के लिए किया जा सके.
deleteField()	मिटाने के लिए फ़ील्ड को मार्क करने के लिए, {merge: true} के साथ updateDoc() या setDoc() के साथ इस्तेमाल के लिए सेंटिनल दिखाता है.
documentId()	किसी दस्तावेज़ के आईडी को रेफ़र करने के लिए, खास सेंटिनल FieldPath दिखाता है. दस्तावेज़ के आईडी के हिसाब से क्रम में लगाने या फ़िल्टर करने के लिए, इसका इस्तेमाल क्वेरी में किया जा सकता है.
getFirestore()	यह फ़ंक्शन डिफ़ॉल्ट FirebaseApp से जुड़ा, मौजूदा डिफ़ॉल्ट Firestore इंस्टेंस दिखाता है. अगर कोई इंस्टेंस मौजूद नहीं है, तो डिफ़ॉल्ट सेटिंग के साथ नया इंस्टेंस शुरू करता है.
servertimestamp()	लिखे गए डेटा में सर्वर से जनरेट किए गए टाइमस्टैंप को शामिल करने के लिए, setDoc() या updateDoc() के साथ इस्तेमाल किया गया सेंटिनल दिखाता है.
फ़ंक्शन(databaseId, ...)
getFirestore(databaseId)	(बीटा) डिफ़ॉल्ट FirebaseApp से जुड़ा मौजूदा Firestore इंस्टेंस दिखाता है. अगर कोई इंस्टेंस मौजूद नहीं है, तो डिफ़ॉल्ट सेटिंग के साथ नया इंस्टेंस शुरू करता है.
फ़ंक्शन(एलिमेंट, ...)
ArrayRemove(एलिमेंट)	एक खास वैल्यू दिखाता है, जिसका इस्तेमाल setDoc() के साथ किया जा सकता है या जो सर्वर को सर्वर पर पहले से मौजूद किसी भी अरे वैल्यू से दिए गए एलिमेंट को हटाने के लिए कहता है. दिए गए हर एलिमेंट के सभी इंस्टेंस, अरे से हटा दिए जाएंगे. जिस फ़ील्ड में बदलाव किया जा रहा है, अगर वह पहले से कोई अरे नहीं है, तो उसे खाली अरे से ओवरराइट कर दिया जाएगा.
rangeUnion(एलिमेंट)	एक खास वैल्यू दिखाता है, जिसका इस्तेमाल setDoc() या updateDoc() के साथ किया जा सकता है. यह सर्वर को दिए गए एलिमेंट को, सर्वर पर पहले से मौजूद किसी भी अरे वैल्यू के साथ जोड़ने के लिए कहता है. बताए गए हर उस एलिमेंट को आखिर में जोड़ दिया जाएगा जो कलेक्शन में पहले से मौजूद नहीं है. अगर जिस फ़ील्ड में बदलाव किया जा रहा है वह पहले से कोई अरे नहीं है, तो उसे ऐसे अरे से ओवरराइट कर दिया जाएगा जिसमें ठीक बताए गए एलिमेंट शामिल होंगे.
फ़ंक्शन(फ़ील्ड, ...)
औसत(फ़ील्ड)	एक ऐसा AggregateField ऑब्जेक्ट बनाएं जिसका इस्तेमाल करके, क्वेरी के नतीजों के सेट में मौजूद दस्तावेज़ों की रेंज पर किसी खास फ़ील्ड के औसत का हिसाब लगाया जा सके.
योग(फ़ील्ड)	ऐसा AggregateField ऑब्जेक्ट बनाएं जिसका इस्तेमाल करके, क्वेरी के नतीजों के सेट में मौजूद दस्तावेज़ों की रेंज में किसी खास फ़ील्ड के योग का हिसाब लगाया जा सके.
फ़ंक्शन(fieldPath, ...)
orderBy(fieldPath, guidelinesStr)	ऐसा QueryOrderByConstraint बनाता है जो क्वेरी के नतीजे को बताए गए फ़ील्ड के मुताबिक क्रम से लगाता है. वैकल्पिक रूप से, बढ़ते क्रम में के बजाय घटते क्रम में लगाता है.ध्यान दें: जिन दस्तावेज़ों में तय फ़ील्ड नहीं होता है वे क्वेरी के नतीजे में मौजूद नहीं होंगे.
कहां(fieldPath, opStr, वैल्यू)	एक ऐसा QueryFieldFilterConstraint बनाता है जो यह लागू करता है कि दस्तावेज़ों में तय किया गया फ़ील्ड होना चाहिए और वैल्यू को दिए गए रिलेशन कंस्ट्रेंट को पूरा करना चाहिए.
फ़ंक्शन(fieldValues, ...)
endAt(fieldValues)	ऐसा QueryEndAtConstraint बनाता है, जो क्वेरी के क्रम के हिसाब से दिए गए फ़ील्ड पर खत्म होने वाले नतीजे के सेट में बदलाव करता है. फ़ील्ड की वैल्यू का क्रम, क्वेरी के क्लॉज़ के मुताबिक क्रम से मैच होना चाहिए.
endbefore(fieldValues)	ऐसा QueryEndAtConstraint बनाता है, जो क्वेरी के क्रम के हिसाब से दिए गए फ़ील्ड से पहले खत्म होने वाले नतीजे में बदलाव करता है. फ़ील्ड की वैल्यू का क्रम, क्वेरी के क्लॉज़ के मुताबिक क्रम से मैच होना चाहिए.
startAfter(fieldValues)	यह एक QueryStartAtConstraint बनाता है, जो क्वेरी के क्रम के हिसाब से दिए गए फ़ील्ड के बाद, शुरू होने के लिए सेट किए गए नतीजे में बदलाव करता है. फ़ील्ड की वैल्यू का क्रम, क्वेरी के क्लॉज़ के मुताबिक क्रम से मैच होना चाहिए.
startAt(fieldValues)	यह एक QueryStartAtConstraint बनाता है, जो क्वेरी के क्रम के हिसाब से, दिए गए फ़ील्ड से शुरू होने के लिए सेट किए गए नतीजे में बदलाव करता है. फ़ील्ड की वैल्यू का क्रम, क्वेरी के क्लॉज़ के मुताबिक क्रम से मैच होना चाहिए.
फ़ंक्शन(बाएं, ...)
aggregateFieldEqual(लेफ़्ट, राइट)	यह बराबरी के दो 'AggregateField` इंस्टेंस की तुलना करता है.
aggregateQuerySnapshotEqual(लेफ़्ट, राइट)	बराबरी के लिए, दो AggregateQuerySnapshot इंस्टेंस की तुलना करता है.दो AggregateQuerySnapshot इंस्टेंस को "बराबर" माना जाता है होना चाहिए, अगर सभी क्वेरी एक जैसी हों और उनमें एक जैसा डेटा हो.
queryEqual(बाएं, दाएं)	अगर दी गई क्वेरी एक ही कलेक्शन पर ले जाती हैं और एक जैसे कंस्ट्रेंट को लागू करती हैं, तो 'सही' दिखाता है.
refEqual(बाएं, दाएं)	अगर दिए गए रेफ़रंस बराबर होते हैं, तो 'सही' दिखाता है.
sSnapshotEqual(बाएं, दाएं)	अगर दिए गए स्नैपशॉट बराबर होते हैं, तो 'सही' दिखाता है.
फ़ंक्शन(limit, ...)
सीमा(सीमा)	ऐसा QueryLimitConstraint बनाता है, जो सिर्फ़ मेल खाने वाले पहले दस्तावेज़ दिखाता है.
limitToLast(limit)	ऐसा QueryLimitConstraint बनाता है, जो सिर्फ़ मिलते-जुलते आखिरी दस्तावेज़ दिखाता है.आपको limitToLast क्वेरी के लिए कम से कम एक orderBy क्लॉज़ तय करना होगा. ऐसा न करने पर, एक्ज़ीक्यूशन के दौरान एक अपवाद पैदा हो जाएगा.
फ़ंक्शन(loglevel, ...)
setLoglevel(logLevel)	Cloud Firestore लॉग (डीबग, गड़बड़ी या साइलेंट) की ज़्यादा जानकारी सेट करता है.
फ़ंक्शन(n, ...)
बढ़ोतरी(n)	ऐसी खास वैल्यू दिखाता है जिसका इस्तेमाल setDoc() या updateDoc() के साथ किया जा सकता है. इससे सर्वर को, दी गई वैल्यू के हिसाब से फ़ील्ड की मौजूदा वैल्यू को बढ़ाने के लिए कहा जाता है.अगर ऑपरेंड या मौजूदा फ़ील्ड की वैल्यू में से किसी एक में फ़्लोटिंग पॉइंट का सटीक इस्तेमाल होता है, तो सभी अंकगणित आईईईई 754 सिमैंटिक को फ़ॉलो करता है. अगर दोनों वैल्यू पूर्णांक हैं, तो JavaScript की सुरक्षित संख्या रेंज (Number.MIN_SAFE_INTEGER से Number.MAX_SAFE_INTEGER) से बाहर की वैल्यू पर भी पूरी तरह से वैल्यू का असर पड़ सकता है. इसके अलावा, Firestore बैकएंड से प्रोसेस होने के बाद, सभी पूर्णांक कार्रवाइयां -2^63 और 2^63-1 के बीच सीमित होती हैं.अगर मौजूदा फ़ील्ड वैल्यू number टाइप की नहीं है या फ़ील्ड मौजूद नहीं है, तो ट्रांसफ़ॉर्मेशन फ़ील्ड को दी गई वैल्यू पर सेट कर देता है.
फ़ंक्शन(क्वेरी, ...)
getAggregate(query, Aggregatespec)	असल में दस्तावेज़ डाउनलोड किए बिना, दी गई क्वेरी के नतीजे के सेट में बताए गए एग्रीगेशन की गणना करता है.एग्रीगेशन के लिए इस फ़ंक्शन का इस्तेमाल करना कारगर है, क्योंकि सिर्फ़ फ़ाइनल एग्रीगेशन वैल्यू का इस्तेमाल किया जाता है, न कि दस्तावेज़ डेटा को डाउनलोड किया जाता है. यह फ़ंक्शन, उन मामलों में दस्तावेज़ों को एग्रीगेशन कर सकता है जहां नतीजे का सेट पूरी तरह से डाउनलोड करने के लिए बहुत बड़ा है (हज़ारों दस्तावेज़).
getCount(क्वेरी)	यह फ़ंक्शन, दस्तावेज़ डाउनलोड किए बिना, दी गई क्वेरी के नतीजों के सेट में मौजूद दस्तावेज़ों की संख्या का हिसाब लगाता है.दस्तावेज़ों की गिनती करने के लिए, इस फ़ंक्शन का इस्तेमाल करना काफ़ी आसान होता है. ऐसा इसलिए, क्योंकि दस्तावेज़ों की गिनती सिर्फ़ आखिर में की जाती है, दस्तावेज़ों की नहीं' डेटा डाउनलोड हो जाता है. यह फ़ंक्शन, उन मामलों में दस्तावेज़ों की गिनती कर सकता है जिनमें नतीजे के सेट को पूरी तरह से डाउनलोड करने पर पाबंदी लगाई गई हो. जैसे, हज़ारों दस्तावेज़.
getDocs(क्वेरी)	यह क्वेरी को एक्ज़ीक्यूट करता है और नतीजों को QuerySnapshot के तौर पर दिखाता है.सभी क्वेरी सीधे सर्वर से एक्ज़ीक्यूट की जाती हैं, भले ही क्वेरी पहले एक्ज़ीक्यूट की गई हो. हाल ही के बदलाव, वापस मिले नतीजों में सिर्फ़ तब दिखते हैं, जब उन्हें बैकएंड से पहले ही लागू किया गया हो. अगर क्लाइंट ऑफ़लाइन है, तो कार्रवाई नहीं हो पाती. पहले से कैश मेमोरी में सेव किए गए नतीजे और स्थानीय बदलाव देखने के लिए, पूरे Firestore SDK टूल का इस्तेमाल करें.
query(query, assetFilter, queryConstraints)	क्वेरी का एक ऐसा नया इंस्टेंस बनाता है जिसे बदला नहीं जा सकता. इसे बढ़ाया गया है. इसमें क्वेरी के अन्य कंस्ट्रेंट को भी शामिल किया जाता है.
क्वेरी(क्वेरी, queryConstraints)	क्वेरी का एक ऐसा नया इंस्टेंस बनाता है जिसे बदला नहीं जा सकता. इसे बढ़ाया गया है. इसमें क्वेरी के अन्य कंस्ट्रेंट को भी शामिल किया जाता है.
फ़ंक्शन(queryConstraints, ...)
और(queryConstraints)	एक नया QueryCompositeFilterConstraint बनाता है, जो दिए गए फ़िल्टर कंस्ट्रेंट का कॉम्बिनेशन होता है. कॉम्बिनेशन फ़िल्टर में, कोई दस्तावेज़ तब शामिल होता है, जब वह दिए गए सभी फ़िल्टर के मुताबिक हो.
या(queryConstraints)	एक नया QueryCompositeFilterConstraint बनाता है, जो दिए गए फ़िल्टर कंस्ट्रेंट का डिस्ट्रिब्यूशन होता है. डिसजक्शन फ़िल्टर में कोई दस्तावेज़ तब शामिल होता है, जब वह दिए गए किसी भी फ़िल्टर की शर्तों को पूरा करता है.
फ़ंक्शन(रेफ़रंस, ...)
addDoc(रेफ़रंस, डेटा)	बताए गए डेटा के साथ CollectionReference में नया दस्तावेज़ जोड़ें और इसे अपने-आप दस्तावेज़ आईडी असाइन करें.इस बदलाव का नतीजा, सिर्फ़ उन दस्तावेज़ों में दिखेगा जो लौटाए गए प्रॉमिस का समाधान हो जाने के बाद होंगे. अगर क्लाइंट ऑफ़लाइन है, तो डेटा सेव नहीं हो पाता. अगर क्लाइंट के ऑनलाइन होने तक, आपको स्थानीय बदलाव या बफ़र राइट्स देखना है, तो पूरे Firestore SDK का इस्तेमाल करें.
कलेक्शन(रेफ़रंस, पाथ, पाथसेगमेंट)	इससे CollectionReference इंस्टेंस मिलता है, जो बताए गए रिलेटिव पाथ पर reference के सब-कलेक्शन दिखाता है.
कलेक्शन(रेफ़रंस, पाथ, पाथसेगमेंट)	इससे CollectionReference इंस्टेंस मिलता है, जो बताए गए रिलेटिव पाथ पर reference के सब-कलेक्शन दिखाता है.
deleteDoc(रेफ़रंस)	बताए गए DocumentReference के ज़रिए बताया गया दस्तावेज़ मिटाता है.यह मिटाया गया दस्तावेज़, सिर्फ़ उन लेखों में दिखेगा जो प्रॉमिस प्रॉमिस रिज़ॉल्व होने के बाद आते हैं. अगर क्लाइंट ऑफ़लाइन है, तो मिटाया नहीं जा सकता. अगर क्लाइंट के ऑनलाइन होने तक, आपको स्थानीय बदलाव या बफ़र राइट्स देखना है, तो पूरे Firestore SDK का इस्तेमाल करें.
दस्तावेज़(रेफ़रंस, पाथ, पाथसेगमेंट)	इससे ऐसा DocumentReference इंस्टेंस मिलता है जो बताए गए रिलेटिव पाथ पर reference में मौजूद किसी दस्तावेज़ के बारे में बताता है. अगर कोई पाथ नहीं डाला गया है, तो लौटाए गए DocumentReference के लिए, अपने-आप जनरेट होने वाले यूनीक आईडी का इस्तेमाल किया जाएगा.
दस्तावेज़(रेफ़रंस, पाथ, पाथसेगमेंट)	इससे ऐसा DocumentReference इंस्टेंस मिलता है जो बताए गए रिलेटिव पाथ पर reference में मौजूद किसी दस्तावेज़ के बारे में बताता है.
getDoc(रेफ़रंस)	दिए गए दस्तावेज़ के रेफ़रंस के ज़रिए बताए गए दस्तावेज़ को पढ़ता है.सभी दस्तावेज़ सीधे सर्वर से फ़ेच किए जाते हैं, भले ही दस्तावेज़ को पहले पढ़ा गया हो या उसमें बदलाव किया गया हो. हाल ही के बदलाव, वापस लाए गए DocumentSnapshot में सिर्फ़ तब दिखते हैं, जब उन्हें बैकएंड से पहले ही लागू किया गया हो. अगर क्लाइंट ऑफ़लाइन है, तो मैसेज नहीं पढ़ा जा सकता. अगर आपको कैश मेमोरी में डेटा स्टोर करना है या लोकल स्टोरेज में बदलाव देखने हैं, तो कृपया पूरे Firestore SDK टूल का इस्तेमाल करें.
setDoc(रेफ़रंस, डेटा)	तय किए गए DocumentReference के बताए गए दस्तावेज़ में लिखता है. अगर दस्तावेज़ अब तक मौजूद नहीं है, तो इसे बनाया जाएगा.इस बदलाव का नतीजा, दस्तावेज़ के उन लेखों में दिखेगा जो लौटाए गए प्रॉमिस का समाधान हो जाने के बाद किए गए थे. अगर क्लाइंट ऑफ़लाइन है, तो डेटा सेव नहीं हो पाता. अगर क्लाइंट के ऑनलाइन होने तक, आपको स्थानीय बदलाव या बफ़र राइट्स देखना है, तो पूरे Firestore SDK का इस्तेमाल करें.
setDoc(रेफ़रंस, डेटा, विकल्प)	तय किए गए DocumentReference के बताए गए दस्तावेज़ में लिखता है. अगर दस्तावेज़ अब तक मौजूद नहीं है, तो इसे बना दिया जाएगा. अगर merge या mergeFields उपलब्ध कराया जाता है, तो दिए गए डेटा को किसी मौजूदा दस्तावेज़ में मर्ज किया जा सकता है.इस बदलाव का नतीजा, दस्तावेज़ के उन लेखों में दिखेगा जो लौटाए गए प्रॉमिस का समाधान हो जाने के बाद होते हैं. अगर क्लाइंट ऑफ़लाइन है, तो डेटा सेव नहीं हो पाता. अगर क्लाइंट के ऑनलाइन होने तक, आपको स्थानीय बदलाव या बफ़र राइट्स देखना है, तो पूरे Firestore SDK का इस्तेमाल करें.
updateDoc(रेफ़रंस, डेटा)	बताए गए DocumentReference के बताए गए दस्तावेज़ में फ़ील्ड अपडेट करता है. अगर किसी ऐसे दस्तावेज़ पर लागू किया जाता है जो मौजूद नहीं है, तो अपडेट नहीं हो पाएगा.इस अपडेट का नतीजा, दस्तावेज़ के उन लेखों में दिखेगा जो प्रॉमिस रिज़ॉल्व होने के बाद होते हैं. अगर क्लाइंट ऑफ़लाइन है, तो अपडेट नहीं हो पाता. अगर क्लाइंट के ऑनलाइन होने तक, आपको स्थानीय बदलाव या बफ़र राइट्स देखना है, तो पूरे Firestore SDK का इस्तेमाल करें.
updateDoc(reference, फ़ील्ड, वैल्यू, moreFieldsAndValues)	तय किए गए DocumentReference के बताए गए दस्तावेज़ के फ़ील्ड को अपडेट करता है. अगर किसी ऐसे दस्तावेज़ पर लागू किया जाता है जो मौजूद नहीं है, तो अपडेट नहीं हो पाएगा.डॉट से अलग किए गए फ़ील्ड पाथ की स्ट्रिंग देकर या FieldPath ऑब्जेक्ट देकर, नेस्ट किए गए फ़ील्ड अपडेट किए जा सकते हैं.इस अपडेट का नतीजा, दस्तावेज़ के रीड में सिर्फ़ उन नतीजों में दिखेगा जो प्रॉमिस रिज़ॉल्व होने के बाद होते हैं. अगर क्लाइंट ऑफ़लाइन है, तो अपडेट नहीं हो पाता. अगर क्लाइंट के ऑनलाइन होने तक, आपको स्थानीय बदलाव या बफ़र राइट्स देखना है, तो पूरे Firestore SDK का इस्तेमाल करें.
फ़ंक्शन(स्नैपशॉट, ...)
endAt(स्नैपशॉट)	एक ऐसा QueryEndAtConstraint बनाता है जो नतीजे के सेट को दिए गए दस्तावेज़ पर खत्म होने के लिए बदलता है (शामिल है). खत्म होने की पोज़िशन, क्वेरी के क्रम के हिसाब से होती है. दस्तावेज़ में वे सभी फ़ील्ड होने चाहिए जो क्वेरी के orderBy में दिए गए हों.
endbefore(स्नैपशॉट)	एक ऐसा QueryEndAtConstraint बनाता है जो नतीजे के सेट को दिए गए दस्तावेज़ (खास तौर पर) से पहले खत्म होने के लिए सेट करता है. खत्म होने की पोज़िशन, क्वेरी के क्रम के हिसाब से होती है. दस्तावेज़ में वे सभी फ़ील्ड होने चाहिए जो क्वेरी के orderBy में दिए गए हों.
startAfter(स्नैपशॉट)	एक QueryStartAtConstraint बनाता है, जो दिए गए दस्तावेज़ (खास तौर पर) के बाद शुरू होने के लिए नतीजे सेट को बदलता है. शुरुआती स्थिति क्वेरी के क्रम के हिसाब से होती है. दस्तावेज़ में वे सभी फ़ील्ड होने चाहिए जो क्वेरी के orderBy में दिए गए हों.
startAt(स्नैपशॉट)	यह एक QueryStartAtConstraint बनाता है, जो दिए गए दस्तावेज़ से शुरू होने वाले नतीजे के सेट में बदलाव करता है, ताकि उसे दिए गए दस्तावेज़ से जोड़ा जा सके. शुरुआती स्थिति क्वेरी के क्रम के हिसाब से होती है. दस्तावेज़ में इस क्वेरी के orderBy में दिए गए सभी फ़ील्ड शामिल होने चाहिए.
फ़ंक्शन(वैल्यू, ...)
वेक्टर(वैल्यू)	संख्याओं के दिए गए कलेक्शन की कॉपी से नया VectorValue बनाता है.

क्लास

क्लास	ब्यौरा
एग्रीगेट फ़ील्ड	यह ऐसे एग्रीगेशन को दिखाता है जिसे Firestore से किया जा सकता है.
AggregateQuerySnapshot	किसी एग्रीगेशन क्वेरी को लागू करने के नतीजे.
बाइट	नहीं बदला जा सकने वाला ऑब्जेक्ट, जो बाइट का कलेक्शन दिखाता है.
कलेक्शनरेफ़रंस	CollectionReference ऑब्जेक्ट का इस्तेमाल, दस्तावेज़ जोड़ने, दस्तावेज़ के रेफ़रंस पाने, और दस्तावेज़ों के लिए क्वेरी करने के लिए किया जा सकता है. इसके लिए, query() का इस्तेमाल किया जा सकता है.
DocumentReference	DocumentReference, Firestore डेटाबेस में दस्तावेज़ की जगह को दिखाता है. इसका इस्तेमाल जगह की जानकारी लिखने, पढ़ने या सुनने के लिए किया जा सकता है. ऐसा हो सकता है कि बताए गए जगह पर मौजूद दस्तावेज़ मौजूद हो या नहीं.
DocumentSnapshot	DocumentSnapshot में, आपके Firestore डेटाबेस के किसी दस्तावेज़ से पढ़ा गया डेटा शामिल होता है. कोई खास फ़ील्ड पाने के लिए, डेटा को .data() या .get(<field>) की मदद से निकाला जा सकता है.ऐसे DocumentSnapshot के लिए जो किसी ऐसे दस्तावेज़ पर ले जाता है जो मौजूद नहीं है, डेटा ऐक्सेस करने पर इसकी वैल्यू 'तय नहीं है' दिखेगी. किसी दस्तावेज़ की मौजूदगी की साफ़ तौर पर पुष्टि करने के लिए, exists() तरीके का इस्तेमाल किया जा सकता है.
FieldPath	FieldPath, दस्तावेज़ में मौजूद फ़ील्ड के बारे में बताता है. पाथ में सिर्फ़ एक फ़ील्ड का नाम (दस्तावेज़ में टॉप लेवल फ़ील्ड का संदर्भ देते हुए) या फ़ील्ड के नामों की सूची (दस्तावेज़ में नेस्ट किए गए फ़ील्ड से जुड़ा हुआ) हो सकती है.फ़ील्ड के नाम देकर एक FieldPath बनाएं. अगर एक से ज़्यादा फ़ील्ड का नाम दिया गया है, तो पाथ किसी दस्तावेज़ में नेस्ट किए गए फ़ील्ड पर ले जाएगा.
फ़ील्ड की वैल्यू	सेंटिनल वैल्यू, जिनका इस्तेमाल set() या update() की मदद से, दस्तावेज़ के फ़ील्ड लिखते समय किया जा सकता है.
फ़ायरस्टोर	Cloud Firestore का सेवा इंटरफ़ेस.इस कंस्ट्रक्टर को सीधे कॉल न करें. इसके बजाय, getFirestore() का इस्तेमाल करें.
Firestoreगड़बड़ी	Firestore ऑपरेशन से एक गड़बड़ी मिली.
जियोपॉइंट	Firestore में भौगोलिक जगह को दिखाने वाला एक ऐसा ऑब्जेक्ट जिसमें बदलाव नहीं किया जा सकता. जगह को अक्षांश/देशांतर जोड़े के तौर पर दिखाया जाता है.अक्षांश और देशांतर [-90, 90] की रेंज में होते हैं. देशांतर वैल्यू [-180, 180] की रेंज में होती हैं.
क्वेरी	Query ऐसी क्वेरी के बारे में बताता है जिसे पढ़ा या सुना जा सकता है. फ़िल्टर और क्रम जोड़कर भी बेहतर Query ऑब्जेक्ट बनाए जा सकते हैं.
QueryCompositeFilterConstraint	QueryCompositeFilterConstraint का इस्तेमाल, एक से ज़्यादा QueryFieldFilterConstraints या QueryCompositeFilterConstraints के लॉजिकल OR या AND की मदद से वैल्यू के तौर पर दिए गए दस्तावेज़ों के सेट को सटीक बनाने के लिए किया जाता है. QueryCompositeFilterConstraint, or() या and() को शुरू करके बनाए जाते हैं. इसके बाद, इन्हें query() में पास किया जा सकता है, ताकि ऐसा नया क्वेरी इंस्टेंस बनाया जा सके जिसमें QueryCompositeFilterConstraint भी शामिल हो.
QueryConstraint	QueryConstraint का इस्तेमाल, Firestore क्वेरी से दिखाए गए दस्तावेज़ों के सेट को सटीक बनाने के लिए किया जाता है. QueryConstraint को where(), orderBy(), startAt(), startAfter(), endAfter(), endAt(), limit(), limitToLast(), limitToLast() को लागू करने से बनाया जाता है. इसके बाद, क्वेरी() बनाने के लिए, एक नई क्वेरी पास की जा सकती हैQueryConstraint
QueryDocumentSnapshot	QueryDocumentSnapshot में, क्वेरी के हिस्से के तौर पर आपके Firestore डेटाबेस में मौजूद किसी दस्तावेज़ से पढ़ा गया डेटा शामिल होता है. इस बात की गारंटी है कि दस्तावेज़ मौजूद रहेगा. साथ ही, किसी खास फ़ील्ड को पाने के लिए, इसका डेटा .data() या .get(<field>) की मदद से निकाला जा सकता है.QueryDocumentSnapshot DocumentSnapshot जैसा ही एपीआई प्लैटफ़ॉर्म उपलब्ध कराता है. क्वेरी के नतीजों में सिर्फ़ मौजूदा दस्तावेज़ शामिल हैं. इसलिए, exists प्रॉपर्टी हमेशा सही होगी और data() कभी भी 'undefined' नहीं दिखाएगा.
QueryEndAtConstraint	QueryEndAtConstraint का इस्तेमाल, Firestore क्वेरी से मिले नतीजों के सेट के आखिर से दस्तावेज़ों को हटाने के लिए किया जाता है. QueryEndAtConstraint को endAt() या endbefore() को लागू करके बनाया जाता है. इसके बाद, इसे query() को पास किया जा सकता है, ताकि एक ऐसा नया क्वेरी इंस्टेंस बनाया जा सके जिसमें यह QueryEndAtConstraint भी शामिल हो.
QueryFieldFilterConstraint	QueryFieldFilterConstraint का इस्तेमाल, एक या एक से ज़्यादा दस्तावेज़ के फ़ील्ड को फ़िल्टर करके, Firestore क्वेरी से मिले दस्तावेज़ों के सेट को सटीक बनाने के लिए किया जाता है. QueryFieldFilterConstraint को where() को लागू करके बनाया जाता है. इसके बाद, इसे query() में पास किया जा सकता है, ताकि ऐसा नया क्वेरी इंस्टेंस बनाया जा सके जिसमें यह QueryFieldFilterConstraint भी शामिल हो.
QuerylimitConstraint	QueryLimitConstraint का इस्तेमाल, Firestore क्वेरी से दिखाए जाने वाले दस्तावेज़ों की संख्या को सीमित करने के लिए किया जाता है. QueryLimitConstraint को limit() या limitToLast() को लागू करके बनाया जाता है. इसके बाद, इसे query() को पास किया जा सकता है, ताकि एक ऐसा नया क्वेरी इंस्टेंस बनाया जा सके जिसमें यह QueryLimitConstraint भी शामिल हो.
QueryOrderByConstraint	QueryOrderByConstraint का इस्तेमाल, Firestore क्वेरी से दिखाए गए दस्तावेज़ों के सेट को क्रम से लगाने के लिए किया जाता है. QueryOrderByConstraint को orderBy() का इस्तेमाल करके बनाया जाता है. इसके बाद, इसे query() में पास किया जा सकता है, ताकि एक ऐसा नया क्वेरी इंस्टेंस बनाया जा सके जिसमें यह QueryOrderByConstraint भी शामिल हो.ध्यान दें: जिन दस्तावेज़ों में OrderBy फ़ील्ड नहीं होगा वे क्वेरी के नतीजे में मौजूद नहीं होंगे.
QuerySnapshot	QuerySnapshot में, शून्य या उससे ज़्यादा DocumentSnapshot ऑब्जेक्ट हैं, जो क्वेरी के नतीजे दिखाते हैं. docs प्रॉपर्टी से दस्तावेज़ों को कलेक्शन के तौर पर ऐक्सेस किया जा सकता है या forEach तरीके का इस्तेमाल करके इनकी गिनती की जा सकती है. empty और size प्रॉपर्टी की मदद से, दस्तावेज़ों की संख्या तय की जा सकती है.
QueryStartAtConstraint	QueryStartAtConstraint का इस्तेमाल, Firestore क्वेरी से मिले नतीजों के सेट की शुरुआत से दस्तावेज़ों को हटाने के लिए किया जाता है. QueryStartAtConstraint को startAt() या startAfter() को लागू करके बनाया जाता है. इसके बाद, उन्हें query() को पास किया जा सकता है, ताकि एक ऐसा नया क्वेरी इंस्टेंस बनाया जा सके जिसमें यह QueryStartAtConstraint भी शामिल हो.
टाइमस्टैंप	Timestamp, किसी भी टाइम ज़ोन या कैलेंडर से अलग समय के पॉइंट को दिखाता है. इसे यूटीसी एपिच टाइम में, नैनोसेकंड रिज़ॉल्यूशन में सेकंड और सेकंड के रूप में दिखाया जाता है.इसे प्रोलेप्टिक ग्रेगोरियन कैलेंडर का इस्तेमाल करके कोड में बदला जाता है, जो ग्रेगोरियन कैलेंडर को साल एक साल के पीछे तक बढ़ा देता है. इसे यह मानकर कोड में बदला जाता है कि सभी मिनट 60 सेकंड लंबे हैं. इसका मतलब है कि लीप सेकंड "स्मीयर" होते हैं ताकि व्याख्या के लिए किसी लीप सेकंड टेबल की ज़रूरत न पड़े. यह सीमा 0001-01-01T00:00:00Z से 9999-12-31T23:59:59.999999999Z तक है.उदाहरण और अन्य जानकारी के लिए, टाइमस्टैंप की परिभाषा देखें.
लेन-देन	ट्रांज़ैक्शन का रेफ़रंस.लेन-देन के updateFunction को पास किया गया Transaction ऑब्जेक्ट, ट्रांज़ैक्शन के कॉन्टेक्स्ट में डेटा को देखने और उसमें बदलाव करने के तरीके उपलब्ध कराता है. runलेन-देन() देखें.
वेक्टरवैल्यू	Firestore दस्तावेज़ों में वेक्टर टाइप को दिखाता है. का इस्तेमाल करके एक इंस्टेंस बनाएं . वेक्टरवैल्यू
WriteBatch	राइट बैच, जिसका इस्तेमाल एक ऐटॉमिक यूनिट के रूप में कई बार लिखने के लिए किया जाता है.writeBatch() को कॉल करके WriteBatch ऑब्जेक्ट हासिल किया जा सकता है. यह राइट बैच में राइट जोड़ने के तरीके उपलब्ध कराता है. जब तक WriteBatch.commit() को कॉल नहीं किया जाता, तब तक कोई भी लिखा गया कॉन्टेंट शेयर नहीं किया जाएगा या उसे स्थानीय तौर पर देखा जा सकेगा.

इंटरफ़ेस

इंटरफ़ेस	ब्यौरा
एग्रीगेट जानकारी	एग्रीगेशन और उनके उपनामों के सेट की जानकारी देता है.
दस्तावेज़ डेटा	दस्तावेज़ के डेटा (setDoc() के साथ इस्तेमाल के लिए) में वैल्यू के लिए मैप किए गए फ़ील्ड शामिल होते हैं.
FirestoreDataConverter	withConverter() के ज़रिए कन्वर्टर का इस्तेमाल AppModelType प्रकार के उपयोगकर्ता ऑब्जेक्ट को DbModelType प्रकार के Firestore डेटा में बदलने के लिए किया जाता है.कन्वर्टर का इस्तेमाल करने से आप Firestore से ऑब्जेक्ट को स्टोर और हासिल करते समय सामान्य प्रकार के तर्क तय कर सकते हैं.इस संदर्भ में, "AppModel" एक क्लास है जिसका इस्तेमाल ऐप्लिकेशन में संबंधित जानकारी और फ़ंक्शन को एक साथ पैकेज करने के लिए किया जाता है. उदाहरण के लिए, ऐसे क्लास में जटिल, नेस्ट किए गए डेटा टाइप वाली प्रॉपर्टी, मेमो बनाने के लिए इस्तेमाल की जाने वाली प्रॉपर्टी, Firestore के साथ काम न करने वाली प्रॉपर्टी (जैसे कि symbol और bigint), और कंपाउंड ऑपरेशन पूरे करने वाले हेल्पर फ़ंक्शन हो सकते हैं. इस तरह की क्लास Firestore डेटाबेस में सेव करने के लिए सही और/या मुमकिन नहीं होती हैं. इसके बजाय, इस तरह की क्लास के इंस्टेंस को "पुराने JavaScript ऑब्जेक्ट" में बदलना होगा (POJO) खास तौर पर शुरुआती प्रॉपर्टी वाले, जो संभावित रूप से अन्य POJO या POJO के कलेक्शन में नेस्ट किए गए होते हैं. इस कॉन्टेक्स्ट में, इस टाइप को "DbModel" कहा जाता है और यह एक ऐसी चीज़ होगी, जो Firestore में बने रहने के लिहाज़ से सही होगी. सुविधा के लिए, ऐप्लिकेशन FirestoreDataConverter को लागू कर सकते हैं और DocumentReference या Query जैसे Firestore ऑब्जेक्ट के साथ कन्वर्टर को रजिस्टर कर सकते हैं. ऐसा करके, उन्हें Firestore में स्टोर करते समय AppModel को DbModel में अपने-आप बदल दिया जाता है. साथ ही, Firestore से वापस पाने के दौरान DbModel को AppModel में बदला जा सकता है.
सेटिंग	आपके Cloud Firestore इंस्टेंस के लिए, कस्टम कॉन्फ़िगरेशन तय करता है. किसी दूसरे तरीके का इस्तेमाल करने से पहले, आपको इन्हें सेट करना होगा.
लेन-देन के विकल्प	लेन-देन को पसंद के मुताबिक बनाने के विकल्प.

उपनामों का प्रकार

उपनाम टाइप करें	ब्यौरा
AddPrefixToKeys	एक नया मैप दिखाता है, जहां हर कुंजी के शुरू में बाहरी कुंजी को बिंदु से जोड़ा जाता है.
एग्रीगेट फ़ील्ड टाइप	सभी AggregateField टाइप जो Firestore के साथ काम करते हैं उनका कॉम्बिनेशन.
AggregatespecData	ऐसा टाइप जिसकी कुंजियां AggregateSpec से ली जाती हैं और जिनकी वैल्यू, इनपुट AggregateSpec से, संबंधित AggregateField की ओर से किए गए एग्रीगेशन का नतीजा होती हैं.
एग्रीगेट टाइप	यूनियन टाइप, जो परफ़ॉर्म किए जाने वाले एग्रीगेट टाइप को दिखाता है.
childUpdateFields	दिए गए टाइप T1 के लिए, नेस्ट किए गए फ़ील्ड का हिसाब लगाने में मदद करने वाला टूल. इसकी ज़रूरत undefined | {...} (वैकल्पिक प्रॉप्स के लिए होती है) या {a: A} | {b: B} जैसे यूनियन टाइप को बांटने के लिए होती है.इस्तेमाल के इस मामले में, V का इस्तेमाल Record पर T[K] के यूनियन टाइप को बांटने के लिए किया जाता है, क्योंकि T[K] का आकलन एक्सप्रेशन के तौर पर किया जाता है, न कि डिस्ट्रिब्यूट किया गया.https://www.typescriptlang.org/docs/handbook/advanced-types.html#distributive-conditional-types देखें
FirestoreErrorCode	Firestore स्टेटस कोड का सेट. gRPC के ज़रिए दिखाए गए कोड यहां एक जैसे हैं: https://github.com/grpc/grpc/blob/Master/doc/statuscodes.mdसंभावित वैल्यू: - 'cancelled': कार्रवाई रद्द कर दी गई है (आम तौर पर कॉलर की ओर से). - 'जानकारी नहीं है': ऐसी गड़बड़ी या किसी दूसरे गड़बड़ी डोमेन की गड़बड़ी. - 'अमान्य तर्क': क्लाइंट ने कोई अमान्य तर्क बताया है. ध्यान दें कि यह 'पहले से तय की गई शर्त' से अलग है. 'अमान्य-तर्क' यह ऐसे तर्क को दिखाता है जिनमें सिस्टम की स्थिति की परवाह किए बिना समस्या होती है (उदाहरण के लिए, किसी फ़ील्ड का अमान्य नाम). - 'समयसीमा खत्म हो गई है': कार्रवाई पूरी होने से पहले समयसीमा खत्म हो गई है. सिस्टम की स्थिति बदलने वाले ऑपरेशन के लिए, यह गड़बड़ी दिखाई जा सकती है, भले ही कार्रवाई पूरी तरह से पूरी हो गई हो. उदाहरण के लिए, हो सकता है कि सर्वर से सही जवाब मिलने में ज़्यादा समय लगे और समयसीमा खत्म होने में देरी हो. - 'नहीं मिला': अनुरोध किया गया कुछ दस्तावेज़ नहीं मिला. - 'पहले से मौजूद है': हमने जो दस्तावेज़ बनाने की कोशिश की थी वह पहले से मौजूद है. - 'अनुमति नहीं दी गई': कॉलर के पास बताए गए ऑपरेशन को लागू करने की अनुमति नहीं है. - 'संसाधन खत्म': कुछ संसाधन खत्म हो गए हैं. ऐसा शायद हर उपयोगकर्ता के लिए कोटा खत्म हो गया हो या पूरे फ़ाइल सिस्टम में जगह न बची हो. - 'पहले से तय की गई शर्त': ऑपरेशन को अस्वीकार कर दिया गया था क्योंकि सिस्टम कार्रवाई के निष्पादन के लिए ज़रूरी स्थिति में नहीं है. - 'रद्द किया गया': आम तौर पर, लेन-देन रद्द होने जैसी किसी एक साथ काम करने की समस्या की वजह से कार्रवाई रद्द कर दी जाती है. - 'सीमा से बाहर': सही सीमा से बाहर जाने की कोशिश की गई. - 'लागू नहीं है': ऑपरेशन लागू नहीं किया गया है या काम नहीं करता/चालू नहीं है. - 'इंटरनल': अंदरूनी गड़बड़ियां. इसका मतलब है कि मौजूदा सिस्टम से उम्मीद के मुताबिक कुछ इन्वैरिएंट काम नहीं कर रहे हैं. अगर आपको इनमें से कोई एक गड़बड़ी दिखती है, तो इसका मतलब है कि कुछ ठीक से काम नहीं कर रहा है. - 'उपलब्ध नहीं है': यह सेवा फ़िलहाल उपलब्ध नहीं है. यह स्थिति थोड़े समय के लिए होती है और इसे ठीक करने के लिए, बैकऑफ़ के साथ फिर से कोशिश करें. - 'डेटा-लॉस': डेटा को वापस नहीं पाया जा सकता या खराब हो गया. - 'अप्रमाणित': कार्रवाई के लिए अनुरोध में मान्य प्रमाणीकरण क्रेडेंशियल नहीं हैं.
NestedUpdateFields	हर फ़ील्ड (जैसे कि 'बार') के लिए, नेस्ट की गई सभी कुंजियां ढूंढें (उदाहरण के लिए, {'bar.baz': T1, 'bar.QUx': T2}). उन्हें एक साथ काटकर एक ऐसा मैप बनाएं जिसमें 'ज़रूरी नहीं' के तौर पर मार्क की गई सभी संभावित कुंजियां हों
OrderByDirection	orderBy() क्लॉज़ की दिशा 'ब्यौरा' के तौर पर बताई गई है या 'बढ़ते क्रम में' (घटते क्रम में या बढ़ते क्रम में).
PartialWithFieldValue	यह TypeScript के Partial<T> की तरह है. हालांकि, इसमें नेस्ट किए गए फ़ील्ड को छोड़ा जा सकता है और फ़ील्ड वैल्यू को प्रॉपर्टी की वैल्यू के तौर पर पास किया जा सकता है.
शुरुआती	प्रिमिटिव टाइप.
QueryConstraintType	इस SDK टूल में उपलब्ध अलग-अलग क्वेरी कंस्ट्रेंट के बारे में बताता है.
QueryFilterConstraint	QueryFilterConstraint एक हेल्पर यूनियन टाइप है, जो QueryFieldFilterConstraint और QueryCompositeFilterConstraint को दिखाता है.
QueryNonFilterConstraint	QueryNonFilterConstraint एक हेल्पर यूनियन टाइप है, जो QueryConstraints को दिखाता है, जिनका इस्तेमाल दस्तावेज़ों के सेट को छोटा करने या क्रम से लगाने के लिए किया जाता है. हालांकि, यह दस्तावेज़ के फ़ील्ड पर साफ़ तौर पर फ़िल्टर नहीं करता है. QueryNonFilterConstraint को orderBy(), startAt(), startAfter(), endbefore(), endAt(), limit() या limitToLast() को लागू करके बनाया जाता है. इसके बाद, इसे query() में पास किया जा सकता है.QueryConstraint
SetOptions	एक विकल्प ऑब्जेक्ट, जो setDoc() और कॉल के व्यवहार को कॉन्फ़िगर करता है. इन कॉल को merge: true के साथ SetOptions देकर, टारगेट दस्तावेज़ों को ओवरराइट करने के बजाय, पूरी तरह से मर्ज करने के लिए कॉन्फ़िगर किया जा सकता है.
UnionToIntersection	यूनियन टाइप U = T1 | T2 | ... दिए जाने पर, इंटरसेक्टेड टाइप (T1 & T2 & ...) लौटाता है.कंडिशनल टाइप से मिले कंडिशनल टाइप और अनुमान का इस्तेमाल करता है. यह इसलिए काम करता है, क्योंकि कॉन्ट्रा-वैरिएंट पोज़िशन में एक ही टाइप वैरिएबल के लिए कई कैंडिडेट होते हैं. इसकी वजह से, इंटरसेक्शन का अनुमान लगाया जाता है. https://www.typescriptlang.org/docs/handbook/advanced-types.html#type-inference-in-conditional-types https://stackoverflow.com/questions/50374908/transform-union-type-to-intersection-type
UpdateData	updateDoc() के साथ इस्तेमाल करने के लिए डेटा अपडेट करें. इसमें वैल्यू के लिए मैप किए गए फ़ील्ड पाथ (जैसे कि 'foo' या 'foo.baz') शामिल हैं. जिन फ़ील्ड में बिंदु होते हैं वे दस्तावेज़ में नेस्ट किए गए फ़ील्ड का रेफ़रंस देते हैं. फ़ील्ड वैल्यू को प्रॉपर्टी की वैल्यू के तौर पर पास किया जा सकता है.
WhatFilterOp	where() क्लॉज़ में फ़िल्टर की शर्तों को '&lt;', '&lt;=', '==', '!=', '&gt;=', '&gt;', 'array-contains', 'in', 'array-contains-any', और 'not-in' स्ट्रिंग का इस्तेमाल करके तय किया जाता है.
WithFieldValue	प्रकार सुरक्षा बनाए रखते हुए, फ़ील्ड वैल्यू को प्रॉपर्टी मान के रूप में पास करने की अनुमति देता है.

फ़ंक्शन(ऐप्लिकेशन, ...)

getFirestore(ऐप्लिकेशन)

यह विकल्प, दिए गए FirebaseApp से जुड़ा डिफ़ॉल्ट Firestore इंस्टेंस दिखाता है. अगर कोई इंस्टेंस मौजूद नहीं है, तो डिफ़ॉल्ट सेटिंग के साथ नया इंस्टेंस शुरू करता है.

हस्ताक्षर:

export declare function getFirestore(app: FirebaseApp): Firestore;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
ऐप्लिकेशन	FirebaseApp	Firestore इंस्टेंस से जुड़ा FirebaseApp इंस्टेंस.

लौटाए जाने वाले प्रॉडक्ट:

फ़ायरस्टोर

दिए गए ऐप्लिकेशन का Firestore इंस्टेंस.

getFirestore(ऐप्लिकेशन, डेटाबेस आईडी)

इस एपीआई की झलक, डेवलपर को दी जाती है. अगर आपको मिलने वाले सुझाव/राय या शिकायत के आधार पर, इस एपीआई की सेटिंग में बदलाव किया जाता है, तो इसमें बदलाव हो सकता है. प्रोडक्शन एनवायरमेंट में इस एपीआई का इस्तेमाल न करें.

दिए गए FirebaseApp से जुड़ा मौजूदा Firestore इंस्टेंस दिखाता है. अगर कोई इंस्टेंस मौजूद नहीं है, तो डिफ़ॉल्ट सेटिंग के साथ नया इंस्टेंस शुरू करता है.

हस्ताक्षर:

export declare function getFirestore(app: FirebaseApp, databaseId: string): Firestore;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
ऐप्लिकेशन	FirebaseApp	Firestore इंस्टेंस से जुड़ा FirebaseApp इंस्टेंस.
डेटाबेस आईडी	स्ट्रिंग	डेटाबेस का नाम.

लौटाए जाने वाले प्रॉडक्ट:

फ़ायरस्टोर

दिए गए ऐप्लिकेशन का Firestore इंस्टेंस.

इनिशलाइज़फ़ायरस्टोर(ऐप्लिकेशन, सेटिंग)

दी गई सेटिंग के साथ Cloud Firestore के नए इंस्टेंस को शुरू करता है. इसे सिर्फ़ getFirestore() समेत किसी दूसरे फ़ंक्शन के पहले कॉल किया जा सकता है. अगर कस्टम सेटिंग खाली है, तो यह फ़ंक्शन getFirestore() को कॉल करने के बराबर होता है.

हस्ताक्षर:

export declare function initializeFirestore(app: FirebaseApp, settings: Settings): Firestore;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
ऐप्लिकेशन	FirebaseApp	वह FirebaseApp जिससे Firestore इंस्टेंस जोड़ा जाएगा.
सेटिंग	सेटिंग	Firestore इंस्टेंस कॉन्फ़िगर करने के लिए सेटिंग ऑब्जेक्ट.

लौटाए जाने वाले प्रॉडक्ट:

फ़ायरस्टोर

नया शुरू किया गया Firestore इंस्टेंस.

इनिशलाइज़फ़ायर स्टोर(ऐप्लिकेशन, सेटिंग, डेटाबेस आईडी)

इस एपीआई की झलक, डेवलपर को दी जाती है. अगर आपको मिलने वाले सुझाव/राय या शिकायत के आधार पर, इस एपीआई की सेटिंग में बदलाव किया जाता है, तो इसमें बदलाव हो सकता है. प्रोडक्शन एनवायरमेंट में इस एपीआई का इस्तेमाल न करें.

दी गई सेटिंग के साथ Cloud Firestore के नए इंस्टेंस को शुरू करता है. इसे सिर्फ़ getFirestore() समेत किसी दूसरे फ़ंक्शन के पहले कॉल किया जा सकता है. अगर कस्टम सेटिंग खाली है, तो यह फ़ंक्शन getFirestore() को कॉल करने के बराबर होता है.

हस्ताक्षर:

export declare function initializeFirestore(app: FirebaseApp, settings: Settings, databaseId?: string): Firestore;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
ऐप्लिकेशन	FirebaseApp	वह FirebaseApp जिससे Firestore इंस्टेंस जोड़ा जाएगा.
सेटिंग	सेटिंग	Firestore इंस्टेंस कॉन्फ़िगर करने के लिए सेटिंग ऑब्जेक्ट.
डेटाबेस आईडी	स्ट्रिंग	डेटाबेस का नाम.

लौटाए जाने वाले प्रॉडक्ट:

फ़ायरस्टोर

नया शुरू किया गया Firestore इंस्टेंस.

फ़ंक्शन(फ़ायरस्टोर, ...)

कलेक्शन(फ़ायरस्टोर, पाथ, पाथसेगमेंट)

इससे CollectionReference इंस्टेंस मिलता है, जो तय किए गए ऐब्सलूट पाथ पर कलेक्शन के बारे में बताता है.

हस्ताक्षर:

export declare function collection(firestore: Firestore, path: string, ...pathSegments: string[]): CollectionReference<DocumentData, DocumentData>;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
फ़ायरस्टोर	फ़ायरस्टोर	रूट Firestore इंस्टेंस का रेफ़रंस.
पाथ	स्ट्रिंग	कलेक्शन के लिए स्लैश से अलग किया गया पाथ.
पथ सेगमेंट	स्ट्रिंग[]	पहले आर्ग्युमेंट के हिसाब से लागू किए जाने वाले अतिरिक्त पाथ सेगमेंट.

लौटाए जाने वाले प्रॉडक्ट:

CollectionReference<DocumentData, DocumentData>

CollectionReference इंस्टेंस.

अपवाद

अगर फ़ाइनल पाथ में सेगमेंट की संख्या बराबर है और यह कलेक्शन पर ले नहीं जाता.

collectionsGroup(firestore, collectionsId)

एक नया Query इंस्टेंस बनाता और दिखाता है. इसमें, डेटाबेस में मौजूद वे सभी दस्तावेज़ शामिल होते हैं जो दिए गए collectionId के साथ कलेक्शन या सब-कलेक्शन में मौजूद होते हैं.

हस्ताक्षर:

export declare function collectionGroup(firestore: Firestore, collectionId: string): Query<DocumentData, DocumentData>;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
फ़ायरस्टोर	फ़ायरस्टोर	रूट Firestore इंस्टेंस का रेफ़रंस.
कलेक्शन आईडी	स्ट्रिंग	क्वेरी किए जाने वाले संग्रहों की पहचान करता है. इसमें हर उस कलेक्शन या सब-कलेक्शन को शामिल किया जाएगा जिसके पाथ के आखिरी सेगमेंट के तौर पर यह आईडी मौजूद होगा. इसमें स्लैश नहीं हो सकता.

लौटाए जाने वाले प्रॉडक्ट:

क्वेरी<DocumentData, DocumentData>

Query बनाया गया.

ConnectFirestoreEmulator(फ़ायरस्टोर, होस्ट, पोर्ट, विकल्प)

Cloud Firestore एम्युलेटर से संपर्क करने के लिए, इस इंस्टेंस में बदलाव करें.

ध्यान दें: किसी भी तरह की कार्रवाई के लिए इस इंस्टेंस का इस्तेमाल करने से पहले, इस इंस्टेंस को कॉल करना ज़रूरी है.

हस्ताक्षर:

export declare function connectFirestoreEmulator(firestore: Firestore, host: string, port: number, options?: {
    mockUserToken?: EmulatorMockTokenOptions | string;
}): void;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
फ़ायरस्टोर	फ़ायरस्टोर	एम्युलेटर से कनेक्ट करने के लिए, कॉन्फ़िगर किया जाने वाला Firestore इंस्टेंस.
होस्ट	स्ट्रिंग	एम्युलेटर होस्ट (जैसे: localhost).
पोर्ट	नंबर	एम्युलेटर पोर्ट (उदाहरण: 9000).
विकल्प	{ockUserToken?: EmulatorMockTokenOptions | स्ट्रिंग; } पर स्विच करने के मकसद से, हमसे संपर्क करने के लिए धन्यवाद.

लौटाए जाने वाले प्रॉडक्ट:

अमान्य

दस्तावेज़(फ़ायरस्टोर, पाथ, पाथसेगमेंट)

इससे DocumentReference इंस्टेंस मिलता है, जो तय किए गए ऐब्सलूट पाथ पर मौजूद दस्तावेज़ से जुड़ा होता है.

हस्ताक्षर:

export declare function doc(firestore: Firestore, path: string, ...pathSegments: string[]): DocumentReference<DocumentData, DocumentData>;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
फ़ायरस्टोर	फ़ायरस्टोर	रूट Firestore इंस्टेंस का रेफ़रंस.
पाथ	स्ट्रिंग	दस्तावेज़ के लिए स्लैश से अलग किया गया पाथ.
पथ सेगमेंट	स्ट्रिंग[]	पहले आर्ग्युमेंट के हिसाब से लागू किए जाने वाले अतिरिक्त पाथ सेगमेंट.

लौटाए जाने वाले प्रॉडक्ट:

DocumentReference<DocumentData, DocumentData>

DocumentReference इंस्टेंस.

अपवाद

अगर आखिरी पाथ में सेगमेंट की संख्या विषम है और वह किसी दस्तावेज़ पर ले जाता है.

रन ट्रांज़ैक्शन(फ़ायरस्टोर, अपडेट फ़ंक्शन, विकल्प)

दिए गए updateFunction को लागू करता है. इसके बाद, ट्रांज़ैक्शन में लागू किए गए बदलावों को लागू करने की कोशिश करता है. अगर लेन-देन में पढ़ा गया कोई दस्तावेज़ बदल गया है, तो Cloud Firestore, updateFunction को फिर से दोहराने की कोशिश करता है. अगर पांच बार कोशिश करने के बाद भी लेन-देन नहीं हो पाता है, तो लेन-देन नहीं हो पाएगा.

एक ही लेन-देन में ज़्यादा से ज़्यादा 500 लिखा जा सकता है.

हस्ताक्षर:

export declare function runTransaction<T>(firestore: Firestore, updateFunction: (transaction: Transaction) => Promise<T>, options?: TransactionOptions): Promise<T>;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
फ़ायरस्टोर	फ़ायरस्टोर	इस ट्रांज़ैक्शन को चलाने के लिए, Firestore डेटाबेस का रेफ़रंस.
अपडेट फ़ंक्शन	(लेन-देन: लेन-देन) => वादा<T>	लेन-देन के कॉन्टेक्स्ट में एक्ज़ीक्यूट किया जाने वाला फ़ंक्शन.
विकल्प	लेन-देन के विकल्प	विकल्प ऑब्जेक्ट का इस्तेमाल करके, तय की गई ज़्यादा से ज़्यादा संख्या को कॉन्फ़िगर किया जा सकता है.

लौटाए जाने वाले प्रॉडक्ट:

वादा<T>

अगर लेन-देन पूरा हो गया है या साफ़ तौर पर रद्द हो गया है (updateFunction ने प्रॉमिस फ़ेल किया), तो updateFunction की ओर से दिखाया गया प्रॉमिस यहां दिखता है. ऐसा न होने पर, अगर लेन-देन पूरा नहीं होता है, तो अस्वीकार किए गए प्रॉमिस की गड़बड़ी वाला प्रॉमिस दिखाया जाता है.

बंद करें(फ़ायरस्टोर)

दिए गए Firestore इंस्टेंस को खत्म करता है.

terminate() को कॉल करने के बाद, सिर्फ़ clearIndexedDbPersistence() फ़ंक्शन का इस्तेमाल किया जा सकता है. कोई भी दूसरा फ़ंक्शन FirestoreError दिखाएगा. समझौता खत्म होने से, किसी भी बकाया लेख को रद्द नहीं किया जाता. साथ ही, ऐसा कोई भी वादा पूरा नहीं होगा जिसके लिए सर्वर से जवाब का इंतज़ार है.

खाता बंद होने के बाद रीस्टार्ट करने के लिए, getFirestore() की मदद से Firestore का नया इंस्टेंस बनाएं.

ध्यान दें: सामान्य स्थितियों में, terminate() को कॉल करना ज़रूरी नहीं है. यह फ़ंक्शन सिर्फ़ तब काम करता है, जब आपको इस इंस्टेंस को उसके सभी रिसॉर्स या clearIndexedDbPersistence() के साथ रिलीज़ करने के लिए ज़बरदस्ती करना हो, ताकि यह पक्का किया जा सके कि टेस्ट रन के बीच में सभी लोकल स्टेट खत्म हो जाएं.

हस्ताक्षर:

export declare function terminate(firestore: Firestore): Promise<void>;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
फ़ायरस्टोर	फ़ायरस्टोर	खत्म किया जाने वाला Firestore इंस्टेंस.

लौटाए जाने वाले प्रॉडक्ट:

प्रॉमिस<void>

इंस्टेंस बंद होने के बाद सेट होने वाला Promise.

राइट बैच(फ़ायरस्टोर)

लिखने का एक बैच बनाता है, जिसका इस्तेमाल एक ऐटमिक ऑपरेशन के रूप में कई बार लिखने में किया जाता है. किसी एक WriteBatch में अधिकतम 500 लिखने की अनुमति है.

लिखने के ये नतीजे, दस्तावेज़ में किए गए ऐसे बदलावों में ही दिखेंगे जो प्रॉमिस रिज़ॉल्व होने के बाद होते हैं. अगर क्लाइंट ऑफ़लाइन है, तो डेटा सेव नहीं हो पाता. अगर क्लाइंट के ऑनलाइन होने तक, आपको स्थानीय बदलाव या बफ़र राइट्स देखना है, तो पूरे Firestore SDK का इस्तेमाल करें.

हस्ताक्षर:

export declare function writeBatch(firestore: Firestore): WriteBatch;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
फ़ायरस्टोर	फ़ायरस्टोर

लौटाए जाने वाले प्रॉडक्ट:

WriteBatch

ऐसा WriteBatch जिसका इस्तेमाल, एक से ज़्यादा राइटिंग को ऐटम तरीके से करने के लिए किया जा सकता है.

फ़ंक्शन()

संख्या()

एक ऐसा AggregateField ऑब्जेक्ट बनाएं, जिसका इस्तेमाल क्वेरी के नतीजे के सेट में मौजूद दस्तावेज़ों की संख्या की गणना करने के लिए किया जा सके.

हस्ताक्षर:

export declare function count(): AggregateField<number>;

लौटाए जाने वाले प्रॉडक्ट:

एग्रीगेट फ़ील्ड<number>

मिटाएं फ़ील्ड()

मिटाने के लिए फ़ील्ड को मार्क करने के लिए, {merge: true} के साथ updateDoc() या setDoc() के साथ इस्तेमाल के लिए सेंटिनल दिखाता है.

हस्ताक्षर:

export declare function deleteField(): FieldValue;

लौटाए जाने वाले प्रॉडक्ट:

फ़ील्ड की वैल्यू

दस्तावेज़ आईडी()

किसी दस्तावेज़ के आईडी को रेफ़र करने के लिए, खास सेंटिनल FieldPath दिखाता है. दस्तावेज़ के आईडी के हिसाब से क्रम में लगाने या फ़िल्टर करने के लिए, इसका इस्तेमाल क्वेरी में किया जा सकता है.

हस्ताक्षर:

export declare function documentId(): FieldPath;

लौटाए जाने वाले प्रॉडक्ट:

FieldPath

getFirestore()

यह फ़ंक्शन डिफ़ॉल्ट FirebaseApp से जुड़ा, मौजूदा डिफ़ॉल्ट Firestore इंस्टेंस दिखाता है. अगर कोई इंस्टेंस मौजूद नहीं है, तो डिफ़ॉल्ट सेटिंग के साथ नया इंस्टेंस शुरू करता है.

हस्ताक्षर:

export declare function getFirestore(): Firestore;

लौटाए जाने वाले प्रॉडक्ट:

फ़ायरस्टोर

दिए गए ऐप्लिकेशन का Firestore इंस्टेंस.

सर्वर टाइमस्टैंप()

लिखे गए डेटा में सर्वर से जनरेट किए गए टाइमस्टैंप को शामिल करने के लिए, setDoc() या updateDoc() के साथ इस्तेमाल किया गया सेंटिनल दिखाता है.

हस्ताक्षर:

export declare function serverTimestamp(): FieldValue;

लौटाए जाने वाले प्रॉडक्ट:

फ़ील्ड की वैल्यू

फ़ंक्शन(databaseId, ...)

getFirestore(databaseId)

इस एपीआई की झलक, डेवलपर को दी जाती है. अगर आपको मिलने वाले सुझाव/राय या शिकायत के आधार पर, इस एपीआई की सेटिंग में बदलाव किया जाता है, तो इसमें बदलाव हो सकता है. प्रोडक्शन एनवायरमेंट में इस एपीआई का इस्तेमाल न करें.

डिफ़ॉल्ट FirebaseApp से जुड़ा मौजूदा Firestore इंस्टेंस दिखाता है. अगर कोई इंस्टेंस मौजूद नहीं है, तो डिफ़ॉल्ट सेटिंग के साथ नया इंस्टेंस शुरू करता है.

हस्ताक्षर:

export declare function getFirestore(databaseId: string): Firestore;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
डेटाबेस आईडी	स्ट्रिंग	डेटाबेस का नाम.

लौटाए जाने वाले प्रॉडक्ट:

फ़ायरस्टोर

दिए गए ऐप्लिकेशन का Firestore इंस्टेंस.

फ़ंक्शन(एलिमेंट, ...)

श्रेणीRemove(एलिमेंट)

एक खास वैल्यू दिखाता है, जिसका इस्तेमाल setDoc() के साथ किया जा सकता है या जो सर्वर को सर्वर पर पहले से मौजूद किसी भी अरे वैल्यू से दिए गए एलिमेंट को हटाने के लिए कहता है. दिए गए हर एलिमेंट के सभी इंस्टेंस, अरे से हटा दिए जाएंगे. जिस फ़ील्ड में बदलाव किया जा रहा है, अगर वह पहले से कोई अरे नहीं है, तो उसे खाली अरे से ओवरराइट कर दिया जाएगा.

हस्ताक्षर:

export declare function arrayRemove(...elements: unknown[]): FieldValue;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
एलिमेंट	अज्ञात[]	वे एलिमेंट जिन्हें अरे से हटाना है.

लौटाए जाने वाले प्रॉडक्ट:

फ़ील्ड की वैल्यू

setDoc() या updateDoc() पर कॉल करने के लिए FieldValue निगरानीक

कलेक्शन यूनियन(एलिमेंट)

एक खास वैल्यू दिखाता है, जिसका इस्तेमाल setDoc() या updateDoc() के साथ किया जा सकता है. यह सर्वर को दिए गए एलिमेंट को, सर्वर पर पहले से मौजूद किसी भी अरे वैल्यू के साथ जोड़ने के लिए कहता है. बताए गए हर उस एलिमेंट को आखिर में जोड़ दिया जाएगा जो कलेक्शन में पहले से मौजूद नहीं है. अगर जिस फ़ील्ड में बदलाव किया जा रहा है वह पहले से कोई अरे नहीं है, तो उसे ऐसे अरे से ओवरराइट कर दिया जाएगा जिसमें ठीक बताए गए एलिमेंट शामिल होंगे.

हस्ताक्षर:

export declare function arrayUnion(...elements: unknown[]): FieldValue;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
एलिमेंट	अज्ञात[]	कलेक्शन में जुड़ने वाले एलिमेंट.

लौटाए जाने वाले प्रॉडक्ट:

फ़ील्ड की वैल्यू

setDoc() या updateDoc() पर कॉल करने के लिए FieldValue निगरानीक.

फ़ंक्शन(फ़ील्ड, ...)

औसत(फ़ील्ड)

एक ऐसा AggregateField ऑब्जेक्ट बनाएं जिसका इस्तेमाल करके, क्वेरी के नतीजों के सेट में मौजूद दस्तावेज़ों की रेंज पर किसी खास फ़ील्ड के औसत का हिसाब लगाया जा सके.

हस्ताक्षर:

export declare function average(field: string | FieldPath): AggregateField<number | null>;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
फ़ील्ड	स्ट्रिंग | FieldPath	पूरे नतीजे के सेट में औसत करने के लिए फ़ील्ड तय करता है.

लौटाए जाने वाले प्रॉडक्ट:

कुल फ़ील्ड<number | शून्य>

योग(फ़ील्ड)

ऐसा AggregateField ऑब्जेक्ट बनाएं जिसका इस्तेमाल करके, क्वेरी के नतीजों के सेट में मौजूद दस्तावेज़ों की रेंज में किसी खास फ़ील्ड के योग का हिसाब लगाया जा सके.

हस्ताक्षर:

export declare function sum(field: string | FieldPath): AggregateField<number>;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
फ़ील्ड	स्ट्रिंग | FieldPath	नतीजे के सेट में जोड़े जाने वाले फ़ील्ड के बारे में बताता है.

लौटाए जाने वाले प्रॉडक्ट:

एग्रीगेट फ़ील्ड<number>

फ़ंक्शन(fieldPath, ...)

ऑर्डर बाय(फ़ील्ड पाथ, डायरेक्शनStr)

ऐसा QueryOrderByConstraint बनाता है जो क्वेरी के नतीजे को बताए गए फ़ील्ड के हिसाब से क्रम में लगाता है. भले ही, वह बढ़ते क्रम में होने के बजाय घटते क्रम में हो.

ध्यान दें: जिन दस्तावेज़ों में तय फ़ील्ड नहीं है वे क्वेरी के नतीजे में मौजूद नहीं होंगे.

हस्ताक्षर:

export declare function orderBy(fieldPath: string | FieldPath, directionStr?: OrderByDirection): QueryOrderByConstraint;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
फ़ील्ड पाथ	स्ट्रिंग | FieldPath	क्रम से लगाने के लिए फ़ील्ड.
डायरेक्शनस्ट्र	OrderByDirection	इसके मुताबिक क्रम से लगाने के लिए वैकल्पिक दिशा ('बढ़ते क्रम' या 'घटते क्रम में'). अगर इसके बारे में नहीं बताया गया है, तो क्रम बढ़ते क्रम में होगा.

लौटाए जाने वाले प्रॉडक्ट:

QueryOrderByConstraint

बनाया गया QueryOrderByConstraint.

कहां(fieldPath, opStr, मान)

एक ऐसा QueryFieldFilterConstraint बनाता है जो यह लागू करता है कि दस्तावेज़ों में तय किया गया फ़ील्ड होना चाहिए और वैल्यू को दिए गए रिलेशन कंस्ट्रेंट को पूरा करना चाहिए.

हस्ताक्षर:

export declare function where(fieldPath: string | FieldPath, opStr: WhereFilterOp, value: unknown): QueryFieldFilterConstraint;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
फ़ील्ड पाथ	स्ट्रिंग | FieldPath	तुलना करने का पाथ
ऑपस्ट्र	WhatFilterOp	ऑपरेशन स्ट्रिंग (जैसे कि "<", "<=", "==", "<", "<=", "!=").
value	अज्ञात	तुलना के लिए वैल्यू

लौटाए जाने वाले प्रॉडक्ट:

QueryFieldFilterConstraint

बनाया गया QueryFieldFilterConstraint.

फ़ंक्शन(fieldValues, ...)

endAt(fieldValues)

ऐसा QueryEndAtConstraint बनाता है, जो क्वेरी के क्रम के हिसाब से दिए गए फ़ील्ड पर खत्म होने वाले नतीजे के सेट में बदलाव करता है. फ़ील्ड की वैल्यू का क्रम, क्वेरी के क्लॉज़ के मुताबिक क्रम से मैच होना चाहिए.

हस्ताक्षर:

export declare function endAt(...fieldValues: unknown[]): QueryEndAtConstraint;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
फ़ील्ड की वैल्यू	अज्ञात[]	क्वेरी के क्रम के हिसाब से, इस क्वेरी को खत्म करने के लिए फ़ील्ड की वैल्यू.

लौटाए जाने वाले प्रॉडक्ट:

QueryEndAtConstraint

query() को पास करने के लिए एक QueryEndAtConstraint

end before(fieldValues)

ऐसा QueryEndAtConstraint बनाता है, जो क्वेरी के क्रम के हिसाब से दिए गए फ़ील्ड से पहले खत्म होने वाले नतीजे में बदलाव करता है. फ़ील्ड की वैल्यू का क्रम, क्वेरी के क्लॉज़ के मुताबिक क्रम से मैच होना चाहिए.

हस्ताक्षर:

export declare function endBefore(...fieldValues: unknown[]): QueryEndAtConstraint;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
फ़ील्ड की वैल्यू	अज्ञात[]	क्वेरी के क्रम के हिसाब से, इस फ़ील्ड की वैल्यू को उससे पहले खत्म करना है.

लौटाए जाने वाले प्रॉडक्ट:

QueryEndAtConstraint

query() को पास करने के लिए एक QueryEndAtConstraint

startAfter(fieldValues)

यह एक QueryStartAtConstraint बनाता है, जो क्वेरी के क्रम के हिसाब से दिए गए फ़ील्ड के बाद, शुरू होने के लिए सेट किए गए नतीजे में बदलाव करता है. फ़ील्ड की वैल्यू का क्रम, क्वेरी के क्लॉज़ के मुताबिक क्रम से मैच होना चाहिए.

हस्ताक्षर:

export declare function startAfter(...fieldValues: unknown[]): QueryStartAtConstraint;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
फ़ील्ड की वैल्यू	अज्ञात[]	क्वेरी के क्रम के हिसाब से, इस क्वेरी को शुरू करने के लिए फ़ील्ड.

लौटाए जाने वाले प्रॉडक्ट:

QueryStartAtConstraint

query() को पास करने के लिए, एक QueryStartAtConstraint

startAt(fieldValues)

यह एक QueryStartAtConstraint बनाता है, जो क्वेरी के क्रम के हिसाब से, दिए गए फ़ील्ड से शुरू होने के लिए सेट किए गए नतीजे में बदलाव करता है. फ़ील्ड की वैल्यू का क्रम, क्वेरी के क्लॉज़ के मुताबिक क्रम से मैच होना चाहिए.

हस्ताक्षर:

export declare function startAt(...fieldValues: unknown[]): QueryStartAtConstraint;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
फ़ील्ड की वैल्यू	अज्ञात[]	क्वेरी के क्रम के मुताबिक, इस क्वेरी को शुरू करने के लिए फ़ील्ड.

लौटाए जाने वाले प्रॉडक्ट:

QueryStartAtConstraint

query() पर जाने के लिए एक QueryStartAtConstraint.

फ़ंक्शन(बायां, ...)

एग्रीगेट फ़ील्ड बराबर(बाएं, दाएं)

यह बराबरी के दो 'AggregateField` इंस्टेंस की तुलना करता है.

हस्ताक्षर:

export declare function aggregateFieldEqual(left: AggregateField<unknown>, right: AggregateField<unknown>): boolean;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
बाएं	एग्रीगेट फ़ील्ड<जानकारी नहीं है>	इस एग्रीगेट फ़ील्ड की तुलना right से करें.
दाएं	एग्रीगेट फ़ील्ड<जानकारी नहीं है>	इस एग्रीगेट फ़ील्ड की तुलना left से करें.

लौटाए जाने वाले प्रॉडक्ट:

बूलियन

एग्रीगेटQuerySnapshotEqual(बायां, दायां)

बराबरी के लिए, दो AggregateQuerySnapshot इंस्टेंस की तुलना करता है.

AggregateQuerySnapshot के दो इंस्टेंस को "बराबर" माना जाता है होना चाहिए, अगर सभी क्वेरी एक जैसी हों और उनमें एक जैसा डेटा हो.

हस्ताक्षर:

export declare function aggregateQuerySnapshotEqual<AggregateSpecType extends AggregateSpec, AppModelType, DbModelType extends DocumentData>(left: AggregateQuerySnapshot<AggregateSpecType, AppModelType, DbModelType>, right: AggregateQuerySnapshot<AggregateSpecType, AppModelType, DbModelType>): boolean;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
बाएं	AggregateQuerySnapshot<AggregatespecType, AppModelType, DbModelType>	तुलना करने के लिए पहले AggregateQuerySnapshot.
दाएं	AggregateQuerySnapshot<AggregatespecType, AppModelType, DbModelType>	तुलना करने के लिए दूसरा AggregateQuerySnapshot.

लौटाए जाने वाले प्रॉडक्ट:

बूलियन

अगर ऑब्जेक्ट "बराबर" हैं, जैसा कि ऊपर बताया गया है, तो true या false.

क्वेरीEqual(लेफ़्ट, राइट)

अगर दी गई क्वेरी एक ही कलेक्शन पर ले जाती हैं और एक जैसे कंस्ट्रेंट को लागू करती हैं, तो 'सही' दिखाता है.

हस्ताक्षर:

export declare function queryEqual<AppModelType, DbModelType extends DocumentData>(left: Query<AppModelType, DbModelType>, right: Query<AppModelType, DbModelType>): boolean;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
बाएं	क्वेरी<AppModelType, DbModelType>	तुलना करने के लिए Query.
दाएं	क्वेरी<AppModelType, DbModelType>	तुलना करने के लिए Query.

लौटाए जाने वाले प्रॉडक्ट:

बूलियन

अगर रेफ़रंस फ़ाइलें एक ही Firestore डेटाबेस में एक ही जगह पर ले जाती हैं, तो सही है.

refEqual(बाएं, दाएं)

अगर दिए गए रेफ़रंस बराबर होते हैं, तो 'सही' दिखाता है.

हस्ताक्षर:

export declare function refEqual<AppModelType, DbModelType extends DocumentData>(left: DocumentReference<AppModelType, DbModelType> | CollectionReference<AppModelType, DbModelType>, right: DocumentReference<AppModelType, DbModelType> | CollectionReference<AppModelType, DbModelType>): boolean;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
बाएं	DocumentReference<AppModelType, DbModelType> | CollectionReference<AppModelType, DbModelType>	तुलना करने के लिए रेफ़रंस.
दाएं	DocumentReference<AppModelType, DbModelType> | CollectionReference<AppModelType, DbModelType>	तुलना करने के लिए रेफ़रंस.

लौटाए जाने वाले प्रॉडक्ट:

बूलियन

अगर रेफ़रंस फ़ाइलें एक ही Firestore डेटाबेस में एक ही जगह पर ले जाती हैं, तो सही है.

स्नैपशॉट बराबर(बाएं, दाएं)

अगर दिए गए स्नैपशॉट बराबर होते हैं, तो 'सही' दिखाता है.

हस्ताक्षर:

export declare function snapshotEqual<AppModelType, DbModelType extends DocumentData>(left: DocumentSnapshot<AppModelType, DbModelType> | QuerySnapshot<AppModelType, DbModelType>, right: DocumentSnapshot<AppModelType, DbModelType> | QuerySnapshot<AppModelType, DbModelType>): boolean;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
बाएं	DocumentSnapshot<AppModelType, DbModelType> | QuerySnapshot<AppModelType, DbModelType>	तुलना करने के लिए स्नैपशॉट.
दाएं	DocumentSnapshot<AppModelType, DbModelType> | QuerySnapshot<AppModelType, DbModelType>	तुलना करने के लिए स्नैपशॉट.

लौटाए जाने वाले प्रॉडक्ट:

बूलियन

अगर स्नैपशॉट बराबर हों, तो 'सही' होता है.

फ़ंक्शन(सीमा, ...)

सीमा(सीमा)

ऐसा QueryLimitConstraint बनाता है, जो सिर्फ़ मेल खाने वाले पहले दस्तावेज़ दिखाता है.

हस्ताक्षर:

export declare function limit(limit: number): QueryLimitConstraint;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
सीमा	नंबर	लौटाए जाने वाले सामान की ज़्यादा से ज़्यादा संख्या.

लौटाए जाने वाले प्रॉडक्ट:

QuerylimitConstraint

बनाया गया QueryLimitConstraint.

लिमिट(सीमा)

ऐसा QuerylimitConstraint बनाता है, जो सिर्फ़ मिलते-जुलते आखिरी दस्तावेज़ दिखाता है.

आपको limitToLast क्वेरी के लिए कम से कम एक orderBy क्लॉज़ तय करना होगा. ऐसा न करने पर, एक्ज़ीक्यूशन के दौरान अपवाद जोड़ दिया जाएगा.

हस्ताक्षर:

export declare function limitToLast(limit: number): QueryLimitConstraint;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
सीमा	नंबर	लौटाए जाने वाले सामान की ज़्यादा से ज़्यादा संख्या.

लौटाए जाने वाले प्रॉडक्ट:

QuerylimitConstraint

बनाया गया QueryLimitConstraint.

फ़ंक्शन(loglevel, ...)

setLoglevel(logLevel)

Cloud Firestore लॉग (डीबग, गड़बड़ी या साइलेंट) की ज़्यादा जानकारी सेट करता है.

हस्ताक्षर:

export declare function setLogLevel(logLevel: LogLevel): void;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
लॉगलेवल	लॉगलेवल	गतिविधि और गड़बड़ी को लॉग करने के लिए, आपकी तय की गई ज़्यादा शब्दों में जानकारी. इनमें से कोई भी वैल्यू हो सकती है: सबसे ज़्यादा जानकारी वाले लॉगिंग लेवल के लिए debug, खास तौर पर डीबग करने के लिए. सिर्फ़ गड़बड़ियां लॉग करने के लिए, error. silent to turn off logging.

लौटाए जाने वाले प्रॉडक्ट:

अमान्य

फ़ंक्शन(n, ...)

वृद्धि(n)

एक खास वैल्यू दिखाता है, जिसका इस्तेमाल setDoc() या updateDoc() के साथ किया जा सकता है. यह सर्वर को, दी गई वैल्यू के हिसाब से फ़ील्ड की मौजूदा वैल्यू को बढ़ाने के लिए कहता है.

अगर ऑपरेंड या मौजूदा फ़ील्ड की वैल्यू में, फ़्लोटिंग पॉइंट प्रिसिज़न का इस्तेमाल होता है, तो सभी अंकगणित, आईईईई 754 सिमैंटिक का पालन करता है. अगर दोनों वैल्यू पूर्णांक हैं, तो JavaScript की सुरक्षित संख्या रेंज (Number.MIN_SAFE_INTEGER से Number.MAX_SAFE_INTEGER) से बाहर की वैल्यू पर भी वैल्यू का सटीक असर पड़ सकता है. इसके अलावा, Firestore बैकएंड से प्रोसेस होने के बाद, सभी पूर्णांक कार्रवाइयां -2^63 और 2^63-1 के बीच तय होती हैं.

अगर फ़ील्ड की मौजूदा वैल्यू number टाइप की नहीं है या फ़ील्ड मौजूद नहीं है, तो ट्रांसफ़ॉर्मेशन ऐक्शन फ़ील्ड को दी गई वैल्यू पर सेट कर देता है.

हस्ताक्षर:

export declare function increment(n: number): FieldValue;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
n	नंबर	वह वैल्यू जिससे बढ़ोतरी करनी है.

लौटाए जाने वाले प्रॉडक्ट:

फ़ील्ड की वैल्यू

setDoc() या updateDoc() पर कॉल करने के लिए FieldValue निगरानीक

फ़ंक्शन(क्वेरी, ...)

getAggregate(query, aggregatespec)

असल में दस्तावेज़ों को डाउनलोड किए बिना दी गई क्वेरी के नतीजे के सेट में दस्तावेज़ों में बताए गए एग्रीगेशन की गणना करता है.

एग्रीगेशन के लिए यह फ़ंक्शन इस्तेमाल करें. इसकी वजह यह है कि एग्रीगेशन के लिए सिर्फ़ फ़ाइनल वैल्यू इस्तेमाल की जा सकती है, दस्तावेज़ नहीं डेटा को डाउनलोड किया जाता है. यह फ़ंक्शन, उन मामलों में दस्तावेज़ों को एग्रीगेशन कर सकता है जहां नतीजे का सेट पूरी तरह से डाउनलोड करने के लिए बहुत बड़ा है (हज़ारों दस्तावेज़).

हस्ताक्षर:

export declare function getAggregate<AggregateSpecType extends AggregateSpec, AppModelType, DbModelType extends DocumentData>(query: Query<AppModelType, DbModelType>, aggregateSpec: AggregateSpecType): Promise<AggregateQuerySnapshot<AggregateSpecType, AppModelType, DbModelType>>;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
query	क्वेरी<AppModelType, DbModelType>	वह क्वेरी जिसके परिणाम का सेट एग्रीगेट किया गया है.
इकट्ठा की गई जानकारी	एग्रीगेटस्पेक्टटाइप	एक AggregateSpec ऑब्जेक्ट, जो नतीजे के सेट पर परफ़ॉर्म करने के लिए एग्रीगेट तय करता है. AggregateSpecification हर एग्रीगेट के लिए उपनामों को तय करता है, जिसका इस्तेमाल एग्रीगेट नतीजा वापस पाने के लिए किया जा सकता है.

लौटाए जाने वाले प्रॉडक्ट:

प्रॉमिस<AggregateQuerySnapshot<AggregateSpecificationType, AppModelType, DbModelType>>

उदाहरण

const aggregateSnapshot = await getAggregate(query, {
  countOfDocs: count(),
  totalHours: sum('hours'),
  averageScore: average('score')
});

const countOfDocs: number = aggregateSnapshot.data().countOfDocs;
const totalHours: number = aggregateSnapshot.data().totalHours;
const averageScore: number | null = aggregateSnapshot.data().averageScore;

getCount(क्वेरी)

असल में दस्तावेज़ों को डाउनलोड किए बिना, दी गई क्वेरी के नतीजे सेट में दस्तावेज़ों की संख्या की गणना करता है.

दस्तावेज़ों की गिनती करने के लिए इस फ़ंक्शन का इस्तेमाल करना आसान है. ऐसा इसलिए, क्योंकि दस्तावेज़ों की नहीं, बल्कि सिर्फ़ आखिरी गिनती को डेटा डाउनलोड हो जाता है. यह फ़ंक्शन, उन मामलों में दस्तावेज़ों की गिनती कर सकता है जिनमें नतीजे के सेट को पूरी तरह से डाउनलोड करने पर पाबंदी लगाई गई हो. जैसे, हज़ारों दस्तावेज़.

हस्ताक्षर:

export declare function getCount<AppModelType, DbModelType extends DocumentData>(query: Query<AppModelType, DbModelType>): Promise<AggregateQuerySnapshot<{
    count: AggregateField<number>;
}, AppModelType, DbModelType>>;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
query	क्वेरी<AppModelType, DbModelType>	वह क्वेरी जिसके नतीजे के सेट के साइज़ को कैलकुलेट किया जाता है.

लौटाए जाने वाले प्रॉडक्ट:

प्रॉमिस<AggregateQuerySnapshot<{ संख्या: AggregateField<number>; }, AppModelType, DbModelType>>

एक ऐसा प्रॉमिस जिसे सदस्यों की संख्या के साथ हल किया जाएगा; संख्या को snapshot.data().count से वापस लाया जा सकता है. इसमें snapshot वह AggregateQuerySnapshot है जिससे मिलने वाले प्रॉमिस का समाधान होता है.

Docs(क्वेरी)

क्वेरी चलाता है और नतीजों को QuerySnapshot के तौर पर दिखाता है.

सभी क्वेरी को सीधे सर्वर से एक्ज़ीक्यूट किया जाता है, भले ही क्वेरी को पहले एक्ज़ीक्यूट किया गया हो. हाल ही के बदलाव, वापस मिले नतीजों में सिर्फ़ तब दिखते हैं, जब उन्हें बैकएंड से पहले ही लागू किया गया हो. अगर क्लाइंट ऑफ़लाइन है, तो कार्रवाई नहीं हो पाती. पहले से कैश मेमोरी में सेव किए गए नतीजे और स्थानीय बदलाव देखने के लिए, पूरे Firestore SDK टूल का इस्तेमाल करें.

हस्ताक्षर:

export declare function getDocs<AppModelType, DbModelType extends DocumentData>(query: Query<AppModelType, DbModelType>): Promise<QuerySnapshot<AppModelType, DbModelType>>;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
query	क्वेरी<AppModelType, DbModelType>	एक्ज़ीक्यूट किया जाने वाला Query.

लौटाए जाने वाले प्रॉडक्ट:

प्रॉमिस<QuerySnapshot<AppModelType, DbModelType>>

ऐसा प्रॉमिस जिसे क्वेरी के नतीजों के साथ रिज़ॉल्व किया जाएगा.

क्वेरी(क्वेरी, मिश्रित फ़िल्टर, queryConstraints)

क्वेरी का एक ऐसा नया इंस्टेंस बनाता है जिसे बदला नहीं जा सकता. इसे बढ़ाया गया है. इसमें क्वेरी के अन्य कंस्ट्रेंट को भी शामिल किया जाता है.

हस्ताक्षर:

export declare function query<AppModelType, DbModelType extends DocumentData>(query: Query<AppModelType, DbModelType>, compositeFilter: QueryCompositeFilterConstraint, ...queryConstraints: QueryNonFilterConstraint[]): Query<AppModelType, DbModelType>;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
query	क्वेरी<AppModelType, DbModelType>	नए कंस्ट्रेंट के लिए बेस के तौर पर इस्तेमाल करने के लिए, क्वेरी इंस्टेंस.
कंपोज़िट फ़िल्टर	QueryCompositeFilterConstraint	लागू करने के लिए, QueryCompositeFilterConstraint. and() या or() का इस्तेमाल करके, QueryCompositeFilterConstraint बनाएं.
क्वेरी कंस्ट्रेंट	QueryNonFilterConstraint[]	लागू करने के लिए, अतिरिक्त QueryNonFilterConstraint (उदाहरण के लिए, orderBy(), limit()).

लौटाए जाने वाले प्रॉडक्ट:

क्वेरी<AppModelType, DbModelType>

अपवाद

अगर किसी दिए गए क्वेरी कंस्ट्रेंट को मौजूदा या नए कंस्ट्रेंट के साथ नहीं जोड़ा जा सकता.

क्वेरी(क्वेरी, queryConstraints)

क्वेरी का एक ऐसा नया इंस्टेंस बनाता है जिसे बदला नहीं जा सकता. इसे बढ़ाया गया है. इसमें क्वेरी के अन्य कंस्ट्रेंट को भी शामिल किया जाता है.

हस्ताक्षर:

export declare function query<AppModelType, DbModelType extends DocumentData>(query: Query<AppModelType, DbModelType>, ...queryConstraints: QueryConstraint[]): Query<AppModelType, DbModelType>;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
query	क्वेरी<AppModelType, DbModelType>	नए कंस्ट्रेंट के लिए बेस के तौर पर इस्तेमाल करने के लिए, क्वेरी इंस्टेंस.
क्वेरी कंस्ट्रेंट	QueryConstraint[]	लागू करने के लिए QueryConstraint की सूची.

लौटाए जाने वाले प्रॉडक्ट:

क्वेरी<AppModelType, DbModelType>

अपवाद

अगर किसी दिए गए क्वेरी कंस्ट्रेंट को मौजूदा या नए कंस्ट्रेंट के साथ नहीं जोड़ा जा सकता.

फ़ंक्शन(queryConstraints, ...)

और(queryConstraints)

एक नया QueryCompositeFilterConstraint बनाता है, जो दिए गए फ़िल्टर कंस्ट्रेंट का कॉम्बिनेशन होता है. कॉम्बिनेशन फ़िल्टर में, कोई दस्तावेज़ तब शामिल होता है, जब वह दिए गए सभी फ़िल्टर के मुताबिक हो.

हस्ताक्षर:

export declare function and(...queryConstraints: QueryFilterConstraint[]): QueryCompositeFilterConstraint;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
क्वेरी कंस्ट्रेंट	QueryFilterConstraint[]	ज़रूरी नहीं. कॉम्बिनेशन के लिए, QueryFilterConstraint की सूची. इन्हें where(), or() या and() पर कॉल के साथ बनाया जाना चाहिए.

लौटाए जाने वाले प्रॉडक्ट:

QueryCompositeFilterConstraint

नया बनाया गया QueryCompositeFilterConstraint.

या(queryConstraints)

एक नया QueryCompositeFilterConstraint बनाता है, जो दिए गए फ़िल्टर कंस्ट्रेंट का डिस्ट्रिब्यूशन होता है. डिसजक्शन फ़िल्टर में कोई दस्तावेज़ तब शामिल होता है, जब वह दिए गए किसी भी फ़िल्टर की शर्तों को पूरा करता है.

हस्ताक्षर:

export declare function or(...queryConstraints: QueryFilterConstraint[]): QueryCompositeFilterConstraint;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
क्वेरी कंस्ट्रेंट	QueryFilterConstraint[]	ज़रूरी नहीं. डेटा को अलग करने के लिए, QueryFilterConstraint की सूची. इन्हें where(), or() या and() पर कॉल के साथ बनाया जाना चाहिए.

लौटाए जाने वाले प्रॉडक्ट:

QueryCompositeFilterConstraint

नया बनाया गया QueryCompositeFilterConstraint.

फ़ंक्शन(रेफ़रंस, ...)

addDoc(रेफ़रंस, डेटा)

दिए गए डेटा के साथ, बताए गए CollectionReference में नया दस्तावेज़ जोड़ें, इसे अपने-आप दस्तावेज़ आईडी असाइन हो जाएगा.

इस लिखने का नतीजा, दस्तावेज़ के उन लेखों में ही दिखेगा जो लौटाए गए प्रॉमिस का समाधान हो जाने के बाद होते हैं. अगर क्लाइंट ऑफ़लाइन है, तो डेटा सेव नहीं हो पाता. अगर क्लाइंट के ऑनलाइन होने तक, आपको स्थानीय बदलाव या बफ़र राइट्स देखना है, तो पूरे Firestore SDK का इस्तेमाल करें.

हस्ताक्षर:

export declare function addDoc<AppModelType, DbModelType extends DocumentData>(reference: CollectionReference<AppModelType, DbModelType>, data: WithFieldValue<AppModelType>): Promise<DocumentReference<AppModelType, DbModelType>>;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
रेफ़रंस	CollectionReference<AppModelType, DbModelType>	इस दस्तावेज़ को जोड़ने के लिए कलेक्शन का रेफ़रंस.
डेटा	WithFieldValue<AppModelType>	एक ऑब्जेक्ट, जिसमें नए दस्तावेज़ का डेटा है.

लौटाए जाने वाले प्रॉडक्ट:

प्रॉमिस<DocumentReference<AppModelType, DbModelType>>

बैकएंड पर लिखे जाने के बाद, नए बनाए गए दस्तावेज़ पर ले जाने वाले DocumentReference की मदद से, Promise को ठीक किया गया.

अपवाद

गड़बड़ी - अगर दिया गया इनपुट मान्य Firestore दस्तावेज़ नहीं है.

कलेक्शन(रेफ़रंस, पाथ, पाथसेगमेंट)

इससे CollectionReference इंस्टेंस मिलता है, जो बताए गए रिलेटिव पाथ पर reference के सब-कलेक्शन दिखाता है.

हस्ताक्षर:

export declare function collection<AppModelType, DbModelType extends DocumentData>(reference: CollectionReference<AppModelType, DbModelType>, path: string, ...pathSegments: string[]): CollectionReference<DocumentData, DocumentData>;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
रेफ़रंस	CollectionReference<AppModelType, DbModelType>	किसी कलेक्शन का रेफ़रंस.
पाथ	स्ट्रिंग	कलेक्शन के लिए स्लैश से अलग किया गया पाथ.
पथ सेगमेंट	स्ट्रिंग[]	पहले आर्ग्युमेंट के हिसाब से लागू किए जाने वाले अतिरिक्त पाथ सेगमेंट.

लौटाए जाने वाले प्रॉडक्ट:

CollectionReference<DocumentData, DocumentData>

CollectionReference इंस्टेंस.

अपवाद

अगर फ़ाइनल पाथ में सेगमेंट की संख्या बराबर है और यह कलेक्शन पर ले नहीं जाता.

कलेक्शन(रेफ़रंस, पाथ, पाथसेगमेंट)

इससे CollectionReference इंस्टेंस मिलता है, जो बताए गए रिलेटिव पाथ पर reference के सब-कलेक्शन दिखाता है.

हस्ताक्षर:

export declare function collection<AppModelType, DbModelType extends DocumentData>(reference: DocumentReference<AppModelType, DbModelType>, path: string, ...pathSegments: string[]): CollectionReference<DocumentData, DocumentData>;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
रेफ़रंस	DocumentReference<AppModelType, DbModelType>	Firestore दस्तावेज़ का रेफ़रंस.
पाथ	स्ट्रिंग	कलेक्शन के लिए स्लैश से अलग किया गया पाथ.
पथ सेगमेंट	स्ट्रिंग[]	पहले आर्ग्युमेंट के हिसाब से लागू किए जाने वाले अतिरिक्त पाथ सेगमेंट.

लौटाए जाने वाले प्रॉडक्ट:

CollectionReference<DocumentData, DocumentData>

CollectionReference इंस्टेंस.

अपवाद

अगर फ़ाइनल पाथ में सेगमेंट की संख्या बराबर है और यह कलेक्शन पर ले नहीं जाता.

DeleteDoc(संदर्भ)

तय किए गए DocumentReference के ज़रिए रेफ़र किया गया दस्तावेज़ मिटाता है.

मिटाए गए प्रॉमिस का अनुरोध पूरा होने के बाद ही, दस्तावेज़ के उन लेखों को पढ़ा जा सकता है जिन्हें मिटाया गया है. अगर क्लाइंट ऑफ़लाइन है, तो मिटाया नहीं जा सकता. अगर क्लाइंट के ऑनलाइन होने तक, आपको स्थानीय बदलाव या बफ़र राइट्स देखना है, तो पूरे Firestore SDK का इस्तेमाल करें.

हस्ताक्षर:

export declare function deleteDoc<AppModelType, DbModelType extends DocumentData>(reference: DocumentReference<AppModelType, DbModelType>): Promise<void>;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
रेफ़रंस	DocumentReference<AppModelType, DbModelType>	मिटाने के लिए, दस्तावेज़ का रेफ़रंस.

लौटाए जाने वाले प्रॉडक्ट:

प्रॉमिस<void>

दस्तावेज़ को बैकएंड से मिटाने के बाद, Promise का समाधान हो जाता है.

दस्तावेज़(reference, पाथ, pathsegments)

इससे ऐसा DocumentReference इंस्टेंस मिलता है जो बताए गए रिलेटिव पाथ पर reference में मौजूद किसी दस्तावेज़ के बारे में बताता है. अगर कोई पाथ नहीं डाला गया है, तो लौटाए गए DocumentReference के लिए, अपने-आप जनरेट होने वाले यूनीक आईडी का इस्तेमाल किया जाएगा.

हस्ताक्षर:

export declare function doc<AppModelType, DbModelType extends DocumentData>(reference: CollectionReference<AppModelType, DbModelType>, path?: string, ...pathSegments: string[]): DocumentReference<AppModelType, DbModelType>;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
रेफ़रंस	CollectionReference<AppModelType, DbModelType>	किसी कलेक्शन का रेफ़रंस.
पाथ	स्ट्रिंग	दस्तावेज़ के लिए स्लैश से अलग किया गया पाथ. अपने-आप जनरेट होने वाले आईडी का इस्तेमाल करने के लिए, इसे हटाना ज़रूरी है.
पथ सेगमेंट	स्ट्रिंग[]	पहले आर्ग्युमेंट के हिसाब से लागू किए जाने वाले अतिरिक्त पाथ सेगमेंट.

लौटाए जाने वाले प्रॉडक्ट:

DocumentReference<AppModelType, DbModelType>

DocumentReference इंस्टेंस.

अपवाद

अगर आखिरी पाथ में सेगमेंट की संख्या विषम है और वह किसी दस्तावेज़ पर ले जाता है.

दस्तावेज़(reference, पाथ, pathsegments)

इससे ऐसा DocumentReference इंस्टेंस मिलता है जो बताए गए रिलेटिव पाथ पर reference में मौजूद किसी दस्तावेज़ के बारे में बताता है.

हस्ताक्षर:

export declare function doc<AppModelType, DbModelType extends DocumentData>(reference: DocumentReference<AppModelType, DbModelType>, path: string, ...pathSegments: string[]): DocumentReference<DocumentData, DocumentData>;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
रेफ़रंस	DocumentReference<AppModelType, DbModelType>	Firestore दस्तावेज़ का रेफ़रंस.
पाथ	स्ट्रिंग	दस्तावेज़ के लिए स्लैश से अलग किया गया पाथ.
पथ सेगमेंट	स्ट्रिंग[]	पहले आर्ग्युमेंट के हिसाब से लागू किए जाने वाले अतिरिक्त पाथ सेगमेंट.

लौटाए जाने वाले प्रॉडक्ट:

DocumentReference<DocumentData, DocumentData>

DocumentReference इंस्टेंस.

अपवाद

अगर आखिरी पाथ में सेगमेंट की संख्या विषम है और वह किसी दस्तावेज़ पर ले जाता है.

getDoc(संदर्भ)

दिए गए दस्तावेज़ के रेफ़रंस से रेफ़र किए गए दस्तावेज़ को पढ़ता है.

सभी दस्तावेज़ सीधे सर्वर से फ़ेच किए जाते हैं, भले ही दस्तावेज़ को पहले पढ़ा गया हो या उसमें बदलाव किया गया हो. हाल ही के बदलाव, वापस लाए गए DocumentSnapshot में सिर्फ़ तब दिखते हैं, जब उन्हें बैकएंड से पहले ही लागू किया गया हो. अगर क्लाइंट ऑफ़लाइन है, तो मैसेज नहीं पढ़ा जा सकता. अगर आपको कैश मेमोरी में डेटा स्टोर करना है या लोकल स्टोरेज में बदलाव देखने हैं, तो कृपया पूरे Firestore SDK टूल का इस्तेमाल करें.

हस्ताक्षर:

export declare function getDoc<AppModelType, DbModelType extends DocumentData>(reference: DocumentReference<AppModelType, DbModelType>): Promise<DocumentSnapshot<AppModelType, DbModelType>>;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
रेफ़रंस	DocumentReference<AppModelType, DbModelType>	फ़ेच किए जाने वाले दस्तावेज़ का रेफ़रंस.

लौटाए जाने वाले प्रॉडक्ट:

प्रॉमिस<DocumentSnapshot<AppModelType, DbModelType>>

दस्तावेज़ में मौजूदा कॉन्टेंट को शामिल करके, DocumentSnapshot से प्रॉमिस रिज़ॉल्व किया गया.

setDoc(रेफ़रंस, डेटा)

तय किए गए DocumentReference के बताए गए दस्तावेज़ में लिखता है. अगर दस्तावेज़ अब तक मौजूद नहीं है, तो इसे बना दिया जाएगा.

इस लिखने का नतीजा, दस्तावेज़ के उन लेखों में ही दिखेगा जो लौटाए गए प्रॉमिस का समाधान हो जाने के बाद होते हैं. अगर क्लाइंट ऑफ़लाइन है, तो डेटा सेव नहीं हो पाता. अगर क्लाइंट के ऑनलाइन होने तक, आपको स्थानीय बदलाव या बफ़र राइट्स देखना है, तो पूरे Firestore SDK का इस्तेमाल करें.

हस्ताक्षर:

export declare function setDoc<AppModelType, DbModelType extends DocumentData>(reference: DocumentReference<AppModelType, DbModelType>, data: WithFieldValue<AppModelType>): Promise<void>;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
रेफ़रंस	DocumentReference<AppModelType, DbModelType>	लिखने के लिए दस्तावेज़ का रेफ़रंस.
डेटा	WithFieldValue<AppModelType>	दस्तावेज़ के फ़ील्ड और वैल्यू का मैप.

लौटाए जाने वाले प्रॉडक्ट:

प्रॉमिस<void>

बैकएंड में डेटा सही तरीके से लिख लेने के बाद, Promise का समाधान हो जाता है.

अपवाद

गड़बड़ी - अगर दिया गया इनपुट मान्य Firestore दस्तावेज़ नहीं है.

setDoc(रेफ़रंस, डेटा, विकल्प)

तय किए गए DocumentReference के बताए गए दस्तावेज़ में लिखता है. अगर दस्तावेज़ अब तक मौजूद नहीं है, तो इसे बना दिया जाएगा. merge या mergeFields देने पर, दिए गए डेटा को किसी मौजूदा दस्तावेज़ में मर्ज किया जा सकता है.

इस लिखने का नतीजा, दस्तावेज़ के उन लेखों में ही दिखेगा जो लौटाए गए प्रॉमिस का समाधान हो जाने के बाद होते हैं. अगर क्लाइंट ऑफ़लाइन है, तो डेटा सेव नहीं हो पाता. अगर क्लाइंट के ऑनलाइन होने तक, आपको स्थानीय बदलाव या बफ़र राइट्स देखना है, तो पूरे Firestore SDK का इस्तेमाल करें.

हस्ताक्षर:

export declare function setDoc<AppModelType, DbModelType extends DocumentData>(reference: DocumentReference<AppModelType, DbModelType>, data: PartialWithFieldValue<AppModelType>, options: SetOptions): Promise<void>;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
रेफ़रंस	DocumentReference<AppModelType, DbModelType>	लिखने के लिए दस्तावेज़ का रेफ़रंस.
डेटा	PartialWithFieldValue<AppModelType>	दस्तावेज़ के फ़ील्ड और वैल्यू का मैप.
विकल्प	SetOptions	सेट किए गए व्यवहार को कॉन्फ़िगर करने के लिए ऑब्जेक्ट.

लौटाए जाने वाले प्रॉडक्ट:

प्रॉमिस<void>

बैकएंड में डेटा सही तरीके से लिख लेने के बाद, Promise का समाधान हो जाता है.

अपवाद

गड़बड़ी - अगर दिया गया इनपुट मान्य Firestore दस्तावेज़ नहीं है.

updatedDoc(रेफ़रंस, डेटा)

DocumentReference के बताए गए दस्तावेज़ में फ़ील्ड अपडेट करता है. अगर किसी ऐसे दस्तावेज़ पर लागू किया जाता है जो मौजूद नहीं है, तो अपडेट पूरा नहीं होगा.

इस अपडेट का नतीजा, दस्तावेज़ के ऐसे लेखों में ही दिखेगा जो प्रॉमिस रिज़ॉल्व होने के बाद होते हैं. अगर क्लाइंट ऑफ़लाइन है, तो अपडेट नहीं हो पाता. अगर क्लाइंट के ऑनलाइन होने तक, आपको स्थानीय बदलाव या बफ़र राइट्स देखना है, तो पूरे Firestore SDK का इस्तेमाल करें.

हस्ताक्षर:

export declare function updateDoc<AppModelType, DbModelType extends DocumentData>(reference: DocumentReference<AppModelType, DbModelType>, data: UpdateData<DbModelType>): Promise<void>;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
रेफ़रंस	DocumentReference<AppModelType, DbModelType>	अपडेट किए जाने वाले दस्तावेज़ का रेफ़रंस.
डेटा	UpdateData<DbModelType>	एक ऑब्जेक्ट, जिसमें वे फ़ील्ड और वैल्यू हैं जिनकी मदद से दस्तावेज़ को अपडेट किया जाना है. फ़ील्ड में दस्तावेज़ में नेस्ट किए गए फ़ील्ड का रेफ़रंस देने के लिए बिंदु हो सकते हैं.

लौटाए जाने वाले प्रॉडक्ट:

प्रॉमिस<void>

बैकएंड में डेटा सही तरीके से लिख लेने के बाद, Promise का समाधान हो जाता है.

अपवाद

गड़बड़ी - अगर दिया गया इनपुट मान्य नहीं है.

updatedDoc(रेफ़रंस, फ़ील्ड, वैल्यू, moreFieldsAndValues)

बताए गए दस्तावेज़ में DocumentReference के बताए गए फ़ील्ड अपडेट करता है. अगर किसी ऐसे दस्तावेज़ पर लागू किया गया है जो मौजूद नहीं है, तो अपडेट पूरा नहीं होगा.

बिंदु से अलग किए गए फ़ील्ड पाथ की स्ट्रिंग देकर या FieldPath ऑब्जेक्ट देकर, नेस्ट किए गए फ़ील्ड को अपडेट किया जा सकता है.

इस अपडेट का नतीजा, दस्तावेज़ के ऐसे लेखों में ही दिखेगा जो प्रॉमिस रिज़ॉल्व होने के बाद होते हैं. अगर क्लाइंट ऑफ़लाइन है, तो अपडेट नहीं हो पाता. अगर क्लाइंट के ऑनलाइन होने तक, आपको स्थानीय बदलाव या बफ़र राइट्स देखना है, तो पूरे Firestore SDK का इस्तेमाल करें.

हस्ताक्षर:

export declare function updateDoc<AppModelType, DbModelType extends DocumentData>(reference: DocumentReference<AppModelType, DbModelType>, field: string | FieldPath, value: unknown, ...moreFieldsAndValues: unknown[]): Promise<void>;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
रेफ़रंस	DocumentReference<AppModelType, DbModelType>	अपडेट किए जाने वाले दस्तावेज़ का रेफ़रंस.
फ़ील्ड	स्ट्रिंग | FieldPath	अपडेट किया जाने वाला पहला फ़ील्ड.
value	अज्ञात	पहली वैल्यू.
ज़्यादा फ़ील्ड और वैल्यू	अज्ञात[]	की-वैल्यू के अन्य पेयर.

लौटाए जाने वाले प्रॉडक्ट:

प्रॉमिस<void>

बैकएंड में डेटा सही तरीके से लिख लेने के बाद, Promise का समाधान हो जाता है.

अपवाद

गड़बड़ी - अगर दिया गया इनपुट मान्य नहीं है.

फ़ंक्शन(स्नैपशॉट, ...)

endAt(स्नैपशॉट)

एक ऐसा QueryEndAtConstraint बनाता है जो नतीजे के सेट को दिए गए दस्तावेज़ पर खत्म होने के लिए बदलता है (शामिल है). खत्म होने की पोज़िशन, क्वेरी के क्रम के हिसाब से होती है. दस्तावेज़ में वे सभी फ़ील्ड होने चाहिए जो क्वेरी के orderBy में दिए गए हों.

हस्ताक्षर:

export declare function endAt<AppModelType, DbModelType extends DocumentData>(snapshot: DocumentSnapshot<AppModelType, DbModelType>): QueryEndAtConstraint;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
स्नैपशॉट	DocumentSnapshot<AppModelType, DbModelType>	खत्म होने के लिए दस्तावेज़ का स्नैपशॉट.

लौटाए जाने वाले प्रॉडक्ट:

QueryEndAtConstraint

query() को पास करने के लिए एक QueryEndAtConstraint

end before(स्नैपशॉट)

एक ऐसा QueryEndAtConstraint बनाता है जो नतीजे के सेट को दिए गए दस्तावेज़ (खास तौर पर) से पहले खत्म होने के लिए सेट करता है. खत्म होने की पोज़िशन, क्वेरी के क्रम के हिसाब से होती है. दस्तावेज़ में वे सभी फ़ील्ड होने चाहिए जो क्वेरी के orderBy में दिए गए हों.

हस्ताक्षर:

export declare function endBefore<AppModelType, DbModelType extends DocumentData>(snapshot: DocumentSnapshot<AppModelType, DbModelType>): QueryEndAtConstraint;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
स्नैपशॉट	DocumentSnapshot<AppModelType, DbModelType>	इससे पहले खत्म होने के लिए दस्तावेज़ का स्नैपशॉट.

लौटाए जाने वाले प्रॉडक्ट:

QueryEndAtConstraint

query() को पास करने के लिए एक QueryEndAtConstraint

शुरू के बाद(स्नैपशॉट)

एक QueryStartAtConstraint बनाता है, जो दिए गए दस्तावेज़ (खास तौर पर) के बाद शुरू होने के लिए नतीजे सेट को बदलता है. शुरुआती स्थिति क्वेरी के क्रम के हिसाब से होती है. दस्तावेज़ में वे सभी फ़ील्ड होने चाहिए जो क्वेरी के orderBy में दिए गए हों.

हस्ताक्षर:

export declare function startAfter<AppModelType, DbModelType extends DocumentData>(snapshot: DocumentSnapshot<AppModelType, DbModelType>): QueryStartAtConstraint;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
स्नैपशॉट	DocumentSnapshot<AppModelType, DbModelType>	बाद में शुरू होने वाले दस्तावेज़ का स्नैपशॉट.

लौटाए जाने वाले प्रॉडक्ट:

QueryStartAtConstraint

query() को पास करने के लिए, एक QueryStartAtConstraint

शुरू करें(स्नैपशॉट)

यह एक QueryStartAtConstraint बनाता है, जो दिए गए दस्तावेज़ से शुरू होने वाले नतीजे के सेट में बदलाव करता है, ताकि उसे दिए गए दस्तावेज़ से जोड़ा जा सके. शुरुआती स्थिति क्वेरी के क्रम के हिसाब से होती है. दस्तावेज़ में इस क्वेरी के orderBy में दिए गए सभी फ़ील्ड शामिल होने चाहिए.

हस्ताक्षर:

export declare function startAt<AppModelType, DbModelType extends DocumentData>(snapshot: DocumentSnapshot<AppModelType, DbModelType>): QueryStartAtConstraint;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
स्नैपशॉट	DocumentSnapshot<AppModelType, DbModelType>	शुरू होने के लिए दस्तावेज़ का स्नैपशॉट.

लौटाए जाने वाले प्रॉडक्ट:

QueryStartAtConstraint

query() पर जाने के लिए एक QueryStartAtConstraint.

फ़ंक्शन(वैल्यू, ...)

वेक्टर(वैल्यू)

संख्याओं के दिए गए कलेक्शन की कॉपी से नया VectorValue बनाता है.

हस्ताक्षर:

export declare function vector(values?: number[]): VectorValue;

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
मान	नंबर[]	संख्याओं के इस कलेक्शन की कॉपी के साथ VectorValue इंस्टेंस बनाएं.

लौटाए जाने वाले प्रॉडक्ट:

वेक्टरवैल्यू

संख्याओं के दिए गए कलेक्शन की कॉपी से बनाया गया नया VectorValue.

PrefixToKeys

एक नया मैप दिखाता है, जहां हर कुंजी के शुरू में बाहरी कुंजी को बिंदु से जोड़ा जाता है.

हस्ताक्षर:

export declare type AddPrefixToKeys<Prefix extends string, T extends Record<string, unknown>> = {
    [K in keyof T & string as `${Prefix}.${K}`]+?: string extends K ? any : T[K];
};

एग्रीगेट फ़ील्ड टाइप

सभी AggregateField टाइप जो Firestore के साथ काम करते हैं उनका कॉम्बिनेशन.

हस्ताक्षर:

export declare type AggregateFieldType = ReturnType<typeof sum> | ReturnType<typeof average> | ReturnType<typeof count>;

एग्रीगेटस्पेक्टडेटा

ऐसा टाइप जिसकी कुंजियां AggregateSpec से ली जाती हैं और जिनकी वैल्यू, इनपुट AggregateSpec से लिए गए AggregateField के एग्रीगेशन का नतीजा होती हैं.

हस्ताक्षर:

export declare type AggregateSpecData<T extends AggregateSpec> = {
    [P in keyof T]: T[P] extends AggregateField<infer U> ? U : never;
};

एग्रीगेट टाइप

यूनियन टाइप, जो परफ़ॉर्म किए जाने वाले एग्रीगेट टाइप को दिखाता है.

हस्ताक्षर:

export declare type AggregateType = 'count' | 'avg' | 'sum';

चाइल्डअपडेट फ़ील्ड

दिए गए टाइप T1 के लिए, नेस्ट किए गए फ़ील्ड का हिसाब लगाने में मदद करने वाला टूल. undefined | {...} (वैकल्पिक प्रॉपर्टी के लिए होता है) या {a: A} | {b: B} जैसे यूनियन टाइप के डिस्ट्रिब्यूशन के लिए इसकी ज़रूरत होती है.

इस्तेमाल के इस उदाहरण में, Record को T[K] के यूनियन टाइप को बांटने के लिए V का इस्तेमाल किया जाता है, क्योंकि T[K] का आकलन एक्सप्रेशन के तौर पर किया जाता है, न कि इसे बांटा जाता है.

https://www.typescriptlang.org/docs/handbook/advanced-types.html#distributive-conditional-types देखें

हस्ताक्षर:

export declare type ChildUpdateFields<K extends string, V> = V extends Record<string, unknown> ? AddPrefixToKeys<K, UpdateData<V>> : never;

Firestore में हुई गड़बड़ी का कोड

Firestore स्टेटस कोड का सेट. यहां gRPC के ज़रिए दिखाए गए कोड एक जैसे हैं: https://github.com/grpc/grpc/blob/Master/doc/statuscodes.md

संभावित मान: - 'रद्द किया गया': कार्रवाई रद्द कर दी गई थी (आम तौर पर कॉलर की ओर से). - 'जानकारी नहीं है': ऐसी गड़बड़ी या किसी दूसरे गड़बड़ी डोमेन की गड़बड़ी. - 'अमान्य तर्क': क्लाइंट ने कोई अमान्य तर्क बताया है. ध्यान दें कि यह 'पहले से तय की गई शर्त' से अलग है. 'अमान्य-तर्क' यह ऐसे तर्क को दिखाता है जिनमें सिस्टम की स्थिति की परवाह किए बिना समस्या होती है (उदाहरण के लिए, किसी फ़ील्ड का अमान्य नाम). - 'समयसीमा खत्म हो गई है': कार्रवाई पूरी होने से पहले समयसीमा खत्म हो गई है. सिस्टम की स्थिति बदलने वाले ऑपरेशन के लिए, यह गड़बड़ी दिखाई जा सकती है, भले ही कार्रवाई पूरी तरह से पूरी हो गई हो. उदाहरण के लिए, हो सकता है कि सर्वर से सही जवाब मिलने में ज़्यादा समय लगे और समयसीमा खत्म होने में देरी हो. - 'नहीं मिला': अनुरोध किया गया कुछ दस्तावेज़ नहीं मिला. - 'पहले से मौजूद है': हमने जो दस्तावेज़ बनाने की कोशिश की थी वह पहले से मौजूद है. - 'अनुमति नहीं दी गई': कॉलर के पास बताए गए ऑपरेशन को लागू करने की अनुमति नहीं है. - 'संसाधन खत्म': कुछ संसाधन खत्म हो गए हैं. ऐसा शायद हर उपयोगकर्ता के लिए कोटा खत्म हो गया हो या पूरे फ़ाइल सिस्टम में जगह न बची हो. - 'पहले से तय की गई शर्त': ऑपरेशन को अस्वीकार कर दिया गया था क्योंकि सिस्टम कार्रवाई के निष्पादन के लिए ज़रूरी स्थिति में नहीं है. - 'रद्द किया गया': आम तौर पर, लेन-देन रद्द होने जैसी किसी एक साथ काम करने की समस्या की वजह से कार्रवाई रद्द कर दी जाती है. - 'सीमा से बाहर': सही सीमा से बाहर जाने की कोशिश की गई. - 'लागू नहीं है': ऑपरेशन लागू नहीं किया गया है या काम नहीं करता/चालू नहीं है. - 'इंटरनल': अंदरूनी गड़बड़ियां. इसका मतलब है कि मौजूदा सिस्टम से उम्मीद के मुताबिक कुछ इन्वैरिएंट काम नहीं कर रहे हैं. अगर आपको इनमें से कोई एक गड़बड़ी दिखती है, तो इसका मतलब है कि कुछ ठीक से काम नहीं कर रहा है. - 'उपलब्ध नहीं है': यह सेवा फ़िलहाल उपलब्ध नहीं है. यह स्थिति थोड़े समय के लिए होती है और इसे ठीक करने के लिए, बैकऑफ़ के साथ फिर से कोशिश करें. - 'डेटा-लॉस': डेटा को वापस नहीं पाया जा सकता या खराब हो गया. - 'अप्रमाणित': कार्रवाई के लिए अनुरोध में मान्य प्रमाणीकरण क्रेडेंशियल नहीं हैं.

हस्ताक्षर:

export declare type FirestoreErrorCode = 'cancelled' | 'unknown' | 'invalid-argument' | 'deadline-exceeded' | 'not-found' | 'already-exists' | 'permission-denied' | 'resource-exhausted' | 'failed-precondition' | 'aborted' | 'out-of-range' | 'unimplemented' | 'internal' | 'unavailable' | 'data-loss' | 'unauthenticated';

NestedUpdateFields

हर फ़ील्ड (जैसे कि 'बार') के लिए, नेस्ट की गई सभी कुंजियां ढूंढें (उदाहरण के लिए, {'bar.baz': T1, 'bar.QUx': T2}). उन्हें एक साथ काटकर एक ऐसा मैप बनाएं जिसमें 'ज़रूरी नहीं' के तौर पर मार्क की गई सभी संभावित कुंजियां हों

हस्ताक्षर:

export declare type NestedUpdateFields<T extends Record<string, unknown>> = UnionToIntersection<{
    [K in keyof T & string]: ChildUpdateFields<K, T[K]>;
}[keyof T & string]>;

OrderByDirection

orderBy() क्लॉज़ की दिशा 'ब्यौरा' के तौर पर बताई गई है या 'बढ़ते क्रम में' (घटते क्रम में या बढ़ते क्रम में).

हस्ताक्षर:

export declare type OrderByDirection = 'desc' | 'asc';

PartialWithFieldValue

यह TypeScript के Partial<T> की तरह है. हालांकि, इसमें नेस्ट किए गए फ़ील्ड को प्रॉपर्टी के मान के तौर पर पास करने औरFieldValues को पास करने की अनुमति होती है.

हस्ताक्षर:

export declare type PartialWithFieldValue<T> = Partial<T> | (T extends Primitive ? T : T extends {} ? {
    [K in keyof T]?: PartialWithFieldValue<T[K]> | FieldValue;
} : never);

प्रिमिटिव

प्रिमिटिव टाइप.

हस्ताक्षर:

export declare type Primitive = string | number | boolean | undefined | null;

क्वेरीConstraintType

इस SDK टूल में उपलब्ध अलग-अलग क्वेरी कंस्ट्रेंट के बारे में बताता है.

हस्ताक्षर:

export declare type QueryConstraintType = 'where' | 'orderBy' | 'limit' | 'limitToLast' | 'startAt' | 'startAfter' | 'endAt' | 'endBefore';

क्वेरीफ़िल्टर प्रतिबंध

QueryFilterConstraint एक हेल्पर यूनियन टाइप है, जो QueryFieldFilterConstraint और QueryCompositeFilterConstraint को दिखाता है.

हस्ताक्षर:

export declare type QueryFilterConstraint = QueryFieldFilterConstraint | QueryCompositeFilterConstraint;

क्वेरीNonFilterConstraint

QueryNonFilterConstraint एक हेल्पर यूनियन टाइप है, जो QueryConstraints को दिखाता है, जिनका इस्तेमाल दस्तावेज़ों के सेट को छोटा करने या क्रम से लगाने के लिए किया जाता है. हालांकि, यह दस्तावेज़ के फ़ील्ड पर साफ़ तौर पर फ़िल्टर नहीं करता है. QueryNonFilterConstraint को orderBy(), startAt(), startAfter(), endbefore(), endAt(), limit() या limitToLast() को लागू करके बनाया जाता है. इसके बाद, इसे query() में पास किया जा सकता है.QueryConstraint

हस्ताक्षर:

export declare type QueryNonFilterConstraint = QueryOrderByConstraint | QueryLimitConstraint | QueryStartAtConstraint | QueryEndAtConstraint;

विकल्प सेट करें

एक विकल्प ऑब्जेक्ट, जो setDoc() और कॉल के व्यवहार को कॉन्फ़िगर करता है. इन कॉल को merge: true के साथ SetOptions देकर, टारगेट दस्तावेज़ों को ओवरराइट करने के बजाय, पूरी तरह से मर्ज करने के लिए कॉन्फ़िगर किया जा सकता है.

हस्ताक्षर:

export declare type SetOptions = {
    readonly merge?: boolean;
} | {
    readonly mergeFields?: Array<string | FieldPath>;
};

यूनियन टू इंटरसेक्शन

यूनियन टाइप U = T1 | T2 | ... दिए जाने पर, इंटरसेक्टेड टाइप (T1 & T2 & ...) लौटाता है.

कंडिशनल टाइप की कंडिशनल टाइप और कंडिशनल टाइप के अनुमान का इस्तेमाल करता है. यह इसलिए काम करता है, क्योंकि कॉन्ट्रा-वैरिएंट पोज़िशन में एक ही टाइप वैरिएबल के लिए कई कैंडिडेट होते हैं. इसकी वजह से, इंटरसेक्शन का अनुमान लगाया जाता है. https://www.typescriptlang.org/docs/handbook/advanced-types.html#type-inference-in-conditional-types https://stackoverflow.com/questions/50374908/transform-union-type-to-intersection-type

हस्ताक्षर:

export declare type UnionToIntersection<U> = (U extends unknown ? (k: U) => void : never) extends (k: infer I) => void ? I : never;

डेटा अपडेट करें

updateDoc() के साथ इस्तेमाल करने के लिए डेटा अपडेट करें. इसमें वैल्यू के लिए मैप किए गए फ़ील्ड पाथ (जैसे कि 'foo' या 'foo.baz') शामिल हैं. जिन फ़ील्ड में बिंदु होते हैं वे दस्तावेज़ में नेस्ट किए गए फ़ील्ड का रेफ़रंस देते हैं. फ़ील्ड वैल्यू को प्रॉपर्टी की वैल्यू के तौर पर पास किया जा सकता है.

हस्ताक्षर:

export declare type UpdateData<T> = T extends Primitive ? T : T extends {} ? {
    [K in keyof T]?: UpdateData<T[K]> | FieldValue;
} & NestedUpdateFields<T> : Partial<T>;

व्हिफ़िल्टरऑप

where() क्लॉज़ में फ़िल्टर की शर्तों को '&lt;', '&lt;=', '==', '!=', '&gt;=', '&gt;', 'array-contains', 'in', 'array-contains-any', और 'not-in' स्ट्रिंग का इस्तेमाल करके तय किया जाता है.

हस्ताक्षर:

export declare type WhereFilterOp = '<' | '<=' | '==' | '!=' | '>=' | '>' | 'array-contains' | 'in' | 'array-contains-any' | 'not-in';

फ़ील्ड के साथ वैल्यू

प्रकार सुरक्षा बनाए रखते हुए, फ़ील्ड वैल्यू को प्रॉपर्टी मान के रूप में पास करने की अनुमति देता है.

हस्ताक्षर:

export declare type WithFieldValue<T> = T | (T extends Primitive ? T : T extends {} ? {
    [K in keyof T]: WithFieldValue<T[K]> | FieldValue;
} : never);