@firebase/firestore

İşlevler

İşlev Açıklama
fonksiyon(uygulama, ...)
getFirestore(uygulama) Sağlanan FirebaseApp ile ilişkilendirilmiş mevcut varsayılan Firestore örneğini döndürür. Herhangi bir örnek yoksa varsayılan ayarlarla yeni bir örnek başlatır.
getFirestore(uygulama, veritabanı kimliği) (BETA) Sağlanan FirebaseApp ile ilişkilendirilmiş mevcut adlandırılmış Firestore örneğini döndürür. Herhangi bir örnek yoksa varsayılan ayarlarla yeni bir örnek başlatır.
initializeFirestore(uygulama, ayarlar, veritabanı kimliği) Sağlanan ayarlarla yeni bir Firestore örneğini başlatır. Yalnızca diğer herhangi bir işlevden önce çağrılabilir (getFirestore() dahil). Özel ayarlar boşsa bu işlev, getFirestore() çağrısına eşdeğerdir.
fonksiyon(firestore, ...)
clearIndexedDbPersistence(firestore) Kalıcı depolama alanını temizler. Bekleyen yazmalar ve önbelleğe alınan dokümanlar da buna dahildir.Firestore örneği başlatılmamışken (uygulama sonlandırıldıktan sonra veya uygulama ilk kez başlatıldığında) çağrılmalıdır. Başlangıçta bu işlev, diğer işlevlerden (initializeFirestore() veya getFirestore() dışında) önce çağrılmalıdır. Firestore örneği hâlâ çalışıyorsa taahhüt reddedilir ve bu durum failed-precondition hata kodunu gösterir.Not: clearIndexedDbPersistence() esas olarak Cloud Firestore kullanan güvenilir testler yazmaya yardımcı olması amacıyla tasarlanmıştır. Mevcut verileri bırakmak için etkili bir mekanizma kullanır, ancak önbelleğe alınan verilerin üzerine güvenli bir şekilde yazılmaz veya başka bir şekilde kurtarılamaz hale getirmeye çalışmaz. Kullanıcı oturumları arasında önbelleğe alınan verilerin ifşa edilmesi konusunda hassas olan uygulamalar için kalıcılığı etkinleştirmemenizi önemle tavsiye ederiz.
collection(firestore, path, pathSegments) Belirtilen mutlak yoldaki koleksiyonu ifade eden bir CollectionReference örneği alır.
collectionGroup(firestore, koleksiyonkimliği) Veritabanında belirtilen collectionId ile bir koleksiyon veya alt koleksiyonda yer alan tüm dokümanları içeren yeni bir Query örneği oluşturur ve döndürür.
connectFirestoreEmulator(firestore, ana makine, bağlantı noktası, seçenekler) Cloud Firestore emülatörüyle iletişim kurmak için bu örneği değiştirin.Not: Bu örnek, herhangi bir işlem yapmak için kullanılmadan önce çağrılmalıdır.
disableNetwork(firestore) Bu örnek için ağ kullanımını devre dışı bırakır. enableNetwork() aracılığıyla yeniden etkinleştirilebilir. Ağ devre dışıyken anlık görüntü dinleyicileri, getDoc() veya getDocs() çağrıları önbellekten sonuçlar döndürür ve tüm yazma işlemleri, ağ geri yüklenene kadar sıraya alınır.
doc(firestore, path, pathSegments) Belirtilen mutlak yoldaki belgeye işaret eden bir DocumentReference örneği alır.
enableIndexedDbPersistence(firestore, pendingenceSettings) Mümkünse kalıcı depolama alanını etkinleştirmeye çalışır.Başarısızlık durumunda, enableIndexedDbPersistence() taahhüdü reddeder veya bir istisna yapar. Bu işlemin başarısız olmasının çeşitli nedenleri vardır. Bu neden, hatadaki code tarafından tespit edilebilir.* başarısız ön koşul: Uygulama zaten başka bir tarayıcı sekmesinde açık. * uygulanmadı: Tarayıcı, çevrimdışı kalıcılık uygulamasıyla uyumlu değil.Hatadan sonra bile Firestore örneğinin kullanılabilir durumda kalacağını ancak çevrimdışı kalıcılık devre dışı bırakılacağını unutmayın.Not: enableIndexedDbPersistence(), diğer işlevlerden (initializeFirestore(), getFirestore() veya clearIndexedDbPersistence() dışındaki herhangi bir işlevden) önce çağrılmalıdır.Persistence() ortamında kullanılamaz.Persistence.js.
enableMultiTabIndexedDbPersistence(firestore) Mümkünse çok sekmeli kalıcı depolamayı etkinleştirmeye çalışır. Tüm sekmelerde etkinleştirilirse tüm işlemler, tüm bağlı örneklerde sorguların ortak yürütülmesi ve gecikmeyi telafi eden yerel doküman güncellemeleri dahil olmak üzere yerel kalıcılığa erişimi paylaşır.Başarısızlık durumunda, enableMultiTabIndexedDbPersistence() sözü reddeder veya bir istisna yapar. Bu işlemin başarısız olmasının çeşitli nedenleri vardır. Bu neden, hatadaki code tarafından tespit edilebilir.* başarısız ön koşul: Uygulama zaten başka bir tarayıcı sekmesinde açık ve çoklu sekme etkin değil. * uygulanmadı: Tarayıcı, çevrimdışı kalıcılık uygulamasıyla uyumlu değil.Hata sonrasında bile Firestore örneğinin kullanılabilir durumda kalacağını ancak çevrimdışı kalıcılık devre dışı bırakılacağını unutmayın.
enableNetwork(firestore) Önceki bir disableNetwork() çağrısından sonra bu Firestore örneği için ağ kullanımını yeniden etkinleştirir.
getPersistentCacheIndexManager(firestore) Belirtilen Firestore nesnesi tarafından kullanılan PersistentCache Dizin Yöneticisi'ni döndürür. PersistentCacheIndexManager örneği veya yerel kalıcı depolama alanı kullanılmıyorsa null.
loadBundle(firestore, BundleData) Yerel önbelleğe bir Firestore paketi yükler.
adlandırılmışQuery(firestore, ad) Belirtilen adla tanımlanan yerel önbellekten bir Firestore Sorgusu okur.Adlandırılan sorgular, sunucu tarafında paketler halinde paketlenir (sonuçlanan belgelerle birlikte) ve loadBundle kullanılarak yerel önbelleğe yüklenir. Yerel önbelleğe alındıktan sonra, bir Sorgu'yu ada göre ayıklamak için bu yöntemi kullanın.
onSnapshotsInSync(firestore, gözlemci) Senkronize edilen anlık görüntüler etkinliği için bir işleyici ekler. Sync-in-sync etkinliği, sunucu tarafından oluşturulan tek bir değişiklik birden çok işleyiciyi etkilese bile belirli bir değişiklikten etkilenen tüm işleyicilerin tetiklendiğini gösterir.NOT: Senkronizasyondaki anlık görüntüler etkinliği yalnızca işleyicilerin birbiriyle senkronize olduğunu gösterir, ancak bu anlık görüntülerin sunucuyla senkronize olup olmamasıyla ilgili değildir. Bir anlık görüntünün önbellekten mi yoksa sunucudan mı geldiğini belirlemek için tek tek dinleyicilerde SnapshotMetadata kullanın.
onSnapshotsInSync(firestore, onSync) Senkronize edilen anlık görüntüler etkinliği için bir işleyici ekler. Sync-in-sync etkinliği, sunucu tarafından oluşturulan tek bir değişiklik birden çok işleyiciyi etkilese bile belirli bir değişiklikten etkilenen tüm işleyicilerin tetiklendiğini gösterir.NOT: Senkronizasyondaki anlık görüntüler etkinliği yalnızca işleyicilerin birbiriyle senkronize olduğunu gösterir, ancak bu anlık görüntülerin sunucuyla senkronize olup olmamasıyla ilgili değildir. Bir anlık görüntünün önbellekten mi yoksa sunucudan mı geldiğini belirlemek için bağımsız işleyicilerde SnapshotMetadata kullanın.
runTransaction(firestore, updateFunction, seçenekler) Belirtilen updateFunction işlemini yürütür ve ardından işlemde uygulanan değişiklikleri uygulamaya çalışır. İşlem kapsamında okunan herhangi bir belge değiştiyse Cloud Firestore, updateFunction işlemini yeniden dener. 5 denemeden sonra tamamlanamaması durumunda işlem başarısız olur.Tek bir işlemde izin verilen maksimum yazma sayısı 500'dür.
setIndexConfiguration(firestore, yapılandırma) (BETA) Yerel sorgu yürütme için dizine eklemeyi yapılandırır. Önceki tüm dizin yapılandırmaları geçersiz kılınır. Dizin yapılandırması devam ettirildikten sonra Promise çözülür.Dizin girişleri eşzamansız olarak oluşturulur. Dizinler henüz kullanılamıyor olsa bile dizine ekleme gerektiren sorguları kullanmaya devam edebilirsiniz. Sorgu yürütme, dizin girişleri yazıldıktan sonra otomatik olarak dizini kullanmaya başlar.Dizinler yalnızca IndexedDb kalıcılığıyla desteklenir. IndexedDb etkin değilse dizin yapılandırması yok sayılır.
setIndexConfiguration(firestore, json) (BETA) Yerel sorgu yürütme için dizine eklemeyi yapılandırır. Önceki tüm dizin yapılandırmaları geçersiz kılınır. Dizin yapılandırması devam ettirildikten sonra Promise çözülür.Dizin girişleri eşzamansız olarak oluşturulur. Dizinler henüz kullanılamıyor olsa bile dizine ekleme gerektiren sorguları kullanmaya devam edebilirsiniz. Sorgu yürütme, dizin girişleri yazıldıktan sonra otomatik olarak dizini kullanmaya başlar.Dizinler yalnızca IndexedDb kalıcılığıyla desteklenir. Dizin yapılandırmasını ayarlamadan önce enableIndexedDbPersistence() veya enableMultiTabIndexedDbPersistence() çağırın. IndexedDb etkin değilse dizin yapılandırması yok sayılır.Bu yöntem, Firebase CLI (firebase firestore:indexes) tarafından dışa aktarılan JSON biçimini kabul eder. JSON biçimi geçersizse bu yöntem hata verir.
sonlandırma(firestore) Sağlanan Firestore örneğini sonlandırır.terminate() çağrıldıktan sonra yalnızca clearIndexedDbPersistence() işlevi kullanılabilir. Diğer tüm işlevler bir FirestoreError atar.Sonlandırma işleminden sonra yeniden başlatmak için getFirestore() ile yeni bir FirebaseFirestore örneği oluşturun.Fesih işlemi, bekleyen yazma işlemlerini iptal etmez ve sunucudan yanıt bekleyen taahhütler çözümlenmez. Kalıcılığı etkinleştirdiyseniz bu örneği bir sonraki başlatmanızda sunucuya bu yazma işlemleri sunucuya gönderilmeye devam edilir.Not: Normal koşullarda terminate() çağrısı gerekli değildir. Bu işlev, yalnızca bu örneği tüm kaynaklarını serbest bırakmaya zorlamak istediğinizde veya test çalıştırmaları arasında tüm yerel durumun yok edilmesini sağlamak için clearIndexedDbPersistence() ile birlikte kullanılabilir.
waitForPendingWrites(firestore) Etkin kullanıcı için şu anda bekleyen tüm yazmalar arka uç tarafından onaylanana kadar bekler.Bekleyen yazma yoksa döndürülen taahhüt hemen çözümlenir. Aksi takdirde, taahhüt önceden verilmiş tüm yazmaları (önceki uygulama oturumunda yazılanlar da dahil) bekler, ancak işlev çağrıldıktan sonra eklenen yazmaları beklemez. Başka yazma işlemleri için beklemek istiyorsanız waitForPendingWrites() kodunu tekrar çağırın.Kullanıcı değişiklikleri sırasında bekleyen waitForPendingWrites() taahhütleri reddedilir.
WriteBatch(firestore) Tek bir atomik işlem olarak birden fazla yazma işlemi gerçekleştirmek için kullanılan bir yazma grubu oluşturur. Tek bir WriteBatch içinde izin verilen maksimum yazma sayısı 500'dür.İşlemlerin aksine yazma grupları çevrimdışı olarak saklanır, bu nedenle yazmalarınızı okunan veriler üzerinde koşullandırmanız gerekmediğinde tercih edilir.
fonksiyon()
count() Sorgunun sonuç kümesindeki belge sayısını hesaplamak için kullanılabilecek bir AggregateField nesnesi oluşturun.
deleteField() Bir alanı silinmek üzere işaretlemek için updateDoc() veya setDoc() ile kullanılacak {merge: true} ile birlikte kullanılacak bir sentinel döndürür.
documentId() Bir dokümanın kimliğine başvuruda bulunmak için özel bir koruyucu FieldPath döndürür. Sorgularda doküman kimliğine göre sıralama veya filtreleme yapmak için kullanılabilir.
getFirestore() Varsayılan FirebaseApp ile ilişkili mevcut varsayılan Firestore örneğini döndürür. Herhangi bir örnek yoksa varsayılan ayarlarla yeni bir örnek başlatır.
memoryEagerGarbageCollector() MemoryEagerGarbageCollector örneği oluşturur. Bu, aksi belirtilmedikçe varsayılan atık toplayıcıdır.
persistentMultipleTabManager() PersistentMultipleTabManager örneği oluşturur.
serverTimestamp() Yazılı verilere sunucu tarafından oluşturulan bir zaman damgası eklemek için setDoc() veya updateDoc() ile kullanılan bir sentinel döndürür.
fonksiyon(veritabanıId, ...)
getFirestore(veritabanıKimliği) (BETA) Varsayılan FirebaseApp ile ilişkilendirilmiş mevcut adlandırılmış Firestore örneğini döndürür. Herhangi bir örnek yoksa varsayılan ayarlarla yeni bir örnek başlatır.
fonksiyon(öğeler, ...)
arrayRemove(öğeler) setDoc() ile kullanılabilecek veya sunucuya, belirtilen öğeleri sunucuda zaten bulunan herhangi bir dizi değerinden kaldırmasını bildiren özel değeri döndürür. Belirtilen her bir öğenin tüm örnekleri diziden kaldırılır. Değiştirilen alan halihazırda bir dizi değilse boş bir diziyle bu alanın üzerine yazılır.
arrayUnion(öğeler) setDoc() veya updateDoc() ile kullanılabilecek özel değeri döndürür. Bu değer, sunucuya belirtilen öğeleri sunucuda zaten mevcut olan herhangi bir dizi değeriyle birleştirmesini bildirir. Dizide mevcut olmayan belirtilen her bir öğe sona eklenir. Değiştirilen alan halihazırda bir dizi değilse, tam olarak belirtilen öğeleri içeren bir dizi bu alanın üzerine yazılır.
fonksiyon(alan, ...)
ortalama(alan) Sorgunun sonuç grubundaki bir dizi belge üzerinde belirtilen bir alanın ortalamasını hesaplamak için kullanılabilecek bir AggregateField nesnesi oluşturun.
topla(alan) Sorgunun sonuç kümesindeki bir dizi belge üzerinde belirtilen bir alanın toplamını hesaplamak için kullanılabilecek bir AggregateField nesnesi oluşturun.
function(fieldPath, ...)
orderBy(fieldPath, DirectionStr) Sorgu sonucunu belirtilen alana göre (isteğe bağlı olarak artan yerine azalan düzende) sıralayan QueryOrdersByConstraint işlemi oluşturur.Not: Belirtilen alanı içermeyen dokümanlar sorgu sonucunda yer almaz.
where(fieldPath, opStr, value) Belgelerin belirtilen alanı içermesi ve değerin sağlanan ilişki kısıtlamasını karşılaması gerektiğini zorunlu kılan bir QueryFieldFilterConstraint oluşturur.
function(fieldValues, ...)
endAt(fieldValues) Sonuç kümesini, sorgunun sırasına göre sağlanan alanlarda sona erecek şekilde değiştiren bir QueryEndAtConstraint oluşturur. Alan değerlerinin sırası, sorgudaki ifadelere göre sıralamayla aynı olmalıdır.
endBefore(fieldValues) Sonuç kümesini, sorgunun sırasına göre sağlanan alanlardan önce sona erecek şekilde değiştiren bir QueryEndAtConstraint oluşturur. Alan değerlerinin sırası, sorgudaki ifadelere göre sıralamayla aynı olmalıdır.
startAfter(fieldValues) Sonuç kümesini, sorgunun sırasına göre sağlanan alanlardan sonra başlayacak şekilde değiştiren bir QueryStartAtConstraint oluşturur. Alan değerlerinin sırası, sorgudaki ifadelere göre sıralamayla aynı olmalıdır.
startAt(fieldValues) Sonuç kümesini sorgunun sırasına göre sağlanan alanlarda başlayacak şekilde değiştiren bir QueryStartAtConstraint oluşturur. Alan değerlerinin sırası, sorgudaki ifadelere göre sıralamayla aynı olmalıdır.
fonksiyon(indexManager, ...)
deleteAllPersistentCacheIndexes(indexManager) Tüm kalıcı önbellek dizinlerini kaldırır.Bu işlevin, desteği sonlandırılan setIndexConfiguration() tarafından oluşturulan dizinleri de sileceğini lütfen unutmayın.
disablePersistentCacheIndexAutoCreation(indexManager) Yerel sorgu yürütme için kalıcı önbellek dizinlerini otomatik olarak oluşturmayı durdurur. enablePersistentCacheIndexAutoCreation() çağrısı yapılarak oluşturulan dizinler geçerli olmaya devam eder.
enablePersistentCacheIndexAutoCreation(indexManager) SDK, önbellek dizinlerinin performansı iyileştirmeye yardımcı olabileceğini düşünüyorsa, yerel sorgu yürütme için otomatik olarak kalıcı önbellek dizinleri oluşturmasını sağlayan SDK'yı etkinleştirir.Bu özellik varsayılan olarak devre dışıdır.
fonksiyon(sol, ...)
aggregateFieldEqual(sol, sağ) Eşitlik için iki "AggregateField" örneğini karşılaştırır.
aggregateQuerySnapshotEqual(sol, sağ) Eşitlik için iki AggregateQuerySnapshot örneğini karşılaştırır.İki AggregateQuerySnapshot örneği "eşit" olarak kabul edilir ve aynı verileri karşılaştıran temel sorguları olup olmadığını gösterir.
queryEqual(sol, sağ) Sağlanan sorgular aynı koleksiyonu işaret ederse ve aynı kısıtlamaları uygularsa true değerini döndürür.
refEqual(sol, sağ) Sağlanan referanslar eşitse true değerini döndürür.
snapshotEqual(sol, sağ) Sağlanan anlık görüntüler eşitse true değerini döndürür.
function(limit, ...)
limit(limit) Yalnızca ilk eşleşen dokümanları döndüren bir QueryLimitConstraint oluşturur.
limitToLast(sınır) Yalnızca son eşleşen dokümanları döndüren bir QueryLimitConstraint oluşturur.limitToLast sorguları için en az bir orderBy ifadesi belirtmeniz gerekir, aksi takdirde yürütme sırasında bir istisna oluşur.
function(logLevel, ...)
setLogLevel(logLevel) Cloud Firestore günlüklerinin ayrıntısını ayarlar (hata ayıklama, hata veya sessiz).
fonksiyon(n; ...)
artım(n) setDoc() veya updateDoc() ile kullanılabilecek özel bir değer döndürür ve sunucuya alanın geçerli değerini belirtilen değere göre artırmasını söyler.İşlem gören veya geçerli alan değerinde kayan nokta hassasiyeti kullanılıyorsa tüm aritmetiklerde IEEE 754 semantiği uygulanır. Her iki değer de tam sayıysa JavaScript'in güvenli sayı aralığı (Number.MIN_SAFE_INTEGER - Number.MAX_SAFE_INTEGER) dışındaki değerler de kesinlik kaybına tabi olur. Ayrıca, Firestore arka ucu tarafından işlendikten sonra tüm tam sayı işlemleri -2^63 ile 2^63-1 arasında sınırlandırılır.Geçerli alan değeri number türünde değilse veya alan henüz mevcut değilse dönüşüm işlemi, alanı verilen değere ayarlar.
fonksiyon(sorgu, ...)
getAggregateFromServer(sorgu, aggregateSpec) Belgeleri indirmeden belirli bir sorgunun sonuç kümesindeki dokümanlar üzerinden belirtilen toplamaları hesaplar.Dokümanların değil, yalnızca nihai toplama değerlerinin değil, toplam toplama değerlerinin toplanması için bu işlevin kullanılması verimlidir. indirilerek oluşturulur. Bu işlev, sonuç kümesinin tamamıyla indirilemeyecek kadar büyük olduğu durumlarda (binlerce doküman) dokümanların toplamalarını gerçekleştirebilir.Sunucudan alınan sonuç, yerel bir durum dikkate alınmaksızın, değiştirilmeden sunulur. Diğer bir deyişle, yerel önbellekteki dokümanlar ve henüz sunucuyla senkronize edilmemiş yerel değişiklikler dikkate alınmaz. Daha önce indirilen sonuçlar (varsa) kullanılmaz. Bu işlevin her çağrılması zorunlu olarak sunucuya bir gidiş dönüşü içerir.
getCountFromServer(sorgu) Belgeleri indirmeden belirli bir sorgunun sonuç kümesindeki doküman sayısını hesaplar.Dokümanların değil yalnızca nihai sayım yapıldığından bu işlevin doküman sayılması için kullanılması verimlidir. indirilerek yüklenir. Bu işlev, sonuç kümesinin tamamen indirilemeyecek kadar büyük olduğu durumlarda dokümanları sayabilir (binlerce doküman).Sunucudan alınan sonuç, yerel bir durum dikkate alınmaksızın, değiştirilmeden sunulur. Diğer bir deyişle, yerel önbellekteki dokümanlar ve henüz sunucuyla senkronize edilmemiş yerel değişiklikler dikkate alınmaz. Daha önce indirilen sonuçlar (varsa) kullanılmaz. Bu işlevin her çağrılması zorunlu olarak sunucuya bir gidiş dönüşü içerir.
getDokümanlar(sorgu) Sorguyu yürütür ve sonuçları QuerySnapshot olarak döndürür.Not: getDocs(), mümkün olduğunda sunucudan veri bekleyerek güncel veriler sağlamaya çalışır, ancak çevrimdışıysanız ve sunucuya erişilemiyorsa önbelleğe alınan verileri döndürebilir veya başarısız olabilir. Bu davranışı belirtmek için getDokümanlarFromCache() veya getDocumentsFromServer() yöntemini çağırın.
getDokümanlarFromCache(sorgu) Sorguyu yürütür ve sonuçları önbellekten bir QuerySnapshot olarak döndürür. Sorguyla eşleşen hiçbir doküman önbelleğe alınmışsa boş bir sonuç kümesi döndürür.
getDokümanlarFromServer(sorgu) Sorguyu yürütür ve sonuçları sunucudan bir QuerySnapshot olarak döndürür. Ağ mevcut değilse bir hata döndürür.
onSnapshot(sorgu; gözlemci) QuerySnapshot etkinlikleri için bir işleyici ekler. Tek tek onNext ve onError geri çağırmalarını iletebilir veya next ve error geri çağırmalarıyla tek bir gözlemci nesnesini iletebilirsiniz. İşleyici, onSnapshot çağrıldığında döndürülen işlev çağırılarak iptal edilebilir.NOT: onCompletion geri çağırması yapılabilse de anlık görüntü akışı hiç bitmediğinden hiçbir zaman çağrılmaz.
onSnapshot(sorgu; seçenekler, gözlemci) QuerySnapshot etkinlikleri için bir işleyici ekler. Tek tek onNext ve onError geri çağırmalarını iletebilir veya next ve error geri çağırmalarıyla tek bir gözlemci nesnesini iletebilirsiniz. İşleyici, onSnapshot çağrıldığında döndürülen işlev çağırılarak iptal edilebilir.NOT: onCompletion geri çağırması yapılabilse de anlık görüntü akışı hiç bitmediğinden hiçbir zaman çağrılmaz.
onSnapshot(query, onNext, onError, onComplete) QuerySnapshot etkinlikleri için bir işleyici ekler. Tek tek onNext ve onError geri çağırmalarını iletebilir veya next ve error geri çağırmalarıyla tek bir gözlemci nesnesini iletebilirsiniz. İşleyici, onSnapshot çağrıldığında döndürülen işlev çağırılarak iptal edilebilir.NOT: onCompletion geri çağırması yapılabilse de anlık görüntü akışı hiç bitmediğinden hiçbir zaman çağrılmaz.
onSnapshot(query, options, onNext, onError, onComplete) QuerySnapshot etkinlikleri için bir işleyici ekler. Tek tek onNext ve onError geri çağırmalarını iletebilir veya next ve error geri çağırmalarıyla tek bir gözlemci nesnesini iletebilirsiniz. İşleyici, onSnapshot çağrıldığında döndürülen işlev çağırılarak iptal edilebilir.NOT: onCompletion geri çağırması yapılabilse de anlık görüntü akışı hiç bitmediğinden hiçbir zaman çağrılmaz.
query(sorgu, connectorFilter, queryConstraints) Ek sorgu kısıtlamaları içerecek şekilde genişletilen yeni bir sabit Query örneğini oluşturur.
sorgu(sorgu; queryConstraints) Ek sorgu kısıtlamaları içerecek şekilde genişletilen yeni bir sabit Query örneğini oluşturur.
fonksiyon(queryConstraints, ...)
and(queryConstraints) Belirtilen filtre kısıtlamalarının bir birleşimi olan yeni bir QueryCompositeFilterConstraint oluşturur. Bağlaç filtreleri, belirtilen tüm filtreleri karşılıyorsa dokümanı içerir.
veya(queryConstraints) Belirtilen filtre kısıtlamalarının ayırması olan yeni bir QueryCompositeFilterConstraint oluşturur. Ayırma filtreleri, belirtilen filtrelerden herhangi birine uyan dokümanı içerir.
fonksiyon(referans, ...)
addDoc(referans, veri) Belirtilen CollectionReference için belirtilen verilerle yeni bir doküman ekleyin ve bu dokümana otomatik olarak doküman kimliği atayın.
collection(referans, yol, yolSegmentleri) Belirtilen göreli yoldaki bir reference alt koleksiyonuna referans veren CollectionReference örneğini alır.
collection(referans, yol, yolSegmentleri) Belirtilen göreli yoldaki bir reference alt koleksiyonuna referans veren CollectionReference örneğini alır.
deleteDoc(referans) Belirtilen DocumentReference tarafından atıfta bulunulan dokümanı siler.
doc(referans, yol, yolSegmentleri) Belirtilen göreli yolda reference içindeki bir dokümana referans veren DocumentReference örneğini alır. Herhangi bir yol belirtilmezse döndürülen DocumentReference için otomatik olarak oluşturulmuş benzersiz bir kimlik kullanılır.
doc(referans, yol, yolSegmentleri) Belirtilen göreli yolda reference içindeki bir dokümana referans veren DocumentReference örneğini alır.
getDoc(referans) Bu DocumentReference tarafından atıfta bulunulan dokümanı okur.Not: getDoc(), mümkün olduğunda sunucudan veri bekleyerek güncel veriler sağlamaya çalışır, ancak çevrimdışıysanız ve sunucuya ulaşılamıyorsa sunucu, önbelleğe alınmış verileri döndürebilir veya başarısız olabilir. Bu davranışı belirtmek için getDocFromCache() veya getDocFromServer() yöntemini çağırın.
getDocFromCache(referans) Bu DocumentReference tarafından başvuruda bulunulan dokümanı önbellekten okur. Doküman şu anda önbelleğe alınmış değilse bir hata döndürür.
getDocFromServer(referans) Bu DocumentReference tarafından başvuruda bulunulan dokümanı sunucudan okur. Ağ mevcut değilse bir hata döndürür.
onSnapshot(başvuru, gözlemci) DocumentSnapshot etkinlikleri için bir işleyici ekler. Tek tek onNext ve onError geri çağırmalarını iletebilir veya next ve error geri çağırmaları ile tek bir gözlemci nesnesi aktarabilirsiniz.NOT: onCompletion geri çağırması yapılabilse de anlık görüntü akışı bitmediğinden hiçbir zaman çağrılmaz.
onSnapshot(başvuru; seçenekler, gözlemci) DocumentSnapshot etkinlikleri için bir işleyici ekler. Tek tek onNext ve onError geri çağırmalarını iletebilir veya next ve error geri çağırmaları ile tek bir gözlemci nesnesi aktarabilirsiniz.NOT: onCompletion geri çağırması yapılabilse de anlık görüntü akışı bitmediğinden hiçbir zaman çağrılmaz.
onSnapshot(reference, onNext, onError, onComplete) DocumentSnapshot etkinlikleri için bir işleyici ekler. Tek tek onNext ve onError geri çağırmalarını iletebilir veya next ve error geri çağırmaları ile tek bir gözlemci nesnesi aktarabilirsiniz.NOT: onCompletion geri çağırması yapılabilse de anlık görüntü akışı bitmediğinden hiçbir zaman çağrılmaz.
onSnapshot(reference, options, onNext, onError, onComplete) DocumentSnapshot etkinlikleri için bir işleyici ekler. Tek tek onNext ve onError geri çağırmalarını iletebilir veya next ve error geri çağırmaları ile tek bir gözlemci nesnesi aktarabilirsiniz.NOT: onCompletion geri çağırması yapılabilse de anlık görüntü akışı bitmediğinden hiçbir zaman çağrılmaz.
setDoc(referans, veri) Bu DocumentReference tarafından atıfta bulunulan belgeye yazar. Doküman henüz yoksa oluşturulur.
setDoc(referans; veriler; seçenekler) Belirtilen DocumentReference tarafından atıfta bulunulan dokümana yazar. Doküman henüz yoksa oluşturulur. merge veya mergeFields sağlarsanız, sağlanan veriler mevcut bir belgede birleştirilebilir.
updateDoc(referans, veri) Belirtilen DocumentReference tarafından belirtilen dokümandaki alanları günceller. Mevcut olmayan bir dokümana uygulanırsa güncelleme başarısız olur.
updateDoc(başvuru; alan; değer; moreFieldsAndValues) Belirtilen DocumentReference tarafından atıfta bulunulan dokümandaki alanları günceller. Mevcut olmayan bir dokümana uygulanırsa güncelleme başarısız olur.İç içe yerleştirilmiş alanlar, noktayla ayrılmış alan yolu dizeleri sağlayarak veya FieldPath nesne sağlanarak güncellenebilir.
fonksiyon(ayarlar, ...)
memoryLocalCache(ayarlar) MemoryLocalCache örneği oluşturur. Örnek, SDK'ya hangi önbellek katmanının kullanılacağını bildirmek için FirestoreSettings.cache olarak ayarlanabilir.
memoryLruGarbageCollector(ayarlar) MemoryLruGarbageCollector öğesinin bir örneğini oluşturur.Ayar parametresinin parçası olarak bir hedef boyutu belirtilebilir. Önbellek boyutu belirtilen boyutu aştığında toplayıcı, dokümanları silmeye başlar. Varsayılan önbellek boyutu 40 MB'tır (40 * 1024 * 1024 bayt).
persistentLocalCache(ayarlar) PersistentLocalCache örneği oluşturur. Örnek, SDK'ya hangi önbellek katmanının kullanılacağını bildirmek için FirestoreSettings.cache olarak ayarlanabilir.Kalıcı önbellek, Node.js ortamında kullanılamaz.
persistentSingleTabManager(ayarlar) PersistentSingleTabManager örneği oluşturur.
fonksiyon(anlık görüntü, ...)
endAt(snapshot) Sonuç grubunu, sağlanan belgede (dahil) sona erecek şekilde değiştiren bir QueryEndAtConstraint oluşturur. Bitiş konumu, sorgunun sırasına göre değişir. Belge, sorgunun OrderBy bölümünde sağlanan tüm alanları içermelidir.
endBefore(anlık görüntü) Sonuç grubunu, sağlanan dokümandan (hariç) önce bitecek şekilde değiştiren bir QueryEndAtConstraint oluşturur. Bitiş konumu, sorgunun sırasına göre değişir. Belge, sorgunun OrderBy bölümünde sağlanan tüm alanları içermelidir.
startAfter(snapshot) Sonuç grubunu, sağlanan dokümandan (hariç) sonra başlayacak şekilde değiştiren bir QueryStartAtConstraint oluşturur. Başlangıç konumu, sorgunun sırasına göre değişir. Belge, sorgunun OrderBy bölümünde sağlanan tüm alanları içermelidir.
startAt(snapshot) Sonuç grubunu, sağlanan belgede (dahil) başlayacak şekilde değiştiren bir QueryStartAtConstraint oluşturur. Başlangıç konumu, sorgunun sırasına göre değişir. Belge, bu sorgunun orderBy bölümünde sağlanan tüm alanları içermelidir.
fonksiyon(değerler, ...)
vektör(değerler) Belirtilen sayı dizisinin bir kopyasıyla oluşturulan yeni bir VectorValue oluşturur.

Sınıflar

Sınıf Açıklama
AggregateField Firestore tarafından gerçekleştirilebilecek bir toplamayı gösterir.
AggregateQuerySnapshot Toplama sorgusu yürütmenin sonuçları.
Bayt Bayt dizisini temsil eden sabit nesne.
KoleksiyonReferansı Doküman eklemek, doküman başvurularını almak ve dokümanlarda sorgulama yapmak (query() ile) için CollectionReference nesnesi kullanılabilir.
DocumentReference DocumentReference, Firestore veritabanındaki bir doküman konumunu ifade eder ve konumu yazmak, okumak veya dinlemek için kullanılabilir. Atıfta bulunulan konumdaki belge mevcut veya olmayabilir.
DocumentSnapshot DocumentSnapshot, Firestore veritabanınızdaki bir belgeden okunan verileri içerir. Belirli bir alanı almak için veriler .data() veya .get(<field>) ile çıkarılabilir.Mevcut olmayan bir belgeye işaret eden DocumentSnapshot için tüm veri erişimleri "tanımsız" değerini döndürür. Bir dokümanın varlığını açıkça doğrulamak için exists() yöntemini kullanabilirsiniz.
FieldPath FieldPath, dokümandaki bir alanı ifade eder. Yol, tek bir alan adından (dokümandaki üst düzey bir alana atıfta bulunur) veya alan adları listesinden (dokümandaki iç içe yerleştirilmiş bir alana atıfta bulunur) oluşabilir.Alan adlarını girerek bir FieldPath oluşturun. Birden fazla alan adı sağlanırsa yol, bir dokümandaki iç içe yerleştirilmiş bir alanı işaret eder.
Alan Değeri set() veya update() ile doküman alanları yazarken kullanılabilecek Sentinel değerleri.
Firestore Cloud Firestore hizmet arayüzü.Bu oluşturucuyu doğrudan çağırmayın. Bunun yerine getFirestore() işlevini kullanın.
Firestore Hatası Firestore işlemi tarafından hata döndürüldü.
GeoPoint Firestore'da coğrafi bir konumu temsil eden sabit nesne. Konum, enlem/boylam çifti olarak gösterilir.Enlem değerleri [-90, 90] aralığındadır. Boylam değerleri [-180, 180] aralığındadır.
LoadBundleTask Firestore paketi yükleme görevini temsil eder. Paket yükleme işleminin ilerleme durumunu, görev tamamlama ile hata etkinliklerini gösterir.API, Promise<LoadBundleTaskProgress> ile uyumludur.
PersistentCacheIndexManager Yerel sorgu yürütmede kullanılan kalıcı önbellek dizinlerini yapılandırmak için kullanılan PersistentCacheIndexManager.Kullanmak için getPersistentCacheIndexManager() çağrısı yaparak bir örnek alın.
Sorgu Query, okuyabileceğiniz veya dinleyebileceğiniz bir sorguyu ifade eder. Ayrıca, filtreler ve sıralama ekleyerek hassaslaştırılmış Query nesneleri oluşturabilirsiniz.
QueryCompositeFilterConstraint QueryCompositeFilterConstraint, birden fazla QueryFieldFilterConstraint veya QueryCompositeFilterConstraint mantıksal VEYA ya da VE yöntemini gerçekleştirerek bir Firestore sorgusu tarafından döndürülen doküman grubunu daraltmak için kullanılır. QueryCompositeFilterConstraint öğeleri, or() ya da and() çağrılarak oluşturulur ve ardından QueryCompositeFilterConstraint öğesini de içeren yeni bir sorgu örneği oluşturmak için query() işlevine iletilebilir.
SorguKısıtlaması QueryConstraint, Firestore sorgusu tarafından döndürülen belge grubunu daraltmak için kullanılır. QueryConstraint'ler where(), orderBy(), startAt(), startAfter(), endBefore(), endAt(), limit(), limitToLast() iletilecek şekilde yeni bir sorgu oluşturmak üzere oluşturulur ve daha sonra limitToLast() türünde yeni bir sorgu oluşturun.QueryConstraint
QueryDocumentSnapshot QueryDocumentSnapshot, sorgunun parçası olarak Firestore veritabanınızdaki bir belgeden okunan verileri içerir. Belgenin mevcut olması garanti edilir. Belirli bir alanı almak için belgenin verileri .data() veya .get(<field>) ile çıkarılabilir.QueryDocumentSnapshot, DocumentSnapshot ile aynı API yüzeyini sunar. Sorgu sonuçları yalnızca mevcut dokümanları içerdiğinden, exists özelliği her zaman doğru olur ve data() hiçbir zaman "tanımsız" değerini döndürmez.
SorguBitişAkısıtlaması QueryEndAtConstraint, belgeleri bir Firestore sorgusu tarafından döndürülen sonuç kümesinin sonundan hariç tutmak için kullanılır. QueryEndAtConstraint öğeleri, endAt() veya endBefore() çağrısı yapılarak oluşturulur ve ardından bu QueryEndAtConstraint öğesini de içeren yeni bir sorgu örneği oluşturmak için query() işlevine iletilebilir.
QueryFieldFilterConstraint QueryFieldFilterConstraint, bir veya daha fazla belge alanını filtreleyerek Firestore sorgusu tarafından döndürülen doküman grubunu daraltmak için kullanılır. QueryFieldFilterConstraint öğeleri, where() çalıştırılarak oluşturulur ve daha sonra bu QueryFieldFilterConstraint öğesini de içeren yeni bir sorgu örneği oluşturmak için query() öğesine iletilebilir.
QueryLimitConstraint QueryLimitConstraint, Firestore sorgusu tarafından döndürülen doküman sayısını sınırlandırmak için kullanılır. QueryLimitConstraint öğeleri, limit() veya limitToLast() çağrısı yapılarak oluşturulur ve ardından, bu QueryLimitConstraint öğesini de içeren yeni bir sorgu örneği oluşturmak için query() işlevine iletilebilir.
QueryOrderByConstraint QueryOrderByConstraint, Firestore sorgusu tarafından döndürülen doküman grubunu sıralamak için kullanılır. QueryOrderByConstraint öğeleri, orderBy() çağrısı yapılarak oluşturulur ve ardından bu QueryOrderByConstraint öğesini de içeren yeni bir sorgu örneği oluşturmak için query() öğesine iletilebilir.Not: OrderBy alanını içermeyen dokümanlar, sorgu sonucunda bulunmaz.
Sorgu Anlık Görüntüsü QuerySnapshot öğesi, sorgunun sonuçlarını temsil eden sıfır veya daha fazla DocumentSnapshot nesnesi içerir. Dokümanlara docs özelliği aracılığıyla dizi olarak erişilebilir veya forEach yöntemi kullanılarak numaralandırılabilir. Doküman sayısı, empty ve size özellikleri aracılığıyla belirlenebilir.
QueryStartAtConstraint (Sorgu Başlatma Kısıtlaması) QueryStartAtConstraint, belgelerin Firestore sorgusu tarafından döndürülen sonuç kümesinin başlangıcından hariç tutulması için kullanılır. QueryStartAtConstraint öğeleri, startAt() veya startAfter() çağrısı yapılarak oluşturulur ve ardından bu QueryStartAtConstraint öğesini de içeren yeni bir sorgu örneği oluşturmak için query() işlevine iletilebilir.
SnapshotMetadata Anlık görüntünün durumunu açıklayan, anlık görüntüyle ilgili meta veriler.
Zaman damgası Timestamp, herhangi bir saat diliminden veya takvimden bağımsız bir zamanı temsil eder. UTC Dönem saatine göre nanosaniye çözünürlüğünde saniye ve saniye cinsinden kesirlerle temsil edilir.Gregoryen takvimi geriye doğru ilk yıla uzatan Proleptik Miladi Takvimi kullanılarak kodlanır. Tüm dakikaların 60 saniye uzunluğunda olduğu, yani artık saniyelerin "lekelendiği" varsayılarak kodlanır. Böylece yorumlama için ikinci tabloya gerek kalmaz. Aralık 0001-01-01T00:00:00Z ile 9999-12-31T23:59:59.999999999Z arasındadır.Örnekler ve diğer özellikler için Zaman Damgası tanımına bakın.
İşlem Bir işleme referans.Bir işlemin updateFunction öğesine iletilen Transaction nesnesi, işlem bağlamında veri okuma ve yazma yöntemlerini sağlar. Bkz. runTransaction().
VektörDeğeri Firestore dokümanlarında bir vektör türünü gösterir. ile örnek oluşturun . Vektör Değeri
WriteBatch Tek bir atom birimi olarak birden fazla yazma işlemi gerçekleştirmek için kullanılan bir yazma grubu.WriteBatch() çağrısı yapılarak WriteBatch nesnesi alınabilir. Yazma grubuna yazma ekleme yöntemleri sunar. WriteBatch.commit() çağrılmadığı sürece yazmaların hiçbiri kaydedilmez (veya yerel olarak görünür).

Arayüzler

Arayüz Açıklama
AggregateSpec Toplama grubunu ve bunların takma adlarını belirtir.
DocumentChange DocumentChange, bir sorguyla eşleşen dokümanlarda yapılan bir değişikliği temsil eder. Bu dosya, etkilenen dokümanı ve gerçekleşen değişikliğin türünü içerir.
DocumentData Doküman verileri (setDoc() ile kullanım için), değerlerle eşlenen alanlardan oluşur.
DeneyselLongPollingOptions Uzun anket kullanılırken SDK'nın temel ağ aktarımını (WebChannel) yapılandıran seçenekler.Not: Bu arayüz "deneysel"dir ve değişiklik yapılabilir.Bkz. FirestoreSettings.experimentalAutoDetectLongPolling, FirestoreSettings.experimentalForceLongPolling ve FirestoreSettings.experimentalLongPollingOptions.
FirestoreDataConverter AppModelType türündeki kullanıcı nesnelerini DbModelType türündeki Firestore verilerine dönüştürmek için withConverter() tarafından kullanılan dönüştürücü.Dönüştürücünün kullanılması, Firestore'dan nesneleri depolayıp alırken genel tür bağımsız değişkenleri belirtmenize olanak tanır.Bu bağlamda, "AppModel" Bir uygulamada ilgili bilgileri ve işlevleri bir arada sunmak için kullanılan sınıftır. Bu tür bir sınıf, örneğin karmaşık, iç içe geçmiş veri türlerine, notlandırma için kullanılan özelliklere, Firestore tarafından desteklenmeyen türlerin özelliklerine (symbol ve bigint gibi) ve bileşik işlemler gerçekleştiren yardımcı işlevlere sahip olabilir. Bu tür sınıflar, bir Firestore veritabanında depolanmaya uygun değildir ve/veya mümkün değildir. Bunun yerine, bu tür sınıfların örneklerinin "düz eski JavaScript nesnelerine" dönüştürülmesi gerekir (POJO'lar) yalnızca temel özelliklere sahip, potansiyel olarak diğer POJO'ların veya POJO dizilerinin içine yerleştirilmiş olabilir. Bu bağlamda, bu tür "DbModel" olarak adlandırılır. ve Firestore'da kalmaya uygun bir nesne olacaktır. Kolaylık sağlaması açısından uygulamalar, FirestoreDataConverter öğesini uygulayabilir ve dönüştürücüyü DocumentReference veya Query gibi Firestore nesneleriyle kaydedebilir. Böylece, Firestore'da depolarken AppModel'i otomatik olarak DbModel'ye, Firestore'dan alırken ise DbModel'yi AppModel biçimine dönüştürür.
FirestoreAyarları Cloud Firestore örneğiniz için özel yapılandırmaları belirtir. Diğer yöntemleri çağırmadan önce bunları ayarlamanız gerekir.
Dizin (BETA) Firestore dizininin SDK tanımıdır.
Dizin Yapılandırması (BETA) Yerel sorgu yürütmeyi hızlandırmak için Firestore dizinlerinin listesi.Dizin tanımının biçiminin açıklaması için JSON Biçimi'ne bakın.
Dizin Alanı (BETA) Dizin yapılandırmasında tek bir alan öğesi.
LoadBundleTaskİlerleme Paketlerin yüklenmesinden gelen ilerleme durumunu veya son durumu temsil eder.
MemoryCacheSettings MemoryLocalCache örneğini yapılandırmak için kullanılan ayarlar nesnesi.
MemoryEagerGarbageCollector Bir çöp toplayıcı, herhangi bir etkin sorguya dahil olmayan ve ekli yerel mutasyonlara sahip olmayan dokümanları siler.Bu toplayıcı, belgelerin çevrimdışı sorgular için veya önbelleğe doğrudan sorgulanmama riskiyle karşı karşıya kaldığında SDK'dan en düşük bellek izlerini sağlamaya çalışır.Bu toplayıcının örneğini oluşturmak için fabrika işlevini kullanın.
MemoryLocalCache SDK'ya bellek içi önbellek sağlar. Bu, aksi açıkça yapılandırılmadığı sürece varsayılan önbellektir.Bunu kullanmak için fabrika işlevini kullanarak bir örnek oluşturun , ardından örneği FirestoreSettings.cache değerine ayarlayın ve ayarlar nesnesini kullanarak initializeFirestore yöntemini çağırın.
MemoryLruGarbageCollector Bir çöp toplayıcı, En Az Kullanılan dokümanları birden fazla grup halinde siler.Bu toplayıcı, hedef boyutla yapılandırılır ve yalnızca önbelleğe alınan dokümanlar hedef boyutu aştığında toplama gerçekleştirir. Bu yöntem sayesinde, aynı sorgu veya doküman için tekrarlanan arka ucun sorgulanması önlenir ve daha büyük bellek ayak izine sahip olma riski ortaya çıkar.Bu toplayıcının bir örneğini oluşturmak için fabrika işlevini kullanın.
PersistenceSettings Firestore kalıcılığını yapılandırmak için enableIndexedDbPersistence() ürününe iletilebilecek ayarlar.Kalıcılık, Node.js ortamında kullanılamaz.
PersistentCacheSettings PersistentLocalCache örneğini yapılandırmak için kullanılan ayarlar nesnesi.Kalıcı önbellek, Node.js ortamında kullanılamaz.
PersistentLocalCache SDK'ya IndexedDb tarafından desteklenen kalıcı bir önbellek sağlar.Kullanmak için fabrika işlevini kullanarak bir örnek oluşturun, ardından örneği FirestoreSettings.cache değerine ayarlayın ve ayarlar nesnesini kullanarak initializeFirestore yöntemini çağırın.
PersistentMultipleTabManager Birden çok sekmeyi destekleyen bir sekme yöneticisi. SDK, SDK'yı kullanarak tüm sekmelerde yapılan sorguları ve dönüşümleri senkronize eder.
PersistentSingleTabManager Yalnızca bir sekmeyi destekleyen bir sekme yöneticisi. Sekmeler arasında senkronizasyon yapılmaz.
PersistentSingleTabManagerSettings PersistentSingleTabManager örneği yapılandırmak için yazın.
SnapshotListenOptions Sonuç kümesine hangi değişiklik türlerinin dahil edileceğini kontrol etmek için onSnapshot() ve QuerySnapshot.docChanges()'e geçirilebilecek bir seçenekler nesnesi.
SnapshotOptions Verilerin bir DocumentSnapshot öğesinden nasıl alınacağını yapılandıran seçenekler (örneğin, henüz son değerlerine ayarlanmamış sunucu zaman damgaları için istenen davranış).
İşlem Seçenekleri İşlem davranışını özelleştirme seçenekleri.
E-posta listesinden çık onSnapshot() tarafından döndürülen ve çağrıldığında işleyiciyi kaldıran bir işlev.

Değişkenler

Değişken Açıklama
CACHE_SIZE_UNLIMITED LRU atık toplamayı belirtmek için kullanılan sabit değer devre dışı bırakılmalıdır. Bu değeri, Firestore örneğine iletilen ayarlarda cacheSizeBytes olarak belirleyin.

Tür Takma Adları

Takma Ad yazın Açıklama
PrefixToKeys Ekleme Her anahtarın önüne dış anahtarın bir nokta eklenerek eklendiği yeni bir harita döndürür.
AggregateFieldType Firestore tarafından desteklenen tüm AggregateField türlerinin birleşimi.
AggregateSpecData Anahtarları bir AggregateSpec öğesinden alınan ve değerleri, AggregateSpec girişinden karşılık gelen AggregateField tarafından gerçekleştirilen toplamanın sonucu olan bir tür.
AggregateType Gerçekleştirilecek toplama türünü temsil eden birleştirme türü.
ChildUpdateFields Belirli bir T1 türü için iç içe yerleştirilmiş alanları hesaplama yardımcısı. Bu, undefined | {...} (isteğe bağlı özellikler için geçerlidir) veya {a: A} | {b: B} gibi birlik türlerini dağıtmak için gereklidir.Bu kullanım durumunda, T[K] bir ifade olarak değerlendirildiğinden ve dağıtılmadığından Record üzerinde T[K] birlik türlerini dağıtmak için V kullanılır.https://www.typescriptlang.org/docs/handbook/advanced-types.html#distributive-conditional-types adresine bakın.
DocumentChangeType DocumentChange türü "eklendi", "kaldırıldı" veya "değiştirildi" olabilir.
FirestoreHata Kodu Firestore durum kodları grubu. Kodlar, burada gRPC tarafından sunulan kodlarla aynıdır: https://github.com/grpc/grpc/blob/master/doc/statuscodes.mdOlası değerler: - 'cancelled': İşlem iptal edildi (genellikle çağrı yapan tarafından). - 'unknown': Bilinmeyen hata veya farklı bir hata alanından gelen hata. - 'geçersiz-bağımsız değişken': İstemci, geçersiz bir bağımsız değişken belirtti. Bunun "başarısız ön koşul"dan farklı olduğunu unutmayın. "geçersiz-bağımsız-argüman" sistemin durumundan bağımsız olarak sorunlu olan bağımsız değişkenleri belirtir (ör. geçersiz alan adı). - "deadline-exceeded" (son tarih-aşıldı): İşlem tamamlanamadan son tarih geçti. Sistemin durumunu değiştiren işlemlerde, işlem başarıyla tamamlanmış olsa bile bu hata döndürülebilir. Örneğin, bir sunucudan gelen başarılı bir yanıt, son tarihin dolmasına yetecek kadar gecikmiş olabilir. - 'not-found': İstenen dokümanlardan bazıları bulunamadı. - "zaten var": Oluşturmaya çalıştığımız bazı dokümanlar zaten mevcut. - "izin reddedildi": Arayanın belirtilen işlemi yürütme izni yok. - "Kaynak tükendi": Bazı kaynaklar tükendi (ör. kullanıcı başına belirlenen kota). veya dosya sisteminin tamamında alan kalmamış olabilir. - "failed-precondition" (başarısız-ön koşul): Sistem, işlemin yürütülmesi için gereken durumda olmadığından işlem reddedildi. - "iptal edildi": İşlem, genellikle işlemin iptalleri gibi eşzamanlılık sorunu nedeniyle iptal edildi. - "aralık dışında": İşlem, geçerli aralığın dışına çıkmaya çalışıldı. - 'uygulanmadı': İşlem uygulanmadı veya desteklenmiyor/etkinleştirilmedi. - 'internal': Dahili hatalar. Temel sistem tarafından beklenen bazı sabit değerlerin bozulduğu anlamına gelir. Bu hatalardan birini görürseniz bir şeyler çok bozuk demektir. - 'kullanılamıyor': Hizmet şu anda kullanılamıyor. Bu durum büyük olasılıkla geçici bir durumdur ve geri alma işlemiyle tekrar deneyerek düzeltilebilir. - "veri kaybı": Kurtarılamayan veri kaybı veya bozulması. - 'unauthenticated': İsteğin, işlemle ilgili geçerli kimlik doğrulama kimlik bilgileri yok.
FirestoreLocalCache Desteklenen tüm SDK önbellek katmanındaki birleştirme türü.
ListenSource Sorgunun dinlediği kaynağı tanımlayın.Hem önbellek hem de sunucu değişikliklerini dinlemek için default olarak ayarlayın. Yalnızca önbellekteki değişiklikleri dinlemek için cache olarak ayarlayın.
MemoryGarbageCollector Tüm yerel önbellek için atık toplayıcıları destekleyen birleştirme türü.
NestedUpdateFields Her alan (ör. "bar") için iç içe yerleştirilmiş tüm anahtarları bulun (ör. {'bar.baz': T1, 'bar.qux': T2}). Hepsi isteğe bağlı olarak işaretlenmiş olası tüm anahtarları içeren tek bir harita oluşturmak için bunları kesiştirin.
OrderByDirection orderBy() yan tümcesinin yönü "desc" olarak belirtilir veya "artan" (azalan veya artan).
Kısmi Alan Değeriyle TypeScript'in Partial<T> işlevine benzer, ancak iç içe yerleştirilmiş alanların atlanmasına ve FieldValues'un özellik değerleri olarak aktarılmasına izin verir.
PersistentTabManager Mevcut tüm sekme yöneticilerinin birliği.
Temel Temel türler.
QueryConstraintType Bu SDK'da kullanılabilen farklı sorgu kısıtlamalarını açıklar.
Sorgu Filtresi Kısıtlaması QueryFilterConstraint, QueryFieldFilterConstraint ve QueryCompositeFilterConstraint'i temsil eden bir yardımcı birleştirme türüdür.
SorguNonFilterConstraint QueryNonFilterConstraint, doküman grubunu daraltmak veya sıralamak için kullanılan ancak belge alanında açık bir şekilde filtreleme yapmayan Sorgu Kısıtlamalarını temsil eden bir yardımcı birleştirme türüdür. QueryNonFilterConstraint öğeleri orderBy(), startAt(), startAfter(), endBefore(), endAt(), limit() veya limitToLast() çağrılmasıyla oluşturulur ve ardından yeni bir sorgu oluşturmak için query() örneğine iletilebilir.QueryConstraint
SetOptions setDoc() işlevinin ve çağrıların davranışını yapılandıran bir seçenekler nesnesi. Bu çağrılar, merge: true içeren bir SetOptions sağlanarak hedef dokümanların tamamının üzerine yazmak yerine ayrıntılı birleştirme işlemleri gerçekleştirecek şekilde yapılandırılabilir.
Görev Durumu Paket yükleme görevlerinin durumunu gösterir.Her ikisi de "Hata" ve "Başarı" batma durumu: Görev iptal edilir veya tamamlanır. Bunlar bildirildikten sonra başka güncelleme yapılmaz.
Kesişim Birliği Birleştirme türü U = T1 | T2 | ... verildiğinde kesişen (T1 & T2 & ...) türünü döndürür.Dağıtıcı koşul türlerini ve koşullu türlerden elde edilen çıkarımı kullanır. Bunun nedeni, zıt varyantlı konumlarda aynı tür değişken için birden fazla adayın bir kesişim türünün tahmin edilmesine neden olmasıdır. https://www.typescriptlang.org/docs/handbook/advanced-types.html#type-inference-in-conditional-types https://stackoverflow.com/questions/50374908/convert-union-type-to-intersection-type
Veri Güncelleme Değerlerle eşlenmiş alan yollarından (ör. "foo" veya "foo.baz") oluşan verileri (updateDoc() ile kullanım için) güncelleme. Nokta içeren alanlar, dokümandaki iç içe yerleştirilmiş alanlara referans verir. FieldValues, özellik değeri olarak aktarılabilir.
WhereFilterOp where() yan tümcesindeki filtreleme koşulları "&lt;", "&lt;=', '==', '!=', '&gt;=', '&gt;', 'array-contains', 'in', 'array-contains-any' ve "not-in" dizeleri kullanılarak belirtilir.
WithFieldValue Tür güvenliğini korurken FieldValue'ların özellik değeri olarak aktarılmasına olanak tanır.

function(uygulama; ...)

getFirestore(uygulama)

Sağlanan FirebaseApp ile ilişkilendirilmiş mevcut varsayılan Firestore örneğini döndürür. Herhangi bir örnek yoksa varsayılan ayarlarla yeni bir örnek başlatır.

İmza:

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

Parametreler

Parametre Tür Açıklama
uygulama FirebaseUygulaması Döndürülen Firestore örneğinin ilişkili olduğu FirebaseApp örneği.

Şunu döndürür:

Firestore

Sağlanan uygulamanın varsayılan Firestore örneği.

getFirestore(uygulama; veritabanı kimliği)

Bu API, geliştiriciler için önizleme olarak sunulmaktadır ve aldığımız geri bildirimlere göre değişebilir. Bu API'yi bir üretim ortamında kullanmayın.

Sağlanan FirebaseApp ile ilişkilendirilmiş mevcut adlandırılmış Firestore örneğini döndürür. Herhangi bir örnek yoksa varsayılan ayarlarla yeni bir örnek başlatır.

İmza:

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

Parametreler

Parametre Tür Açıklama
uygulama FirebaseUygulaması Döndürülen Firestore örneğinin ilişkili olduğu FirebaseApp örneği.
veritabanı kimliği dize Veritabanının adı.

Şunu döndürür:

Firestore

Sağlanan uygulamanın adlandırılmış Firestore örneği.

startizeFirestore(uygulama; ayarlar, veritabanı kimliği)

Sağlanan ayarlarla yeni bir Firestore örneğini başlatır. Yalnızca diğer herhangi bir işlevden önce çağrılabilir (getFirestore() dahil). Özel ayarlar boşsa bu işlev, getFirestore() çağrısına eşdeğerdir.

İmza:

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

Parametreler

Parametre Tür Açıklama
uygulama FirebaseUygulaması Firestore örneğinin ilişkilendirileceği FirebaseApp.
ayarlar FirestoreAyarları Firestore örneğini yapılandıracak bir ayarlar nesnesi.
veritabanı kimliği dize Veritabanının adı.

Şunu döndürür:

Firestore

Yeni başlatılmış bir Firestore örneği.

fonksiyon(firestore, ...)

clearIndexedDbPersistence(firestore)

Kalıcı depolama alanını temizler. Beklemedeki yazmalar ve önbelleğe alınan dokümanlar da buna dahildir.

Firestore örneği başlatılmadan çağrılmalıdır (uygulama sonlandırıldıktan sonra veya uygulama ilk kez başlatıldıktan sonra). Başlangıçta bu işlev, diğer işlevlerden (initializeFirestore() veya getFirestore() dışında) önce çağrılmalıdır. Firestore örneği hâlâ çalışıyorsa taahhüt reddedilir ve bu durumda failed-precondition hata kodu gösterilir.

İmza:

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

Parametreler

Parametre Tür Açıklama
firestore Firestore Kalıcılığı temizleyecek Firestore örneği.

Şunu döndürür:

Taahhüt<void>

Kalıcı depolama alanı temizlendiğinde çözümlenen bir Promise. Aksi takdirde, taahhüt bir hata mesajıyla reddedilir.

koleksiyon(firestore, yol, pathSegments)

Belirtilen mutlak yoldaki koleksiyonu ifade eden bir CollectionReference örneği alır.

İmza:

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

Parametreler

Parametre Tür Açıklama
firestore Firestore Kök Firestore örneğine referans.
yol dize Bir koleksiyonun eğik çizgiyle ayrılmış yolu.
yolSegmentleri dize[] İlk bağımsız değişkene göre uygulanacak ek yol segmentleri.

Şunu döndürür:

CollectionReference<DocumentData, DocumentData>

CollectionReference örneği.

İstisnalar

Son yolda çift sayıda segment varsa ve bir koleksiyona işaret etmiyorsa.

koleksiyonGrubu(firestore, collectionsId)

Veritabanında bulunan ve belirtilen collectionId değerine sahip bir koleksiyonda veya alt koleksiyonda yer alan tüm dokümanları içeren yeni bir Query örneği oluşturur ve döndürür.

İmza:

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

Parametreler

Parametre Tür Açıklama
firestore Firestore Kök Firestore örneğine referans.
koleksiyon kimliği dize Sorgulanacak koleksiyonları tanımlar. Yolun son segmenti olarak bu kimliğe sahip olan her koleksiyon veya alt koleksiyon dahil edilir. Eğik çizgi içeremez.

Şunu döndürür:

Sorgu<DocumentData, DocumentData>

Oluşturulan: Query.

connectFirestoreEmulator(firestore, ana makine, bağlantı noktası, seçenekler)

Cloud Firestore emülatörüyle iletişim kurmak için bu örneği değiştirin.

İmza:

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

Parametreler

Parametre Tür Açıklama
firestore Firestore Emülatöre bağlanmak için yapılandırılacak Firestore örneği.
düzenleyen dize emülatör ana makinesi (ör: localhost).
bağlantı noktası sayı emülatör bağlantı noktası (ör: 9000).
seçenekler { mockUserToken?: EmulatorMockTokenOptions | string; }

Şunu döndürür:

geçersiz

devre dışı bırakma(firestore)

Bu örnek için ağ kullanımını devre dışı bırakır. enableNetwork() aracılığıyla yeniden etkinleştirilebilir. Ağ devre dışıyken anlık görüntü dinleyicileri, getDoc() veya getDocs() çağrıları önbellekten sonuçlar döndürür ve tüm yazma işlemleri, ağ geri yüklenene kadar sıraya alınır.

İmza:

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

Parametreler

Parametre Tür Açıklama
firestore Firestore

Şunu döndürür:

Taahhüt<void>

Ağ devre dışı bırakıldığında çözülen bir Promise.

doc(firestore, path; pathSegments)

Belirtilen mutlak yoldaki belgeye işaret eden bir DocumentReference örneği alır.

İmza:

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

Parametreler

Parametre Tür Açıklama
firestore Firestore Kök Firestore örneğine referans.
yol dize Dokümanın eğik çizgiyle ayrılmış yolu.
yolSegmentleri dize[] İlk bağımsız değişkene göre uygulanacak ek yol segmentleri.

Şunu döndürür:

DocumentReference<DocumentData, DocumentData>

DocumentReference örneği.

İstisnalar

Son yolda tek sayıda segment varsa ve bir dokümana işaret etmiyorsa.

allowIndexedDbPersistence(firestore, kalıcılıkAyarlar)

Bu işlev gelecekteki bir ana sürümde kaldırılacaktır. Bunun yerine, IndexedDb önbelleğini etkinleştirmek için FirestoreSettings.localCache öğesini PersistentLocalCache örneği olarak ayarlayın. FirestoreSettings.localCache zaten belirtilmişken bu işlevin çağrılması bir istisna oluşturur.

Mümkünse kalıcı depolamayı etkinleştirmeye çalışır.

Başarısız olması durumunda enableIndexedDbPersistence(), sözü reddeder veya bir istisna yapar. Bunun başarısız olmasının birkaç nedeni vardır. Bu neden, hatadaki code tarafından tespit edilebilir.

* failed-precondition: Uygulama zaten başka bir tarayıcı sekmesinde açık durumda. * uygulanmadı: Tarayıcı, çevrimdışı kalıcılık uygulamasıyla uyumlu değil.

Hata sonrasında bile Firestore örneğinin kullanılabilir durumda kalacağını ancak çevrimdışı kalıcılığın devre dışı bırakılacağını unutmayın.

Kalıcılık, Node.js ortamında kullanılamaz.

İmza:

export declare function enableIndexedDbPersistence(firestore: Firestore, persistenceSettings?: PersistenceSettings): Promise<void>;

Parametreler

Parametre Tür Açıklama
firestore Firestore Kalıcılığın etkinleştirileceği Firestore örneği.
kalıcılıkAyarları PersistenceSettings Kalıcılığı yapılandırmak için isteğe bağlı ayarlar nesnesi.

Şunu döndürür:

Taahhüt<void>

Kalıcı depolama alanının başarıyla etkinleştirilmesini temsil eden bir Promise.

allowMultiTabIndexedDbPersistence(firestore)

Bu işlev gelecekteki bir ana sürümde kaldırılacaktır. Bunun yerine, dizine eklenen veritabanı önbelleğini açmak için FirestoreSettings.localCache öğesini PersistentLocalCache örneği olarak ayarlayın. FirestoreSettings.localCache zaten belirtilmişken bu işlevin çağrılması bir istisna oluşturur.

Mümkünse çok sekmeli kalıcı depolamayı etkinleştirmeye çalışır. Tüm sekmelerde etkinleştirilirse tüm işlemler, tüm bağlı örneklerde sorguların ortak yürütülmesi ve gecikmeyi telafi eden yerel belge güncellemeleri dahil olmak üzere yerel kalıcılığa erişimi paylaşır.

Başarısız olması durumunda enableMultiTabIndexedDbPersistence(), sözü reddeder veya bir istisna yapar. Bunun başarısız olmasının birkaç nedeni vardır. Bu neden, hatadaki code tarafından tespit edilebilir.

* başarısız ön koşul: Uygulama zaten başka bir tarayıcı sekmesinde açık ve çoklu sekme etkin değil. * uygulanmadı: Tarayıcı, çevrimdışı kalıcılık uygulamasıyla uyumlu değil.

Hata sonrasında bile Firestore örneğinin kullanılabilir durumda kalacağını ancak çevrimdışı kalıcılığın devre dışı bırakılacağını unutmayın.

İmza:

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

Parametreler

Parametre Tür Açıklama
firestore Firestore Kalıcılığın etkinleştirileceği Firestore örneği.

Şunu döndürür:

Taahhüt<void>

Kalıcı depolama alanının başarıyla etkinleştirilmesini temsil eden bir Promise.

EtkinleştirmeAğı(firestore)

Önceki bir disableNetwork() çağrısından sonra bu Firestore örneği için ağ kullanımını yeniden etkinleştirir.

İmza:

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

Parametreler

Parametre Tür Açıklama
firestore Firestore

Şunu döndürür:

Taahhüt<void>

Ağ etkinleştirildikten sonra çözülen bir Promise.

getPersistentCacheIndexManager(firestore)

Belirtilen Firestore nesnesi tarafından kullanılan PersistentCache Dizin Yöneticisi'ni döndürür.

PersistentCacheIndexManager örneği veya yerel kalıcı depolama alanı kullanılmıyorsa null.

İmza:

export declare function getPersistentCacheIndexManager(firestore: Firestore): PersistentCacheIndexManager | null;

Parametreler

Parametre Tür Açıklama
firestore Firestore

Şunu döndürür:

PersistentCacheIndexManager | boş

loadBundle(firestore; BundleData)

Yerel önbelleğe bir Firestore paketi yükler.

İmza:

export declare function loadBundle(firestore: Firestore, bundleData: ReadableStream<Uint8Array> | ArrayBuffer | string): LoadBundleTask;

Parametreler

Parametre Tür Açıklama
firestore Firestore Paketlerin yükleneceği Firestore örneği.
paketVerisi ReadableStream<Uint8Array> | ArrayBuffer | dize Yüklenecek paketi temsil eden bir nesne. Geçerli nesneler şunlardır: ArrayBuffer, ReadableStream<Uint8Array> veya string.

Şunu döndürür:

LoadBundleTask

Arayanlara ilerleme durumu güncellemelerini ve tamamlanma veya hata etkinliklerini bildiren bir LoadBundleTask nesnesi. Promise<LoadBundleTaskProgress> olarak kullanılabilir.

adlandırılmışSorgu(firestore; ad)

Belirtilen adla tanımlanan yerel önbellekten bir Firestore Sorgusu okur.

Adlandırılmış sorgular, sunucu tarafında paketler halinde paketlenir (sonuçlanan dokümanlarla birlikte) ve loadBundle kullanılarak yerel önbelleğe yüklenir. Yerel önbelleğe alındıktan sonra, bir Sorgu'yu ada göre ayıklamak için bu yöntemi kullanın.

İmza:

export declare function namedQuery(firestore: Firestore, name: string): Promise<Query | null>;

Parametreler

Parametre Tür Açıklama
firestore Firestore Sorgunun okunacağı Firestore örneği.
ad dize Sorgunun adı.

Şunu döndürür:

Söz<Sorgu | null>

Sorgu ile çözümlenen bir Promise veya null.

onSnapshotsInSync(firestore, gözlemci)

Senkronize edilen anlık görüntüler etkinliği için bir işleyici ekler. Sync-in-sync etkinliği, sunucu tarafından oluşturulan tek bir değişiklik birden çok işleyiciyi etkilese bile belirli bir değişiklikten etkilenen tüm işleyicilerin tetiklendiğini gösterir.

NOT: Sync-in-sync etkinliği, yalnızca işleyicilerin birbiriyle senkronize olduğunu gösterir, ancak bu anlık görüntülerin sunucuyla senkronize olup olmamasıyla ilgili değildir. Bir anlık görüntünün önbellekten mi yoksa sunucudan mı geldiğini belirlemek için tek tek dinleyicilerde SnapshotMetadata kullanın.

İmza:

export declare function onSnapshotsInSync(firestore: Firestore, observer: {
    next?: (value: void) => void;
    error?: (error: FirestoreError) => void;
    complete?: () => void;
}): Unsubscribe;

Parametreler

Parametre Tür Açıklama
firestore Firestore Anlık görüntüleri senkronize etmek için kullanılan Firestore örneği.
gözlemci { sonraki?: (değer: geçersiz) => geçersiz; hatası?: (hata: FirestoreError) => geçersiz; tamamlandı mı?: () => geçersiz; } next ve error geri çağırması içeren tek bir nesne.

Şunu döndürür:

E-posta listesinden çık

Anlık görüntü işleyiciyi iptal etmek için çağrılabilen bir abonelikten çıkma işlevi.

onSnapshotsInSync(firestore, onSync)

Senkronize edilen anlık görüntüler etkinliği için bir işleyici ekler. Sync-in-sync etkinliği, sunucu tarafından oluşturulan tek bir değişiklik birden çok işleyiciyi etkilese bile belirli bir değişiklikten etkilenen tüm işleyicilerin tetiklendiğini gösterir.

NOT: Sync-in-sync etkinliği, yalnızca işleyicilerin birbiriyle senkronize olduğunu gösterir, ancak bu anlık görüntülerin sunucuyla senkronize olup olmamasıyla ilgili değildir. Bir anlık görüntünün önbellekten mi yoksa sunucudan mı geldiğini belirlemek için bağımsız işleyicilerde SnapshotMetadata kullanın.

İmza:

export declare function onSnapshotsInSync(firestore: Firestore, onSync: () => void): Unsubscribe;

Parametreler

Parametre Tür Açıklama
firestore Firestore Anlık görüntüleri senkronize etmek için kullanılan Firestore örneği.
onSync () => geçersiz Tüm anlık görüntü dinleyicileri birbiriyle her senkronize olduğunda çağrılacak bir geri çağırma.

Şunu döndürür:

E-posta listesinden çık

Anlık görüntü işleyiciyi iptal etmek için çağrılabilen bir abonelikten çıkma işlevi.

runTransaction(firestore, updateFunction, seçenekler)

Belirtilen updateFunction işlemini yürütür ve ardından işlemde uygulanan değişiklikleri uygulamaya çalışır. İşlem kapsamında okunan herhangi bir belge değiştiyse Cloud Firestore, updateFunction yöntemini yeniden dener. 5 denemeden sonra başarısız olursa işlem başarısız olur.

Tek bir işlemde izin verilen maksimum yazma sayısı 500'dür.

İmza:

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

Parametreler

Parametre Tür Açıklama
firestore Firestore Bu işlemin çalıştırılacağı Firestore veritabanına referans.
güncelleme işlevi (işlem: İşlem) => Söz<T> İşlem bağlamında yürütülecek işlev.
seçenekler İşlem Seçenekleri Maksimum kaydetme deneme sayısını yapılandıran bir seçenekler nesnesi.

Şunu döndürür:

Söz<T>

İşlem başarıyla tamamlanırsa veya açıkça iptal edilirse (updateFunction, başarısız bir söz verdiyse) updateFunction tarafından verilen taahhüt buraya döndürülür. Aksi takdirde, işlem başarısız olursa reddedilmiş bir taahhüt ve karşılık gelen hata hatası döndürülür.

setIndexConfiguration(firestore; yapılandırma)

Bu API, geliştiriciler için önizleme olarak sunulmaktadır ve aldığımız geri bildirimlere göre değişebilir. Bu API'yi bir üretim ortamında kullanmayın.

ziyaret edin.

Önbellek dizinlerini manuel olarak oluşturmak yerine, yerel olarak çalıştırılan sorgular için önbellek dizinleri oluşturup oluşturmama konusunda SDK'nın karar vermesine izin vermek amacıyla enablePersistentCacheIndexAutoCreation() kullanabilirsiniz.

Yerel sorgu yürütme için dizine eklemeyi yapılandırır. Önceki tüm dizin yapılandırmaları geçersiz kılınır. Dizin yapılandırması devam ettirildikten sonra Promise çözülür.

Dizin girişleri eşzamansız olarak oluşturulur. Dizinler henüz kullanılamıyor olsa bile dizine ekleme gerektiren sorguları kullanmaya devam edebilirsiniz. Sorgu yürütme, dizin girişleri yazıldıktan sonra otomatik olarak dizini kullanmaya başlar.

Dizinler yalnızca IndexedDb kalıcılığıyla desteklenir. IndexedDb etkin değilse dizin yapılandırması yok sayılır.

İmza:

export declare function setIndexConfiguration(firestore: Firestore, configuration: IndexConfiguration): Promise<void>;

Parametreler

Parametre Tür Açıklama
firestore Firestore Dizinlerin yapılandırılacağı Firestore örneği.
yapılandırma Dizin Yapılandırması Dizin tanımı.

Şunu döndürür:

Taahhüt<void>

Tüm dizinler başarıyla yapılandırıldıktan sonra çözümlenen bir Promise.

İstisnalar

JSON biçimi geçersizse FirestoreError.

setIndexConfiguration(firestore, json)

Bu API, geliştiriciler için önizleme olarak sunulmaktadır ve aldığımız geri bildirimlere göre değişebilir. Bu API'yi bir üretim ortamında kullanmayın.

ziyaret edin.

Önbellek dizinlerini manuel olarak oluşturmak yerine, yerel olarak çalıştırılan sorgular için önbellek dizinleri oluşturup oluşturmama konusunda SDK'nın karar vermesine izin vermek amacıyla enablePersistentCacheIndexAutoCreation() kullanabilirsiniz.

Yerel sorgu yürütme için dizine eklemeyi yapılandırır. Önceki tüm dizin yapılandırmaları geçersiz kılınır. Dizin yapılandırması devam ettirildikten sonra Promise çözülür.

Dizin girişleri eşzamansız olarak oluşturulur. Dizinler henüz kullanılamıyor olsa bile dizine ekleme gerektiren sorguları kullanmaya devam edebilirsiniz. Sorgu yürütme, dizin girişleri yazıldıktan sonra otomatik olarak dizini kullanmaya başlar.

Dizinler yalnızca IndexedDb kalıcılığıyla desteklenir. Dizin yapılandırmasını ayarlamadan önce enableIndexedDbPersistence() veya enableMultiTabIndexedDbPersistence() çağırın. IndexedDb etkin değilse dizin yapılandırması yok sayılır.

Yöntem, Firebase CLI (firebase firestore:indexes) tarafından dışa aktarılan JSON biçimini kabul eder. JSON biçimi geçersizse bu yöntem hata verir.

İmza:

export declare function setIndexConfiguration(firestore: Firestore, json: string): Promise<void>;

Parametreler

Parametre Tür Açıklama
firestore Firestore Dizinlerin yapılandırılacağı Firestore örneği.
json dize Firebase CLI tarafından dışa aktarılan JSON biçimi.

Şunu döndürür:

Taahhüt<void>

Tüm dizinler başarıyla yapılandırıldıktan sonra çözümlenen bir Promise.

İstisnalar

JSON biçimi geçersizse FirestoreError.

sonlandır(firestore)

Sağlanan Firestore örneğini sonlandırır.

terminate() çağrıldıktan sonra yalnızca clearIndexedDbPersistence() işlevi kullanılabilir. Diğer herhangi bir işlev FirestoreError gönderir.

Sonlandırmadan sonra yeniden başlatmak için getFirestore() ile yeni bir FirebaseFirestore örneği oluşturun.

Fesih işlemi, beklemedeki yazma işlemlerini iptal etmez ve sunucudan yanıt bekleyen taahhütler çözümlenmez. Kalıcılığı etkinleştirdiyseniz bu örneği bir sonraki başlatmanızda sunucu bu yazma işlemlerini sunucuya göndermeye devam eder.

İmza:

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

Parametreler

Parametre Tür Açıklama
firestore Firestore

Şunu döndürür:

Taahhüt<void>

Örnek başarıyla sonlandırıldığında çözülen bir Promise.

WaitForPendingWrites(firestore)

Etkin kullanıcı için bekleyen tüm yazmalar arka uç tarafından onaylanana kadar bekler.

Bekleyen yazma işlemi yoksa döndürülen taahhüt hemen çözümlenir. Aksi takdirde, taahhüt önceden verilmiş tüm yazmaları (önceki uygulama oturumunda yazılanlar da dahil) bekler, ancak işlev çağrıldıktan sonra eklenen yazmaları beklemez. Yazma işleminin daha fazla olmasını beklemek istiyorsanız waitForPendingWrites() yöntemini tekrar çağırın.

Bekleyen tüm waitForPendingWrites() taahhütleri kullanıcı değişiklikleri sırasında reddedilir.

İmza:

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

Parametreler

Parametre Tür Açıklama
firestore Firestore

Şunu döndürür:

Taahhüt<void>

Şu anda beklemede olan tüm yazmalar arka uç tarafından onaylandığında çözümlenen bir Promise.

WriteBatch(firestore)

Tek bir atomik işlem olarak birden fazla yazma işlemi gerçekleştirmek için kullanılan bir yazma grubu oluşturur. Tek bir WriteBatch içinde izin verilen maksimum yazma sayısı 500'dür.

İşlemlerden farklı olarak yazma grupları çevrimdışı olarak saklanır. Bu nedenle, yazmalarınızı okunan verilerde koşullandırmanız gerekmediğinde tercih edilir.

İmza:

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

Parametreler

Parametre Tür Açıklama
firestore Firestore

Şunu döndürür:

WriteBatch

Birden fazla yazma işlemini otomatik olarak yürütmek için kullanılabilen bir WriteBatch.

fonksiyon()

count()

Sorgunun sonuç kümesindeki belge sayısını hesaplamak için kullanılabilecek bir AggregateField nesnesi oluşturun.

İmza:

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

Şunu döndürür:

AggregateField<sayı>

deleteField()

Bir alanı silinmek üzere işaretlemek için updateDoc() veya setDoc() ile kullanılacak {merge: true} ile birlikte kullanılacak bir sentinel döndürür.

İmza:

export declare function deleteField(): FieldValue;

Şunu döndürür:

Alan Değeri

dokümanKimliği()

Bir dokümanın kimliğine başvuruda bulunmak için özel bir koruyucu FieldPath döndürür. Sorgularda doküman kimliğine göre sıralama veya filtreleme yapmak için kullanılabilir.

İmza:

export declare function documentId(): FieldPath;

Şunu döndürür:

FieldPath

getFirestore()

Varsayılan FirebaseApp ile ilişkili mevcut varsayılan Firestore örneğini döndürür. Herhangi bir örnek yoksa varsayılan ayarlarla yeni bir örnek başlatır.

İmza:

export declare function getFirestore(): Firestore;

Şunu döndürür:

Firestore

Varsayılan uygulamanın varsayılan Firestore örneği.

bellekEagerGarbageCollector()

MemoryEagerGarbageCollector öğesinin bir örneğini oluşturur. Bu, aksi belirtilmedikçe varsayılan atık toplayıcıdır.

İmza:

export declare function memoryEagerGarbageCollector(): MemoryEagerGarbageCollector;

Şunu döndürür:

MemoryEagerGarbageCollector

KalıcıMultipleTabManager()

PersistentMultipleTabManager öğesinin bir örneğini oluşturur.

İmza:

export declare function persistentMultipleTabManager(): PersistentMultipleTabManager;

Şunu döndürür:

PersistentMultipleTabManager

sunucuZaman Damgası()

Yazılı verilere sunucu tarafından oluşturulan bir zaman damgası eklemek için setDoc() veya updateDoc() ile kullanılan bir sentinel döndürür.

İmza:

export declare function serverTimestamp(): FieldValue;

Şunu döndürür:

Alan Değeri

function(veritabanıId; ...)

getFirestore(veritabanıKimliği)

Bu API, geliştiriciler için önizleme olarak sunulmaktadır ve aldığımız geri bildirimlere göre değişebilir. Bu API'yi bir üretim ortamında kullanmayın.

Varsayılan FirebaseApp ile ilişkilendirilmiş mevcut adlandırılmış Firestore örneğini döndürür. Herhangi bir örnek yoksa varsayılan ayarlarla yeni bir örnek başlatır.

İmza:

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

Parametreler

Parametre Tür Açıklama
veritabanı kimliği dize Veritabanının adı.

Şunu döndürür:

Firestore

Varsayılan uygulamanın adlandırılmış Firestore örneği.

function(öğeler; ...)

stringRemove(öğeler)

setDoc() ile kullanılabilecek veya sunucuya, belirtilen öğeleri sunucuda zaten bulunan herhangi bir dizi değerinden kaldırmasını bildiren özel değeri döndürür. Belirtilen her bir öğenin tüm örnekleri diziden kaldırılır. Değiştirilen alan halihazırda bir dizi değilse boş bir diziyle bu alanın üzerine yazılır.

İmza:

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

Parametreler

Parametre Tür Açıklama
öğeler bilinmiyor[] Diziden kaldırılacak öğeler.

Şunu döndürür:

Alan Değeri

setDoc() veya updateDoc() numaralı telefona yapılan bir çağrıda kullanılacak FieldValue koruyucu

diziUnion(öğeler)

setDoc() veya updateDoc() ile kullanılabilecek özel değeri döndürür. Bu değer, sunucuya belirtilen öğeleri sunucuda zaten mevcut olan herhangi bir dizi değeriyle birleştirmesini bildirir. Dizide mevcut olmayan belirtilen her bir öğe sona eklenir. Değiştirilen alan halihazırda bir dizi değilse, tam olarak belirtilen öğeleri içeren bir dizi bu alanın üzerine yazılır.

İmza:

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

Parametreler

Parametre Tür Açıklama
öğeler bilinmiyor[] Dizide birleştirilecek öğeler.

Şunu döndürür:

Alan Değeri

setDoc() veya updateDoc() numaralı telefona yapılan bir çağrıda kullanılacak FieldValue koruyucu.

fonksiyon(alan; ...)

ortalama(alan)

Sorgunun sonuç grubundaki bir dizi belge üzerinde belirtilen bir alanın ortalamasını hesaplamak için kullanılabilecek bir AggregateField nesnesi oluşturun.

İmza:

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

Parametreler

Parametre Tür Açıklama
alan dize | FieldPath Sonuç kümesi genelinde ortalaması alınacak alanı belirtir.

Şunu döndürür:

AggregateField<sayı | null>

sum(alan)

Sorgunun sonuç kümesindeki bir dizi belge üzerinde belirtilen bir alanın toplamını hesaplamak için kullanılabilecek bir AggregateField nesnesi oluşturun.

İmza:

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

Parametreler

Parametre Tür Açıklama
alan dize | FieldPath Sonuç kümesinde toplanacak alanı belirtir.

Şunu döndürür:

AggregateField<sayı>

function(fieldPath; ...)

orderBy(fieldPath;DirectionStr)

Sorgu sonucunu belirtilen alana göre ve isteğe bağlı olarak artan yerine azalan düzende sıralayan bir QueryOrdersByConstraint oluşturur.

İmza:

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

Parametreler

Parametre Tür Açıklama
FieldPath dize | FieldPath Sıralama ölçütü olarak kullanılacak alan.
yönStr OrderByDirection Sıralama ölçütü olarak kullanılacak isteğe bağlı yön ("artan" veya "azalan"). Belirtilmezse sıra artan düzende olacaktır.

Şunu döndürür:

QueryOrderByConstraint

Oluşturulan Query OrderByConstraint.

nerede(fieldPath; opStr; değer)

Belgelerin belirtilen alanı içermesi ve değerin sağlanan ilişki kısıtlamasını karşılaması gerektiğini zorunlu kılan bir QueryFieldFilterConstraint oluşturur.

İmza:

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

Parametreler

Parametre Tür Açıklama
FieldPath dize | FieldPath Karşılaştırma yolu
opStr WhereFilterOp İşlem dizesi (ör. "&lt;", "&lt;=", "==", "&lt;", "&lt;=", "!=").
value bilinmiyor Karşılaştırma değeri

Şunu döndürür:

QueryFieldFilterConstraint

Oluşturulan QueryFieldFilterConstraint.

function(fieldValues; ...)

endAt(fieldValues)

Sonuç kümesini, sorgunun sırasına göre sağlanan alanlarda sona erecek şekilde değiştiren bir QueryEndAtConstraint oluşturur. Alan değerlerinin sırası, sorgudaki ifadelere göre sıralamayla aynı olmalıdır.

İmza:

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

Parametreler

Parametre Tür Açıklama
alanDeğerleri bilinmiyor[] Sorgunun sıralama ölçütüne göre, bu sorgunun sona ereceği alan değerleri.

Şunu döndürür:

SorguBitişAkısıtlaması

query() öğesine iletilecek bir QueryEndAtConstraint

endBefore(fieldValues)

Sonuç kümesini, sorgunun sırasına göre sağlanan alanlardan önce sona erecek şekilde değiştiren bir QueryEndAtConstraint oluşturur. Alan değerlerinin sırası, sorgudaki ifadelere göre sıralamayla aynı olmalıdır.

İmza:

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

Parametreler

Parametre Tür Açıklama
alanDeğerleri bilinmiyor[] Sorgunun sıralama ölçütüne göre, bu sorguyu daha önce sonlandıracak alan değerleri.

Şunu döndürür:

SorguBitişAkısıtlaması

query() öğesine iletilecek bir QueryEndAtConstraint

startAfter(fieldValues)

Sonuç kümesini, sorgunun sırasına göre sağlanan alanlardan sonra başlayacak şekilde değiştiren bir QueryStartAtConstraint oluşturur. Alan değerlerinin sırası, sorgudaki ifadelere göre sıralamayla aynı olmalıdır.

İmza:

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

Parametreler

Parametre Tür Açıklama
alanDeğerleri bilinmiyor[] Sorgunun sıralama ölçütüne göre, sonra bu sorgunun başlatılacağı alan değerleri.

Şunu döndürür:

QueryStartAtConstraint (Sorgu Başlatma Kısıtlaması)

query() öğesine iletilecek QueryStartAtConstraint öğesi

startAt(fieldValues)

Sonuç kümesini sorgunun sırasına göre sağlanan alanlarda başlayacak şekilde değiştiren bir QueryStartAtConstraint oluşturur. Alan değerlerinin sırası, sorgudaki ifadelere göre sıralamayla aynı olmalıdır.

İmza:

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

Parametreler

Parametre Tür Açıklama
alanDeğerleri bilinmiyor[] Sorgunun sıralama ölçütüne göre, bu sorgunun başlatılacağı alan değerleri.

Şunu döndürür:

QueryStartAtConstraint (Sorgu Başlatma Kısıtlaması)

query() öğesine iletilecek bir QueryStartAtConstraint.

function(indexManager; ...)

deleteAllPersistentCacheIndexes(indexManager)

Tüm kalıcı önbellek dizinlerini kaldırır.

Bu işlevin, desteği sonlandırılan setIndexConfiguration() tarafından oluşturulan dizinleri de sileceğini lütfen unutmayın.

İmza:

export declare function deleteAllPersistentCacheIndexes(indexManager: PersistentCacheIndexManager): void;

Parametreler

Parametre Tür Açıklama
dizin Yöneticisi PersistentCacheIndexManager

Şunu döndürür:

geçersiz

devre dışı bırakma PersistentCacheIndexAutoCreation(indexManager)

Yerel sorgu yürütme için kalıcı önbellek dizinlerini otomatik olarak oluşturmayı durdurur. enablePersistentCacheIndexAutoCreation() çağrısı yapılarak oluşturulan dizinler geçerli olmaya devam eder.

İmza:

export declare function disablePersistentCacheIndexAutoCreation(indexManager: PersistentCacheIndexManager): void;

Parametreler

Parametre Tür Açıklama
dizin Yöneticisi PersistentCacheIndexManager

Şunu döndürür:

geçersiz

allowPersistentCacheIndexAutoCreation(indexManager)

SDK, önbellek dizinlerinin performansı iyileştirmeye yardımcı olabileceğini düşünüyorsa SDK'nın yerel sorgu yürütme için otomatik olarak kalıcı önbellek dizinleri oluşturmasını sağlar.

Bu özellik varsayılan olarak devre dışıdır.

İmza:

export declare function enablePersistentCacheIndexAutoCreation(indexManager: PersistentCacheIndexManager): void;

Parametreler

Parametre Tür Açıklama
dizin Yöneticisi PersistentCacheIndexManager

Şunu döndürür:

geçersiz

işlev(sol; ...)

totalFieldEqual(sol; sağ)

Eşitlik için iki "AggregateField" örneğini karşılaştırır.

İmza:

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

Parametreler

Parametre Tür Açıklama
sol AggregateField<unknown> Bu AggregateField ile right karşılaştırmasını yapın.
sağ AggregateField<unknown> Bu AggregateField ile left karşılaştırmasını yapın.

Şunu döndürür:

boolean

totalQuerySnapshotEqual(sol, sağ)

Eşitlik için iki AggregateQuerySnapshot örneğini karşılaştırır.

İki AggregateQuerySnapshot örneği "eşit" olarak kabul edilir ve aynı verileri karşılaştıran temel sorguları olup olmadığını gösterir.

İmza:

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

Parametreler

Parametre Tür Açıklama
sol AggregateQuerySnapshot<AggregateSpecType, AppModelType, DbModelType> Karşılaştırılacak ilk AggregateQuerySnapshot.
sağ AggregateQuerySnapshot<AggregateSpecType, AppModelType, DbModelType> Karşılaştırılacak ikinci AggregateQuerySnapshot.

Şunu döndürür:

boolean

Nesneler yukarıda tanımlandığı gibi "eşit"se true, aksi takdirde false.

queryEqual(sol; sağ)

Sağlanan sorgular aynı koleksiyonu işaret ederse ve aynı kısıtlamaları uygularsa true değerini döndürür.

İmza:

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

Parametreler

Parametre Tür Açıklama
sol Sorgu<AppModelType, DbModelType> Karşılaştırmak için Query.
sağ Sorgu<AppModelType, DbModelType> Karşılaştırmak için Query.

Şunu döndürür:

boolean

Referanslar aynı Firestore veritabanında aynı konumu işaret ediyorsa true

refEqual(sol; sağ)

Sağlanan referanslar eşitse true değerini döndürür.

İmza:

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

Parametreler

Parametre Tür Açıklama
sol DocumentReference<AppModelType, DbModelType> | CollectionReference<AppModelType, DbModelType> Karşılaştırılacak bir referans.
sağ DocumentReference<AppModelType, DbModelType> | CollectionReference<AppModelType, DbModelType> Karşılaştırılacak bir referans.

Şunu döndürür:

boolean

Referanslar aynı Firestore veritabanında aynı konumu işaret ediyorsa true

SnapshotEqual(sol, sağ)

Sağlanan anlık görüntüler eşitse true değerini döndürür.

İmza:

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

Parametreler

Parametre Tür Açıklama
sol DocumentSnapshot<AppModelType, DbModelType> | QuerySnapshot<AppModelType, DbModelType> Karşılaştırılacak bir anlık görüntü.
sağ DocumentSnapshot<AppModelType, DbModelType> | QuerySnapshot<AppModelType, DbModelType> Karşılaştırılacak bir anlık görüntü.

Şunu döndürür:

boolean

anlık görüntüler eşitse true.

function(sınır; ...)

limit(limit)

Yalnızca ilk eşleşen dokümanları döndüren bir QueryLimitConstraint oluşturur.

İmza:

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

Parametreler

Parametre Tür Açıklama
sınır sayı Döndürülecek maksimum öğe sayısı.

Şunu döndürür:

QueryLimitConstraint

Oluşturulan QueryLimitConstraint.

limitToLast(sınır)

Yalnızca son eşleşen dokümanları döndüren bir QueryLimitConstraint oluşturur.

limitToLast sorguları için en az bir orderBy ifadesi belirtmeniz gerekir, aksi takdirde yürütme sırasında bir istisna oluşur.

İmza:

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

Parametreler

Parametre Tür Açıklama
sınır sayı Döndürülecek maksimum öğe sayısı.

Şunu döndürür:

QueryLimitConstraint

Oluşturulan QueryLimitConstraint.

function(logLevel; ...)

setLogLevel(logLevel)

Cloud Firestore günlüklerinin ayrıntısını ayarlar (hata ayıklama, hata veya sessiz).

İmza:

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

Parametreler

Parametre Tür Açıklama
logLevel LogLevel Etkinlik ve hata günlüğü için ayarladığınız ayrıntı düzeyi. Aşağıdaki değerlerden herhangi biri olabilir:
  • Temel olarak hata ayıklama amacıyla, en ayrıntılı günlük kaydı düzeyi için debug.
  • Yalnızca hataları günlüğe kaydetmek için error.
  • silent to turn off logging.

Şunu döndürür:

geçersiz

işlev(n; ...)

artış(n)

setDoc() veya updateDoc() ile kullanılabilecek özel değeri döndürür. Bu değer, sunucuya alanın geçerli değerini verilen değere göre artırmasını bildirir.

İşlenen veya geçerli alan değeri kayan nokta kesinliğini kullanıyorsa tüm aritmetikler IEEE 754 anlamını izler. Her iki değer de tam sayıysa JavaScript'in güvenli sayı aralığının (Number.MIN_SAFE_INTEGER - Number.MAX_SAFE_INTEGER) dışındaki değerler de kesinlik kaybına tabi olur. Ayrıca, Firestore arka ucu tarafından işlendikten sonra tüm tam sayı işlemleri -2^63 ile 2^63-1 arasında sınırlandırılır.

Geçerli alan değeri number türünde değilse veya alan henüz mevcut değilse dönüşüm işlemi, alanı verilen değere ayarlar.

İmza:

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

Parametreler

Parametre Tür Açıklama
n sayı Artımlılık değeri.

Şunu döndürür:

Alan Değeri

setDoc() veya updateDoc() numaralı telefona yapılan bir çağrıda kullanılacak FieldValue koruyucu

function(sorgu; ...)

getAggregateFromServer(sorgu, aggregateSpec)

Belgeleri indirmeden, belirtilen sorgunun sonuç kümesindeki dokümanlar üzerinden belirtilen toplamaları hesaplar.

Dokümanların değil yalnızca nihai toplama değerleri geçerli olduğundan, toplama işlemleri için bu işlevin kullanılması verimlidir. indirilerek oluşturulur. Bu işlev, sonuç kümesinin tamamen indirilemeyecek kadar büyük olduğu durumlarda (binlerce doküman) belgeleri toplama işlemini gerçekleştirebilir.

Sunucudan alınan sonuç, herhangi bir yerel durum dikkate alınmaksızın, değiştirilmeden sunulur. Diğer bir deyişle, yerel önbellekteki dokümanlar ve henüz sunucuyla senkronize edilmemiş yerel değişiklikler dikkate alınmaz. Daha önce indirilen sonuçlar (varsa) kullanılmaz. Bu işlevin her çağrılması zorunlu olarak sunucuya bir gidiş dönüşü içerir.

İmza:

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

Parametreler

Parametre Tür Açıklama
query Sorgu<AppModelType, DbModelType> Sonuç kümesi toplanan sorgu.
toplamÖzellikleri AggregateSpecType Sonuç kümesinde gerçekleştirilecek toplamaları belirten AggregateSpec nesnesi. AggregateSpec, toplu sonucu almak üzere kullanılabilecek her bir toplama işlemi için takma adlar belirtir.

Şunu döndürür:

Promise<AggregateQuerySnapshot<AggregateSpecType, AppModelType, DbModelType>>

Örnek

const aggregateSnapshot = await getAggregateFromServer(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;

getCountFromServer(sorgu)

Belirli bir sorgunun sonuç kümesindeki dokümanların sayısını, dokümanları indirmeden hesaplar.

Dokümanları saymak için bu işlevi kullanmak verimlidir çünkü dokümanların sayımında değil, indirilerek yüklenir. Bu işlev, sonuç kümesinin tamamen indirilemeyecek kadar büyük olduğu durumlarda dokümanları da sayabilir (binlerce doküman).

Sunucudan alınan sonuç, herhangi bir yerel durum dikkate alınmaksızın, değiştirilmeden sunulur. Diğer bir deyişle, yerel önbellekteki dokümanlar ve henüz sunucuyla senkronize edilmemiş yerel değişiklikler dikkate alınmaz. Daha önce indirilen sonuçlar (varsa) kullanılmaz. Bu işlevin her çağrılması zorunlu olarak sunucuya bir gidiş dönüşü içerir.

İmza:

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

Parametreler

Parametre Tür Açıklama
query Sorgu<AppModelType, DbModelType> Sonuç kümesi boyutu hesaplanan sorgu.

Şunu döndürür:

Promise<AggregateQuerySnapshot<{ count: AggregateField<number>; }, AppModelType, DbModelType>>

Sayıyla birlikte sonuçlanacak bir Taahhüt; Sayı, snapshot.data().count konumundan alınabilir. Burada snapshot, döndürülen Vaat'in çözdüğü AggregateQuerySnapshot değeridir.

getDokümanlar(sorgu)

Sorguyu yürütür ve sonuçları bir QuerySnapshot olarak döndürür.

İmza:

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

Parametreler

Parametre Tür Açıklama
query Sorgu<AppModelType, DbModelType>

Şunu döndürür:

Promise<QuerySnapshot<AppModelType, DbModelType>>

Sorgunun sonuçlarıyla çözümlenecek Promise.

getDokümanlarFromCache(sorgu)

Sorguyu yürütür ve sonuçları önbellekten bir QuerySnapshot olarak döndürür. Sorguyla eşleşen hiçbir doküman önbelleğe alınmışsa boş bir sonuç kümesi döndürür.

İmza:

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

Parametreler

Parametre Tür Açıklama
query Sorgu<AppModelType, DbModelType>

Şunu döndürür:

Promise<QuerySnapshot<AppModelType, DbModelType>>

Sorgunun sonuçlarıyla çözümlenecek Promise.

getDokümanlarFromServer(sorgu)

Sorguyu yürütür ve sonuçları sunucudan bir QuerySnapshot olarak döndürür. Ağ mevcut değilse bir hata döndürür.

İmza:

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

Parametreler

Parametre Tür Açıklama
query Sorgu<AppModelType, DbModelType>

Şunu döndürür:

Promise<QuerySnapshot<AppModelType, DbModelType>>

Sorgunun sonuçlarıyla çözümlenecek Promise.

onSnapshot(sorgu; gözlemleyici)

QuerySnapshot etkinlikleri için bir işleyici ekler. Tek tek onNext ve onError geri çağırmalarını iletebilir veya next ve error geri çağırmalarıyla tek bir gözlemci nesnesini iletebilirsiniz. İşleyici, onSnapshot çağrıldığında döndürülen işlev çağrılarak iptal edilebilir.

NOT: onCompletion geri çağırması yapılabilse de anlık görüntü akışı hiç bitmeyen bir işlem olduğundan çağrı asla çağrılmaz.

İmza:

export declare function onSnapshot<AppModelType, DbModelType extends DocumentData>(query: Query<AppModelType, DbModelType>, observer: {
    next?: (snapshot: QuerySnapshot<AppModelType, DbModelType>) => void;
    error?: (error: FirestoreError) => void;
    complete?: () => void;
}): Unsubscribe;

Parametreler

Parametre Tür Açıklama
query Sorgu<AppModelType, DbModelType> Dinlenecek sorgu.
gözlemci { sonraki?: (anlık görüntü: QuerySnapshot<AppModelType, DbModelType>) => geçersiz; hatası?: (hata: FirestoreError) => geçersiz; tamamlandı mı?: () => geçersiz; } next ve error geri çağırması içeren tek bir nesne.

Şunu döndürür:

E-posta listesinden çık

Anlık görüntü işleyiciyi iptal etmek için çağrılabilen bir abonelikten çıkma işlevi.

onSnapshot(sorgu; seçenekler; gözlemci)

QuerySnapshot etkinlikleri için bir işleyici ekler. Tek tek onNext ve onError geri çağırmalarını iletebilir veya next ve error geri çağırmalarıyla tek bir gözlemci nesnesini iletebilirsiniz. İşleyici, onSnapshot çağrıldığında döndürülen işlev çağrılarak iptal edilebilir.

NOT: onCompletion geri çağırması yapılabilse de anlık görüntü akışı hiç bitmeyen bir işlem olduğundan çağrı asla çağrılmaz.

İmza:

export declare function onSnapshot<AppModelType, DbModelType extends DocumentData>(query: Query<AppModelType, DbModelType>, options: SnapshotListenOptions, observer: {
    next?: (snapshot: QuerySnapshot<AppModelType, DbModelType>) => void;
    error?: (error: FirestoreError) => void;
    complete?: () => void;
}): Unsubscribe;

Parametreler

Parametre Tür Açıklama
query Sorgu<AppModelType, DbModelType> Dinlenecek sorgu.
seçenekler SnapshotListenOptions Dinleme davranışını kontrol eden seçenekler.
gözlemci { sonraki?: (anlık görüntü: QuerySnapshot<AppModelType, DbModelType>) => geçersiz; hatası?: (hata: FirestoreError) => geçersiz; tamamlandı mı?: () => geçersiz; } next ve error geri çağırması içeren tek bir nesne.

Şunu döndürür:

E-posta listesinden çık

Anlık görüntü işleyiciyi iptal etmek için çağrılabilen bir abonelikten çıkma işlevi.

onSnapshot(sorgu; onNext; onError; onComplete)

QuerySnapshot etkinlikleri için bir işleyici ekler. Tek tek onNext ve onError geri çağırmalarını iletebilir veya next ve error geri çağırmalarıyla tek bir gözlemci nesnesini iletebilirsiniz. İşleyici, onSnapshot çağrıldığında döndürülen işlev çağrılarak iptal edilebilir.

NOT: onCompletion geri çağırması yapılabilse de anlık görüntü akışı hiç bitmeyen bir işlem olduğundan çağrı asla çağrılmaz.

İmza:

export declare function onSnapshot<AppModelType, DbModelType extends DocumentData>(query: Query<AppModelType, DbModelType>, onNext: (snapshot: QuerySnapshot<AppModelType, DbModelType>) => void, onError?: (error: FirestoreError) => void, onCompletion?: () => void): Unsubscribe;

Parametreler

Parametre Tür Açıklama
query Sorgu<AppModelType, DbModelType> Dinlenecek sorgu.
sonraki (anlık görüntü: QuerySnapshot<AppModelType, DbModelType>) => geçersiz Yeni bir QuerySnapshot hazır olduğunda geri aranmak için bir geri arama.
onError (hata: FirestoreError) => geçersiz Dinleme başarısız olursa veya iptal edilirse çağrılacak bir geri çağırma. Başka geri çağırma yapılmaz.
onTamamlanma () => geçersiz Sağlanabilir ancak akışlar hiçbir zaman sona ermediğinden çağrı yapılmaz.

Şunu döndürür:

E-posta listesinden çık

Anlık görüntü işleyiciyi iptal etmek için çağrılabilen bir abonelikten çıkma işlevi.

onSnapshot(sorgu; seçenekler; onNext; onError; onComplete)

QuerySnapshot etkinlikleri için bir işleyici ekler. Tek tek onNext ve onError geri çağırmalarını iletebilir veya next ve error geri çağırmalarıyla tek bir gözlemci nesnesini iletebilirsiniz. İşleyici, onSnapshot çağrıldığında döndürülen işlev çağrılarak iptal edilebilir.

NOT: onCompletion geri çağırması yapılabilse de anlık görüntü akışı hiç bitmeyen bir işlem olduğundan çağrı asla çağrılmaz.

İmza:

export declare function onSnapshot<AppModelType, DbModelType extends DocumentData>(query: Query<AppModelType, DbModelType>, options: SnapshotListenOptions, onNext: (snapshot: QuerySnapshot<AppModelType, DbModelType>) => void, onError?: (error: FirestoreError) => void, onCompletion?: () => void): Unsubscribe;

Parametreler

Parametre Tür Açıklama
query Sorgu<AppModelType, DbModelType> Dinlenecek sorgu.
seçenekler SnapshotListenOptions Dinleme davranışını kontrol eden seçenekler.
sonraki (anlık görüntü: QuerySnapshot<AppModelType, DbModelType>) => geçersiz Yeni bir QuerySnapshot hazır olduğunda geri aranmak için bir geri arama.
onError (hata: FirestoreError) => geçersiz Dinleme başarısız olursa veya iptal edilirse çağrılacak bir geri çağırma. Başka geri çağırma yapılmaz.
onTamamlanma () => geçersiz Sağlanabilir ancak akışlar hiçbir zaman sona ermediğinden çağrı yapılmaz.

Şunu döndürür:

E-posta listesinden çık

Anlık görüntü işleyiciyi iptal etmek için çağrılabilen bir abonelikten çıkma işlevi.

sorgu(sorgu; bileşen Filtresi; queryConstraints)

Ek sorgu kısıtlamaları içerecek şekilde genişletilen yeni bir sabit Query örneğini oluşturur.

İmza:

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

Parametreler

Parametre Tür Açıklama
query Sorgu<AppModelType, DbModelType> Yeni kısıtlamalar için temel olarak kullanılacak Query örneği.
birleşik Filtre QueryCompositeFilterConstraint Uygulanacak QueryCompositeFilterConstraint değeri. and() veya or() kullanarak QueryCompositeFilterConstraint oluşturun.
sorguKısıtlamaları QueryNonFilterConstraint[] Uygulanacak ek QueryNonFilterConstraint öğeleri (ör. orderBy(), limit()).

Şunu döndürür:

Sorgu<AppModelType, DbModelType>

İstisnalar

değerini girin.

sorgu(sorgu; queryConstraints)

Ek sorgu kısıtlamaları içerecek şekilde genişletilen yeni bir sabit Query örneğini oluşturur.

İmza:

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

Parametreler

Parametre Tür Açıklama
query Sorgu<AppModelType, DbModelType> Yeni kısıtlamalar için temel olarak kullanılacak Query örneği.
sorguKısıtlamaları SorguKısıtlaması[] Uygulanacak QueryConstraint listesi.

Şunu döndürür:

Sorgu<AppModelType, DbModelType>

İstisnalar

değerini girin.

function(queryConstraints, ...)

and(queryConstraints)

Belirtilen filtre kısıtlamalarının bir birleşimi olan yeni bir QueryCompositeFilterConstraint oluşturur. Bağlaç filtreleri, belirtilen tüm filtreleri karşılıyorsa dokümanı içerir.

İmza:

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

Parametreler

Parametre Tür Açıklama
sorguKısıtlamaları QueryFilterConstraint[] İsteğe bağlı. Bağlama işlemi uygulanacak QueryFilterConstraint listesi. Bunlar, where(), or() veya and() çağrılarıyla oluşturulmalıdır.

Şunu döndürür:

QueryCompositeFilterConstraint

Yeni oluşturulan QueryCompositeFilterConstraint.

veya(queryConstraints)

Belirtilen filtre kısıtlamalarının ayırması olan yeni bir QueryCompositeFilterConstraint oluşturur. Ayırma filtreleri, belirtilen filtrelerden herhangi birine uyan dokümanı içerir.

İmza:

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

Parametreler

Parametre Tür Açıklama
sorguKısıtlamaları QueryFilterConstraint[] İsteğe bağlı. Ayırma işlemi gerçekleştirilecek QueryFilterConstraint listesi. Bunlar, where(), or() veya and() çağrılarıyla oluşturulmalıdır.

Şunu döndürür:

QueryCompositeFilterConstraint

Yeni oluşturulan QueryCompositeFilterConstraint.

fonksiyon(başvuru; ...)

addDoc(başvuru; veriler)

Belirtilen CollectionReference için belirtilen verilerle yeni bir doküman ekleyin ve bu dokümana otomatik olarak doküman kimliği atayın.

İmza:

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

Parametreler

Parametre Tür Açıklama
referans CollectionReference<AppModelType, DbModelType> Bu dokümanın ekleneceği koleksiyon için referans.
veri WithFieldValue<AppModelType> Yeni dokümana ait verileri içeren bir Nesne.

Şunu döndürür:

Promise<DocumentReference<AppModelType, DbModelType>>

Promise, arka uca yazıldıktan sonra yeni oluşturulan dokümanı işaret eden DocumentReference ile çözüldü (Çevrimdışı olduğunuzda çözümlenmeyeceğini unutmayın).

koleksiyon(referans, yol, yolSegmentleri)

Belirtilen göreli yoldaki bir reference alt koleksiyonuna referans veren CollectionReference örneğini alır.

İmza:

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

Parametreler

Parametre Tür Açıklama
referans CollectionReference<AppModelType, DbModelType> Bir koleksiyona referans.
yol dize Bir koleksiyonun eğik çizgiyle ayrılmış yolu.
yolSegmentleri dize[] İlk bağımsız değişkene göre uygulanacak ek yol segmentleri.

Şunu döndürür:

CollectionReference<DocumentData, DocumentData>

CollectionReference örneği.

İstisnalar

Son yolda çift sayıda segment varsa ve bir koleksiyona işaret etmiyorsa.

koleksiyon(referans, yol, yolSegmentleri)

Belirtilen göreli yoldaki bir reference alt koleksiyonuna referans veren CollectionReference örneğini alır.

İmza:

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

Parametreler

Parametre Tür Açıklama
referans DocumentReference<AppModelType, DbModelType> Bir Firestore belgesine referans.
yol dize Bir koleksiyonun eğik çizgiyle ayrılmış yolu.
yolSegmentleri dize[] İlk bağımsız değişkene göre uygulanacak ek yol segmentleri.

Şunu döndürür:

CollectionReference<DocumentData, DocumentData>

CollectionReference örneği.

İstisnalar

Son yolda çift sayıda segment varsa ve bir koleksiyona işaret etmiyorsa.

deleteDoc(başvuru)

Belirtilen DocumentReference tarafından atıfta bulunulan dokümanı siler.

İmza:

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

Parametreler

Parametre Tür Açıklama
referans DocumentReference<AppModelType, DbModelType> Silinecek dokümana referans.

Şunu döndürür:

Taahhüt<void>

Doküman arka uçtan başarıyla silindikten sonra bir Vaat çözümlendi (çevrimdışı olduğunuzda çözümlenmeyeceğini unutmayın).

doc(başvuru; yol; yolSegmentleri)

Belirtilen göreli yolda reference içindeki bir dokümana referans veren DocumentReference örneğini alır. Herhangi bir yol belirtilmezse döndürülen DocumentReference için otomatik olarak oluşturulmuş benzersiz bir kimlik kullanılır.

İmza:

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

Parametreler

Parametre Tür Açıklama
referans CollectionReference<AppModelType, DbModelType> Bir koleksiyona referans.
yol dize Dokümanın eğik çizgiyle ayrılmış yolu. Otomatik oluşturulan kimlikleri kullanmak için atlanması gerekir.
yolSegmentleri dize[] İlk bağımsız değişkene göre uygulanacak ek yol segmentleri.

Şunu döndürür:

DocumentReference<AppModelType, DbModelType>

DocumentReference örneği.

İstisnalar

Son yolda tek sayıda segment varsa ve bir dokümana işaret etmiyorsa.

doc(başvuru; yol; yolSegmentleri)

Belirtilen göreli yolda reference içindeki bir dokümana referans veren DocumentReference örneğini alır.

İmza:

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

Parametreler

Parametre Tür Açıklama
referans DocumentReference<AppModelType, DbModelType> Bir Firestore belgesine referans.
yol dize Dokümanın eğik çizgiyle ayrılmış yolu.
yolSegmentleri dize[] İlk bağımsız değişkene göre uygulanacak ek yol segmentleri.

Şunu döndürür:

DocumentReference<DocumentData, DocumentData>

DocumentReference örneği.

İstisnalar

Son yolda tek sayıda segment varsa ve bir dokümana işaret etmiyorsa.

getDoc(başvuru)

Bu DocumentReference tarafından atıfta bulunulan dokümanı okur.

İmza:

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

Parametreler

Parametre Tür Açıklama
referans DocumentReference<AppModelType, DbModelType> Getirilecek dokümanın referansı.

Şunu döndürür:

Promise<DocumentSnapshot<AppModelType, DbModelType>>

Bir söz, mevcut doküman içeriğini içeren bir DocumentSnapshot ile çözümlendi.

getDocFromCache(referans)

Bu DocumentReference tarafından başvuruda bulunulan dokümanı önbellekten okur. Doküman şu anda önbelleğe alınmış değilse bir hata döndürür.

İmza:

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

Parametreler

Parametre Tür Açıklama
referans DocumentReference<AppModelType, DbModelType>

Şunu döndürür:

Promise<DocumentSnapshot<AppModelType, DbModelType>>

Promise, mevcut doküman içeriğini içeren bir DocumentSnapshot ile çözümlendi.

getDocFromServer(başvuru)

Bu DocumentReference tarafından başvuruda bulunulan dokümanı sunucudan okur. Ağ mevcut değilse bir hata döndürür.

İmza:

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

Parametreler

Parametre Tür Açıklama
referans DocumentReference<AppModelType, DbModelType>

Şunu döndürür:

Promise<DocumentSnapshot<AppModelType, DbModelType>>

Promise, mevcut doküman içeriğini içeren bir DocumentSnapshot ile çözümlendi.

onSnapshot(başvuru; gözlemci)

DocumentSnapshot etkinlikleri için bir işleyici ekler. Tek tek onNext ve onError geri çağırmalarını iletebilir veya next ve error geri çağırmalarıyla tek bir gözlemci nesnesini iletebilirsiniz.

NOT: onCompletion geri çağırması yapılabilse de anlık görüntü akışı hiç bitmeyen bir işlem olduğundan çağrı asla çağrılmaz.

İmza:

export declare function onSnapshot<AppModelType, DbModelType extends DocumentData>(reference: DocumentReference<AppModelType, DbModelType>, observer: {
    next?: (snapshot: DocumentSnapshot<AppModelType, DbModelType>) => void;
    error?: (error: FirestoreError) => void;
    complete?: () => void;
}): Unsubscribe;

Parametreler

Parametre Tür Açıklama
referans DocumentReference<AppModelType, DbModelType> Dinlenecek doküman için bir referans.
gözlemci { sonraki?: (anlık görüntü: DocumentSnapshot<AppModelType, DbModelType>) => geçersiz; hatası?: (hata: FirestoreError) => geçersiz; tamamlandı mı?: () => geçersiz; } next ve error geri çağırması içeren tek bir nesne.

Şunu döndürür:

E-posta listesinden çık

Anlık görüntü işleyiciyi iptal etmek için çağrılabilen bir abonelikten çıkma işlevi.

onSnapshot(başvuru; seçenekler; gözlemci)

DocumentSnapshot etkinlikleri için bir işleyici ekler. Tek tek onNext ve onError geri çağırmalarını iletebilir veya next ve error geri çağırmalarıyla tek bir gözlemci nesnesini iletebilirsiniz.

NOT: onCompletion geri çağırması yapılabilse de anlık görüntü akışı hiç bitmeyen bir işlem olduğundan çağrı asla çağrılmaz.

İmza:

export declare function onSnapshot<AppModelType, DbModelType extends DocumentData>(reference: DocumentReference<AppModelType, DbModelType>, options: SnapshotListenOptions, observer: {
    next?: (snapshot: DocumentSnapshot<AppModelType, DbModelType>) => void;
    error?: (error: FirestoreError) => void;
    complete?: () => void;
}): Unsubscribe;

Parametreler

Parametre Tür Açıklama
referans DocumentReference<AppModelType, DbModelType> Dinlenecek doküman için bir referans.
seçenekler SnapshotListenOptions Dinleme davranışını kontrol eden seçenekler.
gözlemci { sonraki?: (anlık görüntü: DocumentSnapshot<AppModelType, DbModelType>) => geçersiz; hatası?: (hata: FirestoreError) => geçersiz; tamamlandı mı?: () => geçersiz; } next ve error geri çağırması içeren tek bir nesne.

Şunu döndürür:

E-posta listesinden çık

Anlık görüntü işleyiciyi iptal etmek için çağrılabilen bir abonelikten çıkma işlevi.

onSnapshot(referans, onNext, onError; onComplete)

DocumentSnapshot etkinlikleri için bir işleyici ekler. Tek tek onNext ve onError geri çağırmalarını iletebilir veya next ve error geri çağırmalarıyla tek bir gözlemci nesnesini iletebilirsiniz.

NOT: onCompletion geri çağırması yapılabilse de anlık görüntü akışı hiç bitmeyen bir işlem olduğundan çağrı asla çağrılmaz.

İmza:

export declare function onSnapshot<AppModelType, DbModelType extends DocumentData>(reference: DocumentReference<AppModelType, DbModelType>, onNext: (snapshot: DocumentSnapshot<AppModelType, DbModelType>) => void, onError?: (error: FirestoreError) => void, onCompletion?: () => void): Unsubscribe;

Parametreler

Parametre Tür Açıklama
referans DocumentReference<AppModelType, DbModelType> Dinlenecek doküman için bir referans.
sonraki (anlık görüntü: DocumentSnapshot<AppModelType, DbModelType>) => geçersiz Yeni bir DocumentSnapshot hazır olduğunda geri aranmak için bir geri arama.
onError (hata: FirestoreError) => geçersiz Dinleme başarısız olursa veya iptal edilirse çağrılacak bir geri çağırma. Başka geri çağırma yapılmaz.
onTamamlanma () => geçersiz Sağlanabilir ancak akışlar hiçbir zaman sona ermediğinden çağrı yapılmaz.

Şunu döndürür:

E-posta listesinden çık

Anlık görüntü işleyiciyi iptal etmek için çağrılabilen bir abonelikten çıkma işlevi.

onSnapshot(referans; seçenekler, onNext, onError; onComplete)

DocumentSnapshot etkinlikleri için bir işleyici ekler. Tek tek onNext ve onError geri çağırmalarını iletebilir veya next ve error geri çağırmalarıyla tek bir gözlemci nesnesini iletebilirsiniz.

NOT: onCompletion geri çağırması yapılabilse de anlık görüntü akışı hiç bitmeyen bir işlem olduğundan çağrı asla çağrılmaz.

İmza:

export declare function onSnapshot<AppModelType, DbModelType extends DocumentData>(reference: DocumentReference<AppModelType, DbModelType>, options: SnapshotListenOptions, onNext: (snapshot: DocumentSnapshot<AppModelType, DbModelType>) => void, onError?: (error: FirestoreError) => void, onCompletion?: () => void): Unsubscribe;

Parametreler

Parametre Tür Açıklama
referans DocumentReference<AppModelType, DbModelType> Dinlenecek doküman için bir referans.
seçenekler SnapshotListenOptions Dinleme davranışını kontrol eden seçenekler.
sonraki (anlık görüntü: DocumentSnapshot<AppModelType, DbModelType>) => geçersiz Yeni bir DocumentSnapshot hazır olduğunda geri aranmak için bir geri arama.
onError (hata: FirestoreError) => geçersiz Dinleme başarısız olursa veya iptal edilirse çağrılacak bir geri çağırma. Başka geri çağırma yapılmaz.
onTamamlanma () => geçersiz Sağlanabilir ancak akışlar hiçbir zaman sona ermediğinden çağrı yapılmaz.

Şunu döndürür:

E-posta listesinden çık

Anlık görüntü işleyiciyi iptal etmek için çağrılabilen bir abonelikten çıkma işlevi.

setDoc(başvuru; veri)

Bu DocumentReference tarafından atıfta bulunulan belgeye yazar. Doküman henüz yoksa oluşturulur.

İmza:

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

Parametreler

Parametre Tür Açıklama
referans DocumentReference<AppModelType, DbModelType> Yazılacak belge için bir referans.
veri WithFieldValue<AppModelType> Dokümandaki alanların ve değerlerin haritası.

Şunu döndürür:

Taahhüt<void>

Veriler arka uca başarıyla yazıldıktan sonra Promise sorunu çözüldü (çevrimdışı olduğunuzda çözümlenmeyeceğini unutmayın).

setDoc(başvuru; veriler; seçenekler)

Belirtilen DocumentReference tarafından atıfta bulunulan belgeye yazar. Doküman henüz yoksa oluşturulur. merge veya mergeFields sağlarsanız, sağlanan veriler mevcut bir belgede birleştirilebilir.

İmza:

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

Parametreler

Parametre Tür Açıklama
referans DocumentReference<AppModelType, DbModelType> Yazılacak belge için bir referans.
veri partWithFieldValue<AppModelType> Dokümandaki alanların ve değerlerin haritası.
seçenekler SetOptions Belirlenen davranışı yapılandıracak bir nesne.

Şunu döndürür:

Taahhüt<void>

Veriler arka uca başarıyla yazıldıktan sonra Vaat çözümlendi (çevrimdışı olduğunuzda çözümlenmeyeceğini unutmayın).

updateDoc(başvuru; veri)

Dokümanda, belirtilen DocumentReference tarafından belirtilen alanları günceller. Mevcut olmayan bir dokümana uygulanırsa güncelleme başarısız olur.

İmza:

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

Parametreler

Parametre Tür Açıklama
referans DocumentReference<AppModelType, DbModelType> Güncellenecek dokümana referans.
veri UpdateData<DbModelType> Dokümanın güncelleneceği alanları ve değerleri içeren bir nesne. Alanlar, doküman içindeki iç içe yerleştirilmiş alanlara referans vermek için noktalar içerebilir.

Şunu döndürür:

Taahhüt<void>

Veriler arka uca başarıyla yazıldıktan sonra Promise sorunu çözüldü (çevrimdışı olduğunuzda çözümlenmeyeceğini unutmayın).

updateDoc(başvuru; alan; değer; moreFieldsAndValues)

Belirtilen DocumentReference tarafından atıfta bulunulan dokümandaki güncelleme alanları , mevcut olmayan bir dokümana uygulanırsa güncelleme başarısız olur.

İç içe geçmiş alanlar, noktayla ayrılmış alan yolu dizeleri veya FieldPath nesneleri sağlanarak güncellenebilir.

İmza:

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

Parametreler

Parametre Tür Açıklama
referans DocumentReference<AppModelType, DbModelType> Güncellenecek dokümana referans.
alan dize | FieldPath Güncellenecek ilk alan.
value bilinmiyor İlk değer.
diğerAlanlarVeDeğerler bilinmiyor[] Ek anahtar/değer çiftleri.

Şunu döndürür:

Taahhüt<void>

Veriler arka uca başarıyla yazıldıktan sonra Promise sorunu çözüldü (çevrimdışı olduğunuzda çözümlenmeyeceğini unutmayın).

function(ayarlar; ...)

bellekLocalCache(ayarlar)

MemoryLocalCache öğesinin bir örneğini oluşturur. Örnek, SDK'ya hangi önbellek katmanının kullanılacağını bildirmek için FirestoreSettings.cache olarak ayarlanabilir.

İmza:

export declare function memoryLocalCache(settings?: MemoryCacheSettings): MemoryLocalCache;

Parametreler

Parametre Tür Açıklama
ayarlar MemoryCacheSettings

Şunu döndürür:

MemoryLocalCache

bellekLruGarbageCollector(ayarlar)

MemoryLruGarbageCollector öğesinin bir örneğini oluşturur.

Hedef boyutu, ayar parametresinin parçası olarak belirtilebilir. Önbellek boyutu belirtilen boyutu aştığında toplayıcı, dokümanları silmeye başlar. Varsayılan önbellek boyutu 40 MB'tır (40 * 1024 * 1024 bayt).

İmza:

export declare function memoryLruGarbageCollector(settings?: {
    cacheSizeBytes?: number;
}): MemoryLruGarbageCollector;

Parametreler

Parametre Tür Açıklama
ayarlar { cacheSizeBytes?: number; }

Şunu döndürür:

MemoryLruGarbageCollector

periyodikLocalCache(ayarlar)

PersistentLocalCache öğesinin bir örneğini oluşturur. Örnek, SDK'ya hangi önbellek katmanının kullanılacağını bildirmek için FirestoreSettings.cache olarak ayarlanabilir.

Kalıcı önbellek, Node.js ortamında kullanılamaz.

İmza:

export declare function persistentLocalCache(settings?: PersistentCacheSettings): PersistentLocalCache;

Parametreler

Parametre Tür Açıklama
ayarlar PersistentCacheSettings

Şunu döndürür:

PersistentLocalCache

kalıcıTekSekmeManager(ayarlar)

PersistentSingleTabManager öğesinin bir örneğini oluşturur.

İmza:

export declare function persistentSingleTabManager(settings: PersistentSingleTabManagerSettings | undefined): PersistentSingleTabManager;

Parametreler

Parametre Tür Açıklama
ayarlar PersistentSingleTabManagerSettings | tanımsız Oluşturulan sekme yöneticisini yapılandırır.

Şunu döndürür:

PersistentSingleTabManager

Functions(anlık görüntü; ...)

endAt(anlık görüntü)

Sonuç grubunu, sağlanan belgede (dahil) sona erecek şekilde değiştiren bir QueryEndAtConstraint oluşturur. Bitiş konumu, sorgunun sırasına göre değişir. Belge, sorgunun OrderBy bölümünde sağlanan tüm alanları içermelidir.

İmza:

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

Parametreler

Parametre Tür Açıklama
anlık görüntü DocumentSnapshot<AppModelType, DbModelType> Dokümanın bitecek anlık görüntüsü.

Şunu döndürür:

SorguBitişAkısıtlaması

query() öğesine iletilecek bir QueryEndAtConstraint

endBefore(anlık görüntü)

Sonuç grubunu, sağlanan dokümandan (hariç) önce bitecek şekilde değiştiren bir QueryEndAtConstraint oluşturur. Bitiş konumu, sorgunun sırasına göre değişir. Belge, sorgunun OrderBy bölümünde sağlanan tüm alanları içermelidir.

İmza:

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

Parametreler

Parametre Tür Açıklama
anlık görüntü DocumentSnapshot<AppModelType, DbModelType> Öncesinde bitecek olan dokümanın anlık görüntüsü.

Şunu döndürür:

SorguBitişAkısıtlaması

query() öğesine iletilecek bir QueryEndAtConstraint

startAfter(anlık görüntü)

Sonuç grubunu, sağlanan dokümandan (hariç) sonra başlayacak şekilde değiştiren bir QueryStartAtConstraint oluşturur. Başlangıç konumu, sorgunun sırasına göre değişir. Belge, sorgunun OrderBy bölümünde sağlanan tüm alanları içermelidir.

İmza:

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

Parametreler

Parametre Tür Açıklama
anlık görüntü DocumentSnapshot<AppModelType, DbModelType> Dokümanın sonra başlayacak olan anlık görüntüsü.

Şunu döndürür:

QueryStartAtConstraint (Sorgu Başlatma Kısıtlaması)

query() öğesine iletilecek QueryStartAtConstraint öğesi

startAt(anlık görüntü)

Sonuç grubunu, sağlanan belgede (dahil) başlayacak şekilde değiştiren bir QueryStartAtConstraint oluşturur. Başlangıç konumu, sorgunun sırasına göre değişir. Belge, bu sorgunun orderBy bölümünde sağlanan tüm alanları içermelidir.

İmza:

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

Parametreler

Parametre Tür Açıklama
anlık görüntü DocumentSnapshot<AppModelType, DbModelType> Başlangıç için dokümanın anlık görüntüsü.

Şunu döndürür:

QueryStartAtConstraint (Sorgu Başlatma Kısıtlaması)

query() öğesine iletilecek bir QueryStartAtConstraint.

function(değerler; ...)

vektör(değerler)

Belirtilen sayı dizisinin bir kopyasıyla oluşturulan yeni bir VectorValue oluşturur.

İmza:

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

Parametreler

Parametre Tür Açıklama
values numara[] Bu sayı dizisinin bir kopyasıyla bir VectorValue örneği oluşturun.

Şunu döndürür:

VektörDeğeri

Belirtilen sayı dizisinin bir kopyasıyla oluşturulan yeni bir VectorValue.

SINIRSIZ BOYUTLU_BOYUT

LRU atık toplamayı belirtmek için kullanılan sabit değer devre dışı bırakılmalıdır. Bu değeri, Firestore örneğine iletilen ayarlarda cacheSizeBytes olarak belirleyin.

İmza:

CACHE_SIZE_UNLIMITED = -1

Anahtarlara Önek Ekle

Her anahtarın önüne dış anahtarın bir nokta eklenerek eklendiği yeni bir harita döndürür.

İmza:

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];
};

AggregateFieldType

Firestore tarafından desteklenen tüm AggregateField türlerinin birleşimi.

İmza:

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

AggregateSpecData verileri

Anahtarları bir AggregateSpec öğesinden alınan ve değerleri, AggregateSpec girişinden karşılık gelen AggregateField tarafından gerçekleştirilen toplamanın sonucu olan bir tür.

İmza:

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

Toplama Türü

Gerçekleştirilecek toplama türünü temsil eden birleştirme türü.

İmza:

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

ChildUpdateFields

Belirli bir T1 türü için iç içe yerleştirilmiş alanları hesaplama yardımcısı. Bu, undefined | {...} (isteğe bağlı öğeler için geçerlidir) veya {a: A} | {b: B} gibi birlik türlerini dağıtmak için gereklidir.

Bu kullanım örneğinde, T[K] bir ifade olarak değerlendirildiği ve dağıtılmadığından, Record üzerinde T[K] birleşik türlerini dağıtmak için V kullanılır.

https://www.typescriptlang.org/docs/handbook/advanced-types.html#distributive-conditional-types adresine göz atın.

İmza:

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

Doküman Değişiklik Türü

DocumentChange türü "eklendi", "kaldırıldı" veya "değiştirildi" olabilir.

İmza:

export declare type DocumentChangeType = 'added' | 'removed' | 'modified';

Firestore Hata Kodu

Firestore durum kodları grubu. Kodlar, gRPC tarafından sunulan kodlarda aynıdır: https://github.com/grpc/grpc/blob/master/doc/statuscodes.md

Olası değerler: - 'cancelled': İşlem iptal edildi (genellikle çağrı yapan tarafından). - 'unknown': Bilinmeyen hata veya farklı bir hata alanından gelen hata. - 'geçersiz-bağımsız değişken': İstemci, geçersiz bir bağımsız değişken belirtti. Bunun "başarısız ön koşul"dan farklı olduğunu unutmayın. "geçersiz-bağımsız-argüman" sistemin durumundan bağımsız olarak sorunlu olan bağımsız değişkenleri belirtir (ör. geçersiz alan adı). - "deadline-exceeded" (son tarih-aşıldı): İşlem tamamlanamadan son tarih geçti. Sistemin durumunu değiştiren işlemlerde, işlem başarıyla tamamlanmış olsa bile bu hata döndürülebilir. Örneğin, bir sunucudan gelen başarılı bir yanıt, son tarihin dolmasına yetecek kadar gecikmiş olabilir. - 'not-found': İstenen dokümanlardan bazıları bulunamadı. - "zaten var": Oluşturmaya çalıştığımız bazı dokümanlar zaten mevcut. - "izin reddedildi": Arayanın belirtilen işlemi yürütme izni yok. - "Kaynak tükendi": Bazı kaynaklar tükendi (ör. kullanıcı başına belirlenen kota). veya dosya sisteminin tamamında alan kalmamış olabilir. - "failed-precondition" (başarısız-ön koşul): Sistem, işlemin yürütülmesi için gereken durumda olmadığından işlem reddedildi. - "iptal edildi": İşlem, genellikle işlemin iptalleri gibi eşzamanlılık sorunu nedeniyle iptal edildi. - "aralık dışında": İşlem, geçerli aralığın dışına çıkmaya çalışıldı. - 'uygulanmadı': İşlem uygulanmadı veya desteklenmiyor/etkinleştirilmedi. - 'internal': Dahili hatalar. Temel sistem tarafından beklenen bazı sabit değerlerin bozulduğu anlamına gelir. Bu hatalardan birini görürseniz bir şeyler çok bozuk demektir. - 'kullanılamıyor': Hizmet şu anda kullanılamıyor. Bu durum büyük olasılıkla geçici bir durumdur ve geri alma işlemiyle tekrar deneyerek düzeltilebilir. - "veri kaybı": Kurtarılamayan veri kaybı veya bozulması. - 'unauthenticated': İsteğin, işlemle ilgili geçerli kimlik doğrulama kimlik bilgileri yok.

İmza:

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';

FirestoreLocalCache

Desteklenen tüm SDK önbellek katmanındaki birleştirme türü.

İmza:

export declare type FirestoreLocalCache = MemoryLocalCache | PersistentLocalCache;

ListenKaynağı

Sorgunun dinlediği kaynağı açıklayın.

Önbellek ve sunucu değişikliklerini dinlemek için default olarak ayarlayın. Yalnızca önbellekteki değişiklikleri dinlemek için cache olarak ayarlayın.

İmza:

export declare type ListenSource = 'default' | 'cache';

BellekGarbageToplayıcı

Tüm yerel önbellek için atık toplayıcıları destekleyen birleştirme türü.

İmza:

export declare type MemoryGarbageCollector = MemoryEagerGarbageCollector | MemoryLruGarbageCollector;

İç içe geçmişUpdateFields

Her alan (ör. "bar") için iç içe yerleştirilmiş tüm anahtarları bulun (ör. {'bar.baz': T1, 'bar.qux': T2}). Hepsi isteğe bağlı olarak işaretlenmiş olası tüm anahtarları içeren tek bir harita oluşturmak için bunları kesiştirin.

İmza:

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

Yöne Göre Sırala

orderBy() yan tümcesinin yönü "desc" olarak belirtilir veya "artan" (azalan veya artan).

İmza:

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

Alan Değeriyle Kısmi

TypeScript'in Partial<T> işlevine benzer, ancak iç içe yerleştirilmiş alanların atlanmasına ve FieldValues'un özellik değerleri olarak aktarılmasına izin verir.

İmza:

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

PersistentTabManager

Mevcut tüm sekme yöneticilerinin birliği.

İmza:

export declare type PersistentTabManager = PersistentSingleTabManager | PersistentMultipleTabManager;

Temel

Temel türler.

İmza:

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

Sorgu SınırlamasıTürü

Bu SDK'da kullanılabilen farklı sorgu kısıtlamalarını açıklar.

İmza:

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

Sorgu Filtresi Kısıtlaması

QueryFilterConstraint, QueryFieldFilterConstraint ve QueryCompositeFilterConstraint'i temsil eden bir yardımcı birleştirme türüdür.

İmza:

export declare type QueryFilterConstraint = QueryFieldFilterConstraint | QueryCompositeFilterConstraint;

FiltreNonFiltre Kısıtlaması

QueryNonFilterConstraint, doküman grubunu daraltmak veya sıralamak için kullanılan ancak belge alanında açık bir şekilde filtreleme yapmayan Sorgu Kısıtlamalarını temsil eden bir yardımcı birleştirme türüdür. QueryNonFilterConstraint'ler orderBy(), startAt(), startAfter(), endBefore(), endAt(), limit() veya limitToLast() çağrılmasıyla oluşturulur ve ardından yeni sorgu oluşturmak için query() query() örneğine iletilebilir.QueryConstraint

İmza:

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

Ayar Seçenekleri

setDoc() işlevinin ve çağrıların davranışını yapılandıran bir seçenekler nesnesi. Bu çağrılar, merge: true özelliğine sahip bir SetOptions sağlanarak hedef dokümanların üzerine yazılmak yerine ayrıntılı birleştirme işlemleri gerçekleştirecek şekilde yapılandırılabilir.

İmza:

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

Görev Durumu

Paket yükleme görevlerinin durumunu temsil eder.

Her ikisi de "Hata" ve "Başarı" batma durumu: Görev iptal edilir veya tamamlanır. Bunlar bildirildikten sonra başka güncelleme yapılmaz.

İmza:

export declare type TaskState = 'Error' | 'Running' | 'Success';

BirleşimdenKesişim'e

Birleştirme türü verilen U = T1 | T2 | ..., kesişen (T1 & T2 & ...) türünü döndürür.

Dağıtılabilir koşullu türleri ve koşullu türlerden çıkarımı kullanır. Bunun nedeni, zıt varyantlı konumlarda aynı tür değişken için birden fazla adayın bir kesişim türünün tahmin edilmesine neden olmasıdır. https://www.typescriptlang.org/docs/handbook/advanced-types.html#type-inference-in-conditional-types https://stackoverflow.com/questions/50374908/convert-union-type-to-intersection-type

İmza:

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

Veri Güncelleme

Değerlerle eşlenmiş alan yollarından (ör. "foo" veya "foo.baz") oluşan verileri (updateDoc() ile kullanım için) güncelleme. Nokta içeren alanlar, dokümandaki iç içe yerleştirilmiş alanlara referans verir. FieldValues, özellik değeri olarak aktarılabilir.

İmza:

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

NeredeFiltreOp

where() yan tümcesindeki filtreleme koşulları "&lt;", "&lt;=', '==', '!=', '&gt;=', '&gt;', 'array-contains', 'in', 'array-contains-any' ve "not-in" dizeleri kullanılarak belirtilir.

İmza:

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

Alan Değerine Sahip

Tür güvenliğini korurken FieldValue'ların özellik değeri olarak aktarılmasına olanak tanır.

İmza:

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