Bu sayfa, Cloud Translation API ile çevrilmiştir.

database package

Firebase Realtime Database

İşlevler

İşlev	Açıklama
fonksiyon(uygulama, ...)
getDatabase(uygulama; url)	Sağlanan FirebaseApp ile ilişkilendirilmiş Realtime Database SDK'sının örneğini döndürür. Herhangi bir örnek yoksa veya mevcut örnek bir özel veritabanı URL'si kullanıyorsa yeni bir örneği varsayılan ayarlarla başlatır.
fonksiyon(db, ...)
connectDatabaseEmulator(db, ana makine, bağlantı noktası, seçenekler)	Realtime Database emülatörüyle iletişim kurmak için sağlanan örneği değiştirin. Not: Bu yöntem başka bir işlem yapılmadan önce çağrılmalıdır.
goÇevrimdışı(db)	Sunucuyla olan bağlantıyı keser (tüm Veritabanı işlemleri çevrimdışı olarak tamamlanır).İstemci otomatik olarak Veritabanı sunucusuyla kalıcı bir bağlantı sürdürür. Bu bağlantı süresiz olarak etkin kalır ve bağlantı kesildiğinde yeniden bağlanır. Ancak `goOffline()` ve `goOnline()` yöntemleri, kalıcı bağlantının istenmeyen olduğu durumlarda istemci bağlantısını denetlemek için kullanılabilir.İstemci çevrimdışıyken artık Veritabanı'ndan veri güncellemelerini almaz. Ancak yerel olarak gerçekleştirilen tüm Veritabanı işlemleri etkinlikleri hemen tetiklemeye devam ederek uygulamanızın normal şekilde çalışmaya devam etmesini sağlar. Ayrıca, yerel olarak gerçekleştirilen her işlem otomatik olarak sıraya alınır ve Database sunucusuna yeniden bağlanıldığında yeniden denenir.Veritabanına yeniden bağlanmak ve uzak etkinlikleri almaya başlamak için `goOnline()` sayfasına bakın.
goOnline(db)	Sunucuya yeniden bağlanır ve çevrimdışı Veritabanı durumunu sunucu durumuyla senkronize eder.Bu yöntem, `goOffline()` ile etkin bağlantı devre dışı bırakıldıktan sonra kullanılmalıdır. Yeniden bağlandığında istemci uygun verileri iletir ve istemcinizin "yakalaması" için uygun etkinlikleri tetikler. otomatik olarak oluşturur.
ref(db; yol)	Veritabanındaki, sağlanan yola karşılık gelen konumu temsil eden bir `Reference` döndürür. Herhangi bir yol sağlanmazsa `Reference`, Veritabanının köküne işaret eder.
refFromURL(db, url)	Veritabanında sağlanan Firebase URL'sine karşılık gelen konumu temsil eden bir `Reference` döndürür.URL geçerli bir Firebase Veritabanı URL'si değilse veya geçerli `Database` örneğinden farklı bir alan adına sahipse istisnai iptal edilir.Tüm sorgu parametrelerinin (`orderBy`, `limitToLast` vb.) yoksayıldığını ve döndürülen `Reference` öğesine uygulanmadığını unutmayın.
fonksiyon()
forceLongPolling()	Websockets yerine longPolling kullanımını zorunlu kıl. DatabaseURL'de websocket protokolü kullanılırsa bu yoksayılır.
forceWebSockets()	LongPolling yerine websocket kullanımını zorunlu kıl.
orderByKey().	Anahtara göre sıralayan yeni bir `QueryConstraint` oluşturur.Sorgu sonuçlarını (artan) anahtar değerlerine göre sıralar.Verileri sıralama bölümünde `orderByKey()` hakkında daha fazla bilgi edinebilirsiniz.
orderByPriority().	Önceliğe göre sıralanan yeni bir `QueryConstraint` oluşturur.Uygulamaların öncelik kullanmasına gerek yoktur, ancak koleksiyonları normal özelliklere göre sıralayabilir (öncelik alternatifleri için Verileri sıralama bölümüne bakın).
orderByValue().	Değere göre sıralayan yeni bir `QueryConstraint` oluşturur.Bir sorgunun alt öğelerinin tümü skaler değerlerden (dize, sayı veya boole) oluşuyorsa sonuçları onlara (artan) değerlerine göre sıralayabilirsiniz.Verileri sıralama bölümünde `orderByValue()` hakkında daha fazla bilgi edinebilirsiniz.
serverTimestamp()	Firebase sunucuları tarafından belirlenen ve geçerli zaman damgasını (Unix döneminden beri geçen süre, milisaniye cinsinden) otomatik olarak doldurmak için bir yer tutucu değer döndürür.
fonksiyon(delta, ...)
artım(delta)	Geçerli veritabanı değerini sağlanan delta kadar atomik olarak artırmak için kullanılabilecek bir yer tutucu değer döndürür.
fonksiyon(etkin, ...)
enableLogging(etkin, kalıcı)	Hata ayıklama bilgilerini konsola kaydeder.
function(limit, ...)
limitToFirst(sınır)	Belirli bir ilk alt öğe sayısıyla sınırlı olan yeni bir `QueryConstraint` oluşturur.`limitToFirst()` yöntemi, belirli bir geri çağırma için senkronize edilecek maksimum alt öğe sayısını ayarlamak için kullanılır. 100 şeklinde bir sınır belirlersek başlangıçta yalnızca en fazla 100 `child_added` etkinliği alırız. Veritabanımızda depolanan mesaj sayısı 100'den azsa her ileti için bir `child_added` etkinliği tetiklenir. Ancak 100'den fazla mesajımız varsa sadece sipariş edilen ilk 100 mesaj için bir `child_added` etkinliği alırız. Öğeler değiştikçe etkin listeden çıkan her öğe için `child_removed` etkinlik alırız. Böylece toplam sayı 100'de kalır.Verileri filtreleme bölümünde `limitToFirst()` hakkında daha fazla bilgi edinebilirsiniz.
limitToLast(sınır)	Yalnızca belirtilen son sayıda alt öğeyi döndürecek şekilde sınırlı yeni bir `QueryConstraint` oluşturur.`limitToLast()` yöntemi, belirli bir geri çağırma için senkronize edilecek maksimum alt öğe sayısını ayarlamak için kullanılır. 100 şeklinde bir sınır belirlersek başlangıçta yalnızca en fazla 100 `child_added` etkinliği alırız. Veritabanımızda depolanan mesaj sayısı 100'den azsa her ileti için bir `child_added` etkinliği tetiklenir. Ancak 100'den fazla mesajımız varsa sadece sipariş edilen son 100 mesaj için bir `child_added` etkinliği alırız. Öğeler değiştikçe etkin listeden çıkan her öğe için `child_removed` etkinlik alırız. Böylece toplam sayı 100'de kalır.Verileri filtreleme bölümünde `limitToLast()` hakkında daha fazla bilgi edinebilirsiniz.
function(logger, ...)
enableLogging(logger)	Hata ayıklama bilgilerini konsola kaydeder.
fonksiyon(üst, ...)
child(üst, yol)	Belirtilen göreli yoldaki konum için bir `Reference` alır.Göreli yol, basit bir alt ad (ör. "ada") veya eğik çizgiyle ayrılmış daha derin bir yol (örneğin, "ada/ad/ilk") olabilir.
push(üst, değer)	Benzersiz bir anahtar kullanarak yeni bir alt konum oluşturur ve onun `Reference` değerini döndürür.Bu, bir öğe koleksiyonuna veri eklemek için en sık kullanılan kalıptır.`push()` öğesine bir değer sağlarsanız değer, oluşturulan konuma yazılır. Bir değer iletmezseniz veritabanına hiçbir şey yazılmaz ve alt öğe boş kalır (ancak `Reference` öğesini başka bir yerde kullanabilirsiniz).`push()` tarafından oluşturulan benzersiz anahtarlar geçerli zamana göre sıralanır. Bu nedenle, sonuç olarak elde edilen öğe listesi kronolojik olarak sıralanır. Anahtarlar ayrıca tahmin edilemez olacak şekilde tasarlanmıştır (72 rastgele entropi biti içerirler).Veri listesine ekleme bölümüne bakın. Benzersiz Tanımlayıcılar Sağlamanın 2^120 Yolu bölümüne bakın.
fonksiyon(yol; ...)
orderByChild(path)	Belirtilen alt anahtara göre sıralayan yeni bir `QueryConstraint` oluşturur.Sorgular aynı anda yalnızca bir anahtara göre sıralanabilir. `orderByChild()` öğesini aynı sorguda birden çok kez çağırmak hatadır.Firebase sorguları, verilerinizi anında herhangi bir alt anahtara göre sıralamanıza olanak tanır. Bununla birlikte, dizinlerinizin ne olacağını önceden biliyorsanız daha iyi performans için Güvenlik Kurallarınızdaki .indexOn kuralıyla tanımlayabilirsiniz. Daha fazla bilgi için https://firebase.google.com/docs/database/security/indexing-data kuralını inceleyin.Verileri sıralama bölümünde `orderByChild()` hakkında daha fazla bilgi edinebilirsiniz.
fonksiyon(sorgu, ...)
get(sorgu)	Bu sorgu için en güncel sonucu alır.
off(query, eventType, callback)	İlgili `on()` (`onValue`, `onChildAdded`) işleyicisine daha önce ekli bir geri çağırmayı ayırır. Not: Bir işleyiciyi kaldırmak için bu yöntemin önerilmez. Bunun yerine, lütfen ilgili `on` geri çağırmasından döndürülen geri çağırma işlevini kullanın.`on*()` ile ekli olan bir geri çağırmayı çıkarın. Bir üst işleyicide `off()` çağrısı yapıldığında alt düğümlerde kayıtlı işleyiciler otomatik olarak kaldırılmaz. Geri çağırmanın kaldırılması için tüm alt işleyicilerde de `off()` çağrılmalıdır.Geri çağırma belirtilmezse belirtilen eventType için tüm geri çağırmalar kaldırılır. Benzer şekilde, herhangi bir eventType belirtilmezse `Reference` için tüm geri çağırmalar kaldırılır.Bağımsız dinleyiciler, e-posta listesinden çıkma geri çağırmaları yapılarak da kaldırılabilir.
onChildAttach(sorgu, geri çağırma, cancelCallback)	Belirli bir konumdaki veri değişikliklerini dinler.Bu, Veritabanı'ndaki verileri okumanın birincil yoludur. Geri çağırma işleminiz, ilk veriler için ve veriler her değiştiğinde tekrar tetiklenir. Güncelleme almayı durdurmak için döndürülen e-posta listesinden çıkma geri aramasını çağırın. Daha fazla ayrıntı için Web'de Veri Alma konusuna bakın.Bu konumdaki her ilk çocuk için bir `onChildAdded` etkinliği tetiklenir ve her yeni alt öğe eklendiğinde tekrar tetiklenir. Geri çağırmaya iletilen `DataSnapshot`, ilgili alt yayıncının verilerini yansıtır. Sıralama amacıyla, ikinci bir bağımsız değişken, sıralama sırasına göre önceki eşdüzey alt öğenin anahtarını içeren bir dize veya ilk alt öğeyse `null` iletilir.
onChildAdded(sorgu, geri arama, seçenekler)	Belirli bir konumdaki veri değişikliklerini dinler.Bu, Veritabanı'ndaki verileri okumanın birincil yoludur. Geri çağırma işleminiz, ilk veriler için ve veriler her değiştiğinde tekrar tetiklenir. Güncelleme almayı durdurmak için döndürülen e-posta listesinden çıkma geri aramasını çağırın. Daha fazla ayrıntı için Web'de Veri Alma konusuna bakın.Bu konumdaki her ilk çocuk için bir `onChildAdded` etkinliği tetiklenir ve her yeni alt öğe eklendiğinde tekrar tetiklenir. Geri çağırmaya iletilen `DataSnapshot`, ilgili alt yayıncının verilerini yansıtır. Sıralama amacıyla, ikinci bir bağımsız değişken, sıralama sırasına göre önceki eşdüzey alt öğenin anahtarını içeren bir dize veya ilk alt öğeyse `null` iletilir.
onChildadded(sorgu, geri çağırma, iptalCallback, options)	Belirli bir konumdaki veri değişikliklerini dinler.Bu, Veritabanı'ndaki verileri okumanın birincil yoludur. Geri çağırma işleminiz, ilk veriler için ve veriler her değiştiğinde tekrar tetiklenir. Güncelleme almayı durdurmak için döndürülen e-posta listesinden çıkma geri aramasını çağırın. Daha fazla ayrıntı için Web'de Veri Alma konusuna bakın.Bu konumdaki her ilk çocuk için bir `onChildAdded` etkinliği tetiklenir ve her yeni alt öğe eklendiğinde tekrar tetiklenir. Geri çağırmaya iletilen `DataSnapshot`, ilgili alt yayıncının verilerini yansıtır. Sıralama amacıyla, ikinci bir bağımsız değişken, sıralama sırasına göre önceki eşdüzey alt öğenin anahtarını içeren bir dize veya ilk alt öğeyse `null` iletilir.
onChildChanged(query, callback, cancelCallback)	Belirli bir konumdaki veri değişikliklerini dinler.Bu, Veritabanı'ndaki verileri okumanın birincil yoludur. Geri çağırma işleminiz, ilk veriler için ve veriler her değiştiğinde tekrar tetiklenir. Güncelleme almayı durdurmak için döndürülen e-posta listesinden çıkma geri aramasını çağırın. Daha ayrıntılı bilgi için Web'de Veri Alma başlıklı makaleyi inceleyin.Bir alt öğede (veya alt öğelerinde) depolanan veriler değiştiğinde `onChildChanged` etkinliği tetiklenir. Tek bir `child_changed` etkinliğinin, alt öğe için birden fazla değişikliği temsil edebileceğini unutmayın. Geri çağırmaya iletilen `DataSnapshot`, yeni alt içerikleri barındırır. Sıralama amacıyla geri çağırma, ikinci bir bağımsız değişken de iletilir. Bu bağımsız değişken, sıralama düzenine göre önceki eşdüzey alt öğenin anahtarını içeren bir dizedir. İlk alt değişkense `null` de iletilir.
onChildChanged(sorgu, geri arama, seçenekler)	Belirli bir konumdaki veri değişikliklerini dinler.Bu, Veritabanı'ndaki verileri okumanın birincil yoludur. Geri çağırma işleminiz, ilk veriler için ve veriler her değiştiğinde tekrar tetiklenir. Güncelleme almayı durdurmak için döndürülen e-posta listesinden çıkma geri aramasını çağırın. Daha ayrıntılı bilgi için Web'de Veri Alma başlıklı makaleyi inceleyin.Bir alt öğede (veya alt öğelerinde) depolanan veriler değiştiğinde `onChildChanged` etkinliği tetiklenir. Tek bir `child_changed` etkinliğinin, alt öğe için birden fazla değişikliği temsil edebileceğini unutmayın. Geri çağırmaya iletilen `DataSnapshot`, yeni alt içerikleri barındırır. Sıralama amacıyla geri çağırma, ikinci bir bağımsız değişken de iletilir. Bu bağımsız değişken, sıralama düzenine göre önceki eşdüzey alt öğenin anahtarını içeren bir dizedir. İlk alt değişkense `null` de iletilir.
onChildChanged(sorgu, geri çağırma, cancelCallback, options)	Belirli bir konumdaki veri değişikliklerini dinler.Bu, Veritabanı'ndaki verileri okumanın birincil yoludur. Geri çağırma işleminiz, ilk veriler için ve veriler her değiştiğinde tekrar tetiklenir. Güncelleme almayı durdurmak için döndürülen e-posta listesinden çıkma geri aramasını çağırın. Daha ayrıntılı bilgi için Web'de Veri Alma başlıklı makaleyi inceleyin.Bir alt öğede (veya alt öğelerinde) depolanan veriler değiştiğinde `onChildChanged` etkinliği tetiklenir. Tek bir `child_changed` etkinliğinin, alt öğe için birden fazla değişikliği temsil edebileceğini unutmayın. Geri çağırmaya iletilen `DataSnapshot`, yeni alt içerikleri barındırır. Sıralama amacıyla geri çağırma, ikinci bir bağımsız değişken de iletilir. Bu bağımsız değişken, sıralama düzenine göre önceki eşdüzey alt öğenin anahtarını içeren bir dizedir. İlk alt değişkense `null` de iletilir.
onChildMoved(sorgu, geri çağırma, iptalCallback)	Belirli bir konumdaki veri değişikliklerini dinler.Bu, Veritabanı'ndaki verileri okumanın birincil yoludur. Geri çağırma işleminiz, ilk veriler için ve veriler her değiştiğinde tekrar tetiklenir. Güncelleme almayı durdurmak için döndürülen e-posta listesinden çıkma geri aramasını çağırın. Daha fazla ayrıntı için Web'de Veri Alma konusuna bakın.Bir alt yayıncının sıralama düzeni, eşdüzeylerine göre konumu değişecek şekilde değiştiğinde `onChildMoved` etkinliği tetiklenir. Geri çağırmaya iletilen `DataSnapshot`, taşınan alt kullanıcının verileri içindir. Ayrıca, sıralama sırasına göre önceki eşdüzey alt öğenin anahtarını içeren bir dize olan ikinci bir bağımsız değişken veya ilk alt öğe ise `null` iletilir.
onChildMoved(sorgu, geri çağırma, seçenekler)	Belirli bir konumdaki veri değişikliklerini dinler.Bu, Veritabanı'ndaki verileri okumanın birincil yoludur. Geri çağırma işleminiz, ilk veriler için ve veriler her değiştiğinde tekrar tetiklenir. Güncelleme almayı durdurmak için döndürülen e-posta listesinden çıkma geri aramasını çağırın. Daha fazla ayrıntı için Web'de Veri Alma konusuna bakın.Bir alt yayıncının sıralama düzeni, eşdüzeylerine göre konumu değişecek şekilde değiştiğinde `onChildMoved` etkinliği tetiklenir. Geri çağırmaya iletilen `DataSnapshot`, taşınan alt kullanıcının verileri içindir. Ayrıca, sıralama sırasına göre önceki eşdüzey alt öğenin anahtarını içeren bir dize olan ikinci bir bağımsız değişken veya ilk alt öğe ise `null` iletilir.
onChildMoved(sorgu, geri çağırma, cancelCallback, options)	Belirli bir konumdaki veri değişikliklerini dinler.Bu, Veritabanı'ndaki verileri okumanın birincil yoludur. Geri çağırma işleminiz, ilk veriler için ve veriler her değiştiğinde tekrar tetiklenir. Güncelleme almayı durdurmak için döndürülen e-posta listesinden çıkma geri aramasını çağırın. Daha fazla ayrıntı için Web'de Veri Alma konusuna bakın.Bir alt yayıncının sıralama düzeni, eşdüzeylerine göre konumu değişecek şekilde değiştiğinde `onChildMoved` etkinliği tetiklenir. Geri çağırmaya iletilen `DataSnapshot`, taşınan alt kullanıcının verileri içindir. Ayrıca, sıralama sırasına göre önceki eşdüzey alt öğenin anahtarını içeren bir dize olan ikinci bir bağımsız değişken veya ilk alt öğe ise `null` iletilir.
onChildRemoved(query, callback, cancelCallback)	Belirli bir konumdaki veri değişikliklerini dinler.Bu, Veritabanı'ndaki verileri okumanın birincil yoludur. Geri çağırma işleminiz, ilk veriler için ve veriler her değiştiğinde tekrar tetiklenir. Güncelleme almayı durdurmak için döndürülen e-posta listesinden çıkma geri aramasını çağırın. Daha ayrıntılı bilgi için Web'de Veri Alma başlıklı makaleyi inceleyin.Her alt öğe kaldırıldığında bir `onChildRemoved` etkinliği tetiklenir. Geri çağırmaya iletilen `DataSnapshot`, kaldırılan alt hesabın eski verileri olur. Bir alt öğe şu durumlarda kaldırılır:- bir istemci bu alt ya da üst öğelerinden biri için açıkça `remove()` çağrısı yaptığında (istemci bu alt veya üst öğelerinden biri için `set(null)` çağrısı yaptığında) söz konusu alt çocuğun tüm alt öğeleri kaldırılırsa geçerli bir sorgu olduğunda alt öğe filtrelenir (sıralama ölçütü değiştiği veya maksimum sınıra ulaşıldığı için)
onChildRemoved(query, callback, options)	Belirli bir konumdaki veri değişikliklerini dinler.Bu, Veritabanı'ndaki verileri okumanın birincil yoludur. Geri çağırma işleminiz, ilk veriler için ve veriler her değiştiğinde tekrar tetiklenir. Güncelleme almayı durdurmak için döndürülen e-posta listesinden çıkma geri aramasını çağırın. Daha ayrıntılı bilgi için Web'de Veri Alma başlıklı makaleyi inceleyin.Her alt öğe kaldırıldığında bir `onChildRemoved` etkinliği tetiklenir. Geri çağırmaya iletilen `DataSnapshot`, kaldırılan alt hesabın eski verileri olur. Bir alt öğe şu durumlarda kaldırılır:- bir istemci bu alt ya da üst öğelerinden biri için açıkça `remove()` çağrısı yaptığında (istemci bu alt veya üst öğelerinden biri için `set(null)` çağrısı yaptığında) söz konusu alt çocuğun tüm alt öğeleri kaldırılırsa geçerli bir sorgu olduğunda alt öğe filtrelenir (sıralama ölçütü değiştiği veya maksimum sınıra ulaşıldığı için)
onChildRemoved(query, callback, cancelCallback, options)	Belirli bir konumdaki veri değişikliklerini dinler.Bu, Veritabanı'ndaki verileri okumanın birincil yoludur. Geri çağırma işleminiz, ilk veriler için ve veriler her değiştiğinde tekrar tetiklenir. Güncelleme almayı durdurmak için döndürülen e-posta listesinden çıkma geri aramasını çağırın. Daha ayrıntılı bilgi için Web'de Veri Alma başlıklı makaleyi inceleyin.Her alt öğe kaldırıldığında bir `onChildRemoved` etkinliği tetiklenir. Geri çağırmaya iletilen `DataSnapshot`, kaldırılan alt hesabın eski verileri olur. Bir alt öğe şu durumlarda kaldırılır:- bir istemci bu alt ya da üst öğelerinden biri için açıkça `remove()` çağrısı yaptığında (istemci bu alt veya üst öğelerinden biri için `set(null)` çağrısı yaptığında) söz konusu alt çocuğun tüm alt öğeleri kaldırılırsa geçerli bir sorgu olduğunda alt öğe filtrelenir (sıralama ölçütü değiştiği veya maksimum sınıra ulaşıldığı için)
onValue(sorgu, geri çağırma, iptalCallback)	Belirli bir konumdaki veri değişikliklerini dinler.Bu, Veritabanı'ndaki verileri okumanın birincil yoludur. Geri çağırma işleminiz, ilk veriler için ve veriler her değiştiğinde tekrar tetiklenir. Güncelleme almayı durdurmak için döndürülen e-posta listesinden çıkma geri aramasını çağırın. Daha fazla ayrıntı için Web'de Veri Alma bölümünü inceleyin.Bir `onValue` etkinliği, bu konumda depolanan ilk verilerle bir kez tetiklenir ve ardından veriler her değiştiğinde tekrar tetiklenir. Geri çağırmaya iletilen `DataSnapshot`, `on()` çağrıldığı konum için olacaktır. Bu işlem, içeriğin tamamı senkronize edilene kadar tetiklenmez. Konumda veri yoksa boş bir `DataSnapshot` ile tetiklenir (`val()`, `null` değerini döndürür).
onValue(sorgu, geri çağırma, seçenekler)	Belirli bir konumdaki veri değişikliklerini dinler.Bu, Veritabanı'ndaki verileri okumanın birincil yoludur. Geri çağırma işleminiz, ilk veriler için ve veriler her değiştiğinde tekrar tetiklenir. Güncelleme almayı durdurmak için döndürülen e-posta listesinden çıkma geri aramasını çağırın. Daha fazla ayrıntı için Web'de Veri Alma bölümünü inceleyin.Bir `onValue` etkinliği, bu konumda depolanan ilk verilerle bir kez tetiklenir ve ardından veriler her değiştiğinde tekrar tetiklenir. Geri çağırmaya iletilen `DataSnapshot`, `on()` çağrıldığı konum için olacaktır. Bu işlem, içeriğin tamamı senkronize edilene kadar tetiklenmez. Konumda veri yoksa boş bir `DataSnapshot` ile tetiklenir (`val()`, `null` değerini döndürür).
onValue(query, callback, cancelCallback, options)	Belirli bir konumdaki veri değişikliklerini dinler.Bu, Veritabanı'ndaki verileri okumanın birincil yoludur. Geri çağırma işleminiz, ilk veriler için ve veriler her değiştiğinde tekrar tetiklenir. Güncelleme almayı durdurmak için döndürülen e-posta listesinden çıkma geri aramasını çağırın. Daha fazla ayrıntı için Web'de Veri Alma bölümünü inceleyin.Bir `onValue` etkinliği, bu konumda depolanan ilk verilerle bir kez tetiklenir ve ardından veriler her değiştiğinde tekrar tetiklenir. Geri çağırmaya iletilen `DataSnapshot`, `on()` çağrıldığı konum için olacaktır. Bu işlem, içeriğin tamamı senkronize edilene kadar tetiklenmez. Konumda veri yoksa boş bir `DataSnapshot` ile tetiklenir (`val()`, `null` değerini döndürür).
sorgu(sorgu; queryConstraints)	Ek sorgu kısıtlamaları da içerecek şekilde genişletilen yeni bir `Query` örneği oluşturur.
function(ref, ...)
onBağlantıyı kesme(ref)	Bir `OnDisconnect` nesnesini döndürür. Bu nesnenin nasıl kullanılacağı hakkında daha fazla bilgi için JavaScript'te Çevrimdışı Özellikleri Etkinleştirme konusuna bakın.
remove(ref)	Bu Veritabanı konumundaki verileri kaldırır.Alt konumlardaki tüm veriler de silinir.Kaldırma işleminin etkisi hemen görünür ve ilgili etkinlik "value" görünür. tetiklenecektir. Kaldırma işleminin Firebase sunucularıyla senkronizasyonu da başlatılır ve döndürülen Vaat, işlem tamamlandığında çözüme ulaştırılır. Sağlanmışsa, onComplete geri çağırması senkronizasyon bittikten sonra eşzamansız olarak çağrılır.
runTransaction(ref, transactionUpdate, options)	Bu konumdaki verileri anomik olarak değiştirir.Bu konumdaki verileri atomik olarak değiştirin. Önceki değerinden bağımsız olarak verilerin üzerine yazan normal `set()` işlevinin aksine `runTransaction()`, mevcut değeri yeni bir değerle değiştirmek için kullanılır. Böylece, aynı konuma aynı anda yazan diğer istemcilerle çakışma olmaması sağlanır.Bunu başarmak için `runTransaction()`, mevcut değeri yeni bir değere dönüştürmek için kullanılan bir güncelleme işlevi aktarır. Başka bir istemci yeni değeriniz başarıyla yazılmadan önce konuma yazarsa güncelleme işleviniz yeni geçerli değerle tekrar çağrılır ve yazma işlemi yeniden denenir. Bu durum, yazma işleminiz çakışma olmadan başarılı olana veya siz güncelleme işlevinizden bir değer döndürmeyerek işlemi iptal edene kadar tekrar eder.Not: `set()` ile verilerde değişiklik yaptığınızda, söz konusu konumdaki bekleyen tüm işlemler iptal edilir. Bu nedenle, aynı verileri güncellemek için `set()` ve `runTransaction()` hizmetlerini birlikte kullanırken son derece dikkatli olmalısınız.Not: İşlemleri Güvenlik ve Firebase Kurallarıyla kullanırken, istemcinin işlem gerçekleştirmek için `.write` erişimine ek olarak `.read` erişimine ihtiyacı olduğunu unutmayın. Bunun nedeni, işlemlerin istemci tarafı yapısının, verileri işlemsel olarak güncellemek için istemcinin verileri okumasını gerektirmesidir.
set(ref; değer)	Bu Veritabanı konumuna veri yazar.Bu işlem, bu konumdaki ve tüm alt konumlardaki tüm verilerin üzerine yazar.Yazma işleminin etkisi hemen görünür ve ilgili etkinlikler ("value", "child_added" vb.) tetiklenir. Verilerin Firebase sunucularıyla senkronizasyonu da başlatılır ve döndürülen Promise işlem tamamlandığında çözüme kavuşturulur. Sağlanmışsa, senkronizasyon bittikten sonra `onComplete` geri çağırması eşzamansız olarak çağrılacaktır.Yeni değer için `null` değerinin iletilmesi, `remove()` çağrısına eşdeğerdir; diğer bir deyişle, bu konumdaki ve tüm alt konumlardaki tüm veriler silinecek.`set()`, bu konumda depolanan tüm öncelikleri kaldıracaktır. Dolayısıyla, önceliğin korunması amaçlanıyorsa bunun yerine `setWithPriority()` yöntemini kullanmanız gerekir.`set()` ile verilerin değiştirilmesinin, ilgili konumdaki beklemedeki tüm işlemleri iptal edeceğini unutmayın. Bu nedenle, aynı verileri değiştirmek için `set()` ve `transaction()` öğelerini birlikte kullanırken son derece dikkatli olmalısınız.Tek bir `set()` tek bir "değer" oluşturur. `set()` etkinliği gerçekleştirildiği yerdeki etkinlik.
setPriority(ref, öncelik)	Bu Veritabanı konumundaki veriler için bir öncelik ayarlar.Uygulamaların öncelik kullanması gerekmez, ancak koleksiyonları normal özelliklere göre sıralayabilir (bkz. Verileri sıralama ve filtreleme).
setWithPriority(ref; değer; öncelik)	Verileri Veritabanı konumuna yazar. `set()` işlevine benzer ancak aynı zamanda bu verilerin önceliğini de belirtir.Uygulamaların öncelik kullanması gerekmez ancak koleksiyonları normal özelliklere göre sıralayabilir (bkz. Verileri sıralama ve filtreleme).
update(ref, değerler)	Veritabanına aynı anda birden fazla değer yazar.`values` bağımsız değişkeni, Veritabanına birlikte yazılacak birden fazla özellik-değer çifti içeriyor. Her alt mülk, basit bir mülk (örneğin, "ad") veya mevcut konumdan güncelleme yapılacak verilere giden göreli bir yol (örneğin, "ad/ad") olabilir.`set()` yönteminin aksine, `update()` (geçerli konumdaki tüm alt mülkleri değiştirmek yerine) yalnızca geçerli konumdaki referans verilen özellikleri seçerek güncellemek için kullanılabilir.Yazma işleminin etkisi hemen gösterilir ve ilgili etkinlikler ("value" gibi). Verilerin Firebase sunucularıyla senkronizasyonu da başlatılır ve döndürülen Promise işlem tamamlandığında çözüme kavuşturulur. Sağlanırsa `onComplete` geri çağırması, senkronizasyon bittikten sonra eşzamansız olarak çağrılır.Tek bir `update()`, tek bir "değer" oluşturur `update()` öğesinin gerçekleştirildiği konumdaki etkinlik.Verilerin `update()` ile değiştirilmesinin söz konusu konumdaki bekleyen tüm işlemleri iptal edeceğini unutmayın. Bu nedenle, aynı verileri değiştirmek için `update()` ve `transaction()` kullanılıyorsa çok dikkatli olunmalıdır.`null` uygulamasının `update()` ürününe iletilmesi, bu konumdaki verilerin kaldırılmasına neden olur.Çok konumlu güncellemeler ve daha fazlasının kullanıma sunulması bölümünü inceleyin.
function(değer, ...)
endAt(değer; anahtar)	Belirtilen bitiş noktasıyla bir `QueryConstraint` oluşturur.`startAt()`, `startAfter()`, `endBefore()`, `endAt()` ve `equalTo()` öğelerini kullanarak sorgularınız için rastgele başlangıç ve bitiş noktaları seçebilirsiniz.Bitiş noktası kapsayıcıdır, bu nedenle tam olarak belirtilen değere sahip alt öğeler sorguya dahil edilir. İsteğe bağlı anahtar bağımsız değişkeni, sorgunun aralığını daha fazla sınırlamak için kullanılabilir. Belirtilmişse tam olarak belirtilen değere sahip alt öğelerin de belirtilen anahtardan küçük veya ona eşit bir anahtar adına sahip olması gerekir.Verileri filtreleme bölümünde `endAt()` hakkında daha fazla bilgi edinebilirsiniz.
endBefore(değer; anahtar)	Belirtilen bitiş noktasıyla (hariç) bir `QueryConstraint` oluşturur.`startAt()`, `startAfter()`, `endBefore()`, `endAt()` ve `equalTo()` öğelerini kullanarak sorgularınız için rastgele başlangıç ve bitiş noktaları seçebilirsiniz.Bitiş noktası özeldir. Yalnızca bir değer sağlanırsa belirtilen değerden düşük bir değere sahip alt öğeler sorguya dahil edilir. Bir anahtar belirtilirse alt öğelerin, belirtilen değerden küçük veya ona eşit bir değere ve belirtilen anahtardan küçük bir anahtar adına sahip olması gerekir.
equalTo(değer; anahtar)	Belirtilen değerle eşleşen alt öğeleri içeren bir `QueryConstraint` oluşturur.`startAt()`, `startAfter()`, `endBefore()`, `endAt()` ve `equalTo()` kullanılması sorgularınız için rastgele başlangıç ve bitiş noktaları seçmenize olanak tanır.İsteğe bağlı temel bağımsız değişken, sorgu aralığını daha da sınırlamak için kullanılabilir. Belirtilmişse tam olarak belirtilen değere sahip alt yayıncılar, anahtar adı olarak belirtilen anahtarı da tam olarak kullanmalıdır. Bu özellik, aynı değer için çok sayıda eşleşme içeren sonuç kümelerini filtrelemek için kullanılabilir.Verileri filtreleme bölümünde `equalTo()` hakkında daha fazla bilgi edinebilirsiniz.
startAfter(değer; anahtar)	Belirtilen başlangıç noktasıyla (hariç) bir `QueryConstraint` oluşturur.`startAt()`, `startAfter()`, `endBefore()`, `endAt()` ve `equalTo()` öğelerini kullanarak sorgularınız için rastgele başlangıç ve bitiş noktaları seçebilirsiniz.Başlangıç noktası özeldir. Yalnızca değer sağlanırsa belirtilen değerden büyük olan alt öğeler sorguya dahil edilir. Bir anahtar belirtilirse alt öğelerin, belirtilen değerden büyük veya ona eşit bir değere ve belirtilen anahtardan büyük bir anahtar adına sahip olması gerekir.
startAt(değer; anahtar)	Belirtilen başlangıç noktasıyla bir `QueryConstraint` oluşturur.`startAt()`, `startAfter()`, `endBefore()`, `endAt()` ve `equalTo()` öğelerini kullanarak sorgularınız için rastgele başlangıç ve bitiş noktaları seçebilirsiniz.Başlangıç noktası kapsayıcıdır, bu nedenle tam olarak belirtilen değere sahip alt öğeler sorguya dahil edilir. İsteğe bağlı anahtar bağımsız değişkeni, sorgunun aralığını daha fazla sınırlamak için kullanılabilir. Belirtilmişse tam olarak belirtilen değere sahip alt öğelerin de belirtilen anahtardan büyük veya ona eşit bir anahtar adına sahip olması gerekir.Verileri filtreleme bölümünde `startAt()` hakkında daha fazla bilgi edinebilirsiniz.

Sınıflar

Sınıf	Açıklama
Veritabanı	Firebase Realtime Database'i temsil eden sınıf.
DataSnapshot	`DataSnapshot`, bir Veritabanı konumundan veriler içerir.Veritabanı'ndan her veri okuduğunuzda verileri `DataSnapshot` olarak alırsınız. `on()` veya `once()` ile eklediğiniz etkinlik geri çağırmalarına bir `DataSnapshot` iletilir. `val()` yöntemini çağırarak anlık görüntünün içeriğini JavaScript nesnesi olarak ayıklayabilirsiniz. Alternatif olarak, alt anlık görüntüleri döndürmek için `child()` öğesini çağırarak anlık görüntüye gezinebilirsiniz (daha sonra `val()` öğesini çağırabilirsiniz).`DataSnapshot`, bir Veritabanı konumundaki verilerin verimli bir şekilde oluşturulmuş ve sabit bir kopyasıdır. Değiştirilemez ve hiçbir zaman değiştirilmez (verileri değiştirmek için her zaman doğrudan bir `Reference` üzerinde `set()` yöntemini çağırırsınız).
Bağlantıyı Kes	`onDisconnect` sınıfı, istemcinizin Veritabanı sunucusuyla olan bağlantısı kesildiğinde veri yazmanıza veya verileri temizlemenize olanak tanır. Bu güncellemeler, istemcinizin bağlantısı düzgün bir şekilde kesilip kesilmemesinden bağımsız olarak gerçekleşir. Bu nedenle, bağlantı kesilse veya istemci çökse bile verileri temizleme konusunda bu güncellemelerin uygulanmasına güvenebilirsiniz.`onDisconnect` sınıfı en yaygın olarak, kaç istemcinin bağlı olduğunu ve diğer istemcilerin bağlantısını kestiğinde tespit edilmesinin yararlı olduğu uygulamalardaki varlığı yönetmek için kullanılır. Daha fazla bilgi için JavaScript'te Çevrimdışı Özellikleri Etkinleştirme bölümüne bakın.İstekler Veritabanı sunucusuna aktarılmadan önce bir bağlantı kesildiğinde sorun yaşamamak için bu işlevler herhangi bir veri yazmadan önce çağrılmalıdır.`onDisconnect` işlemlerinin yalnızca bir kez tetiklendiğini unutmayın. Her bağlantı kesildiğinde işlemin gerçekleşmesini istiyorsanız, yeniden bağlandığınızda `onDisconnect` işlemlerini yeniden oluşturmanız gerekir.
SorguKısıtlaması	`QueryConstraint`, bir Veritabanı sorgusu tarafından döndürülen doküman grubunu daraltmak için kullanılır. `QueryConstraintQueryConstraint`
TransactionResult	runTransaction() çözümleme değeri için bir tür.

Arayüzler

Arayüz	Açıklama
DatabaseReference	`DatabaseReference`, Veritabanınızdaki belirli bir konumu temsil eder ve o Veritabanı konumuna veri okumak veya yazmak için kullanılabilir.Veritabanınızdaki kök veya alt konuma `ref()` ya da `ref("child/path")` çağırarak referans verebilirsiniz.Yazma `set()` yöntemi, okuma işlemi ise `on*()` yöntemiyle yapılabilir. https://firebase.google.com/docs/database/web/read-and-Write adresine göz atın.
IteratedDataSnapshot	Yinelenen bir `Reference` öğesinin alt anlık görüntüsünü temsil eder. Anahtar hiçbir zaman tanımsız olmayacak.
ListenOptions (Dinleme Seçenekleri)	İşleyiciyi özelleştirmek için kullanılabilecek seçenek nesneleridir.
Sorgu	`Query`, Veritabanı konumundaki verileri sıralayıp filtreleyerek alt verilerin yalnızca bir alt kümesini dahil eder. Bu, veri koleksiyonunu belirli bir özelliğe (ör. dinozorların yüksekliği) göre sıralamanın yanı sıra büyük bir öğe listesini (örneğin, sohbet mesajları) istemciyle senkronize edilmeye uygun bir sayıyla kısıtlamak için de kullanılabilir. Sorgular, burada tanımlanan filtre yöntemlerinden biri veya daha fazlası zincirlenerek oluşturulur.Tıpkı `DatabaseReference` ürününde olduğu gibi, `on*()` yöntemlerini kullanarak bir `Query` kaynağından veri alabilirsiniz. Yalnızca sorgunuzla eşleşen verilerin alt kümesi için etkinlik ve `DataSnapshot` alırsınız.Daha fazla bilgi için https://firebase.google.com/docs/database/web/lists-of-data#sorting_and_filtering_data adresini ziyaret edin.
ThenableReference	push() ile döndürüldüğünde bir `DatabaseReference` işlevi görebilecek bir `Promise`. Referans hemen kullanılabilir hale gelir ve arka uca yazma işlemi tamamlandığında `Promise` çözümlenir.
İşlem Seçenekleri	İşlemleri yapılandıran bir seçenekler nesnesi.

Tür Takma Adları

Takma Ad yazın	Açıklama
EventType	Şu dizelerden biri: "value", "child_added", "child_changed", "child_removed" veya "child_moved".
QueryConstraintType	Bu SDK'da kullanılabilen farklı sorgu kısıtlamalarını açıklar.
E-posta listesinden çık	İşleyiciyi kaldırmak için çağrılabilen bir geri çağırma.

function(uygulama; ...)

getDatabase(uygulama; url)

Sağlanan FirebaseApp ile ilişkilendirilmiş Realtime Database SDK'sının örneğini döndürür. Herhangi bir örnek yoksa veya mevcut örnek bir özel veritabanı URL'si kullanıyorsa yeni bir örneği varsayılan ayarlarla başlatır.

İmza:

export declare function getDatabase(app?: FirebaseApp, url?: string): Database;

Parametreler

Parametre	Tür	Açıklama
uygulama	FirebaseUygulaması	Döndürülen Realtime Database örneğinin ilişkilendirildiği FirebaseApp örneği.
url	dize	Bağlanılacak Realtime Database örneğinin URL'si. SDK sağlanmazsa Firebase uygulamasının varsayılan örneğine bağlanır.

Şunu döndürür:

Veritabanı

Sağlanan uygulamanın Database örneği.

function(db; ...)

connectDatabaseEmulator(db, ana makine, bağlantı noktası, seçenekler)

Realtime Database emülatörüyle iletişim kurmak için sağlanan örneği değiştirin.

Not: Bu yöntem başka bir işlem yapılmadan önce çağrılmalıdır.

İmza:

export declare function connectDatabaseEmulator(db: Database, host: string, port: number, options?: {
    mockUserToken?: EmulatorMockTokenOptions | string;
}): void;

Parametreler

Parametre	Tür	Açıklama
db	Veritabanı	Değiştirilecek örnek.
düzenleyen	dize	Emülatör ana makinesi (ör. localhost)
bağlantı noktası	sayı	Emülatör bağlantı noktası (ör. 8080)
seçenekler	{ mockUserToken?: EmulatorMockTokenOptions \| string; }

Şunu döndürür:

geçersiz

goÇevrimdışı(db)

Sunucu bağlantısı kesilir (tüm Veritabanı işlemleri çevrimdışı olarak tamamlanır).

İstemci otomatik olarak Veritabanı sunucusuyla kalıcı bir bağlantı sürdürür, bu bağlantı süresiz olarak etkin kalır ve bağlantı kesildiğinde yeniden bağlanır. Bununla birlikte, kalıcı bağlantının istenmeyen olduğu durumlarda istemci bağlantısını kontrol etmek için goOffline() ve goOnline() yöntemleri kullanılabilir.

Çevrimdışıyken, istemci artık veritabanından veri güncellemelerini almaz. Ancak yerel olarak gerçekleştirilen tüm Veritabanı işlemleri etkinlikleri hemen tetiklemeye devam ederek uygulamanızın normal şekilde çalışmaya devam etmesini sağlar. Ayrıca, yerel olarak gerçekleştirilen her işlem otomatik olarak sıraya alınır ve Veritabanı sunucusuna yeniden bağlanıldığında yeniden denenir.

Veritabanına yeniden bağlanmak ve uzaktan etkinlik almaya başlamak için goOnline() adresini ziyaret edin.

İmza:

export declare function goOffline(db: Database): void;

Parametreler

Parametre	Tür	Açıklama
db	Veritabanı	Bağlantısı kesilecek örnek.

Şunu döndürür:

geçersiz

GoOnline(db)

Sunucuya yeniden bağlanır ve çevrimdışı Veritabanı durumunu sunucu durumuyla senkronize eder.

Bu yöntem goOffline() ile etkin bağlantı devre dışı bırakıldıktan sonra kullanılmalıdır. Yeniden bağlandığında istemci uygun verileri iletir ve istemcinizin "yakalaması" için uygun etkinlikleri tetikler. otomatik olarak oluşturur.

İmza:

export declare function goOnline(db: Database): void;

Parametreler

Parametre	Tür	Açıklama
db	Veritabanı	Yeniden bağlanılacak örnek.

Şunu döndürür:

geçersiz

ref(db; yol)

Veritabanındaki, sağlanan yola karşılık gelen konumu temsil eden bir Reference döndürür. Herhangi bir yol sağlanmazsa Reference, Veritabanının köküne işaret eder.

İmza:

export declare function ref(db: Database, path?: string): DatabaseReference;

Parametreler

Parametre	Tür	Açıklama
db	Veritabanı	Referans alınacak veritabanı örneği.
yol	dize	Döndürülen `Reference` öğesinin göstereceği konumu temsil eden isteğe bağlı yol. Sağlanmazsa döndürülen `Reference`, Veritabanının köküne işaret eder.

Şunu döndürür:

DatabaseReference

Bir yol sağlanmışsa sağlanan yolu işaret eden bir Reference. Aksi takdirde, Veritabanının kökünü gösteren bir Reference.

refFromURL(db; url)

Veritabanındaki, sağlanan Firebase URL'sine karşılık gelen konumu temsil eden bir Reference döndürür.

URL geçerli bir Firebase Veritabanı URL'si değilse veya alan adı geçerli Database örneğinden farklı bir alan adına sahipse istisna oluşur.

Tüm sorgu parametrelerinin (orderBy, limitToLast vb.) yoksayıldığını ve döndürülen Reference öğesine uygulanmadığını unutmayın.

İmza:

export declare function refFromURL(db: Database, url: string): DatabaseReference;

Parametreler

Parametre	Tür	Açıklama
db	Veritabanı	Referans alınacak veritabanı örneği.
url	dize	Döndürülen `Reference` parametresinin işaret edeceği Firebase URL'si.

Şunu döndürür:

DatabaseReference

Sağlanan Firebase URL'sini işaret eden bir Reference.

fonksiyon()

forceLongPolling()

Websockets yerine longPolling kullanımını zorunlu kıl. DatabaseURL'de websocket protokolü kullanılırsa bu yoksayılır.

İmza:

export declare function forceLongPolling(): void;

Şunu döndürür:

geçersiz

forceWebSockets()

LongPolling yerine websocket kullanımını zorunlu kıl.

İmza:

export declare function forceWebSockets(): void;

Şunu döndürür:

geçersiz

orderByKey()

Anahtara göre sıralayan yeni bir QueryConstraint oluşturur.

Sorgu sonuçlarını (artan) anahtar değerlerine göre sıralar.

orderByKey() hakkında daha fazla bilgiyi Verileri sıralama bölümünde bulabilirsiniz.

İmza:

export declare function orderByKey(): QueryConstraint;

Şunu döndürür:

SorguKısıtlaması

orderByPriority()

Öncelik sırasına göre sıralayan yeni bir QueryConstraint oluşturur.

Uygulamaların öncelik kullanması gerekmez ancak koleksiyonları normal mülklere göre sıralayabilir (öncelik alternatifleri için Verileri sıralama bölümüne bakın).

İmza:

export declare function orderByPriority(): QueryConstraint;

Şunu döndürür:

SorguKısıtlaması

orderByValue()

Değere göre sıralanan yeni bir QueryConstraint oluşturur.

Bir sorgunun alt öğelerinin tümü skaler değerlerden (dize, sayı veya boole) oluşuyorsa sonuçları (artan) değerlerine göre sıralayabilirsiniz.

orderByValue() hakkında daha fazla bilgiyi Verileri sıralama bölümünde bulabilirsiniz.

İmza:

export declare function orderByValue(): QueryConstraint;

Şunu döndürür:

SorguKısıtlaması

sunucuZaman Damgası()

Firebase sunucuları tarafından belirlenen ve geçerli zaman damgasını (Unix döneminden beri geçen süre, milisaniye cinsinden) otomatik olarak doldurmak için bir yer tutucu değer döndürür.

İmza:

export declare function serverTimestamp(): object;

Şunu döndürür:

nesne

function(delta; ...)

artım(delta)

Geçerli veritabanı değerini sağlanan delta kadar atomik olarak artırmak için kullanılabilecek bir yer tutucu değer döndürür.

İmza:

export declare function increment(delta: number): object;

Parametreler

Parametre	Tür	Açıklama
Delta	sayı	geçerli değer atomik olarak değiştirilecek miktar.

Şunu döndürür:

nesne

Verileri sunucu tarafında temel olarak değiştirmek için bir yer tutucu değer.

işlev(etkin; ...)

allowLogging(etkin, kalıcı)

Hata ayıklama bilgilerini konsola kaydeder.

İmza:

export declare function enableLogging(enabled: boolean, persistent?: boolean): any;

Parametreler

Parametre	Tür	Açıklama
etkin	boolean	`true` ise günlüğe kaydetmeyi etkinleştirir, `false` ise günlük kaydını devre dışı bırakır.
kalıcı	boolean	`true` ise sayfa yenilemeleri arasındaki günlük durumunu hatırlar.

Şunu döndürür:

herhangi bir

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

limitToFirst(sınır)

Belirli ilk sayıda alt çocukla sınırlıysa yeni bir QueryConstraint oluşturur.

limitToFirst() yöntemi, belirli bir geri çağırma için senkronize edilecek maksimum alt yayıncı sayısını ayarlamak için kullanılır. 100 şeklinde bir sınır belirlersek başlangıçta yalnızca en fazla 100 child_added etkinliği alırız. Veritabanımızda depolanan mesaj sayısı 100'den azsa her ileti için bir child_added etkinliği tetiklenir. Ancak 100'den fazla mesajımız varsa sadece sipariş edilen ilk 100 mesaj için bir child_added etkinliği alırız. Öğeler değiştikçe etkin listeden çıkan her öğe için child_removed etkinlik sağlayacağız. Böylece toplam sayı 100'de kalır.

limitToFirst() hakkında daha fazla bilgiyi Verileri filtreleme bölümünde bulabilirsiniz.

İmza:

export declare function limitToFirst(limit: number): QueryConstraint;

Parametreler

Parametre	Tür	Açıklama
sınır	sayı	Bu sorguya dahil edilecek maksimum düğüm sayısı.

Şunu döndürür:

SorguKısıtlaması

limitToLast(sınır)

Yalnızca belirtilen son sayıda alt öğeyi döndürecek şekilde sınırlı yeni bir QueryConstraint oluşturur.

limitToLast() yöntemi, belirli bir geri çağırma için senkronize edilecek maksimum alt yayıncı sayısını ayarlamak için kullanılır. 100 şeklinde bir sınır belirlersek başlangıçta yalnızca en fazla 100 child_added etkinliği alırız. Veritabanımızda depolanan mesaj sayısı 100'den azsa her ileti için bir child_added etkinliği tetiklenir. Ancak 100'den fazla mesajımız varsa sadece sipariş edilen son 100 mesaj için bir child_added etkinliği alırız. Öğeler değiştikçe etkin listeden çıkan her öğe için child_removed etkinlik sağlayacağız. Böylece toplam sayı 100'de kalır.

limitToLast() hakkında daha fazla bilgiyi Verileri filtreleme bölümünde bulabilirsiniz.

İmza:

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

Parametreler

Parametre	Tür	Açıklama
sınır	sayı	Bu sorguya dahil edilecek maksimum düğüm sayısı.

Şunu döndürür:

SorguKısıtlaması

function(logger; ...)

allowLogging(günlük kaydedici)

Hata ayıklama bilgilerini konsola kaydeder.

İmza:

export declare function enableLogging(logger: (message: string) => unknown): any;

Parametreler

Parametre	Tür	Açıklama
logger	(message: dize) => bilinmiyor	İşlerin nasıl günlüğe kaydedildiğini kontrol eden özel bir logger işlevi.

Şunu döndürür:

herhangi bir

function(üst öğe; ...)

alt(üst, yol)

Belirtilen göreli yoldaki konum için bir Reference alır.

Göreli yol, basit bir alt ad (ör. "ada") veya eğik çizgiyle ayrılmış bir yol (örneğin, "ada/ad/ilk") olabilir.

İmza:

export declare function child(parent: DatabaseReference, path: string): DatabaseReference;

Parametreler

Parametre	Tür	Açıklama
üst	DatabaseReference	Üst konumdur.
yol	dize	Bu konumdan istenen alt konuma giden göreli bir yol.

Şunu döndürür:

DatabaseReference

Belirtilen alt konum.

push(üst; değer)

Benzersiz bir anahtar kullanarak yeni bir alt konum oluşturur ve Reference değerini döndürür.

Bu, bir öğe koleksiyonuna veri eklemek için en sık kullanılan kalıptır.

push() işlevine bir değer sağlarsanız bu değer, oluşturulan konuma yazılır. Bir değer iletmezseniz veritabanına hiçbir şey yazılmaz ve alt öğe boş kalır (ancak Reference öğesini başka bir yerde kullanabilirsiniz).

push() tarafından oluşturulan benzersiz anahtarlar geçerli zamana göre sıralandığından ortaya çıkan öğe listesi kronolojik olarak sıralanır. Anahtarlar aynı zamanda tahmin edilemez olacak şekilde tasarlanmıştır (Rastgele 72 entropi biti içerir).

Veri listesine ekleme başlıklı makaleyi inceleyin. Benzersiz Tanımlayıcılar Sağlamanın 2^120 Yolu bölümüne bakın.

İmza:

export declare function push(parent: DatabaseReference, value?: unknown): ThenableReference;

Parametreler

Parametre	Tür	Açıklama
üst	DatabaseReference	Üst konumdur.
value	bilinmiyor	Oluşturulan konumda yazılacak isteğe bağlı değer.

Şunu döndürür:

ThenableReference

Promise ve Reference birleştirilmiş; değeri, yazma tamamlandığında çözümlenir ancak alt konuma Reference olarak hemen kullanılabilir.

function(yol; ...)

OrderByChild(yol)

Belirtilen alt anahtara göre sıralayan yeni bir QueryConstraint oluşturur.

Sorgular aynı anda yalnızca bir anahtara göre sıralanabilir. orderByChild() uygulamasının aynı sorguda birden çok kez çağrılması hatadır.

Firebase sorguları, verilerinizi anında herhangi bir alt anahtara göre sıralamanıza olanak tanır. Bununla birlikte, dizinlerinizin ne olacağını önceden biliyorsanız daha iyi performans için Güvenlik Kurallarınızdaki .indexOn kuralıyla tanımlayabilirsiniz. Daha fazla bilgi için https://firebase.google.com/docs/database/security/indexing-data kuralını inceleyin.

orderByChild() hakkında daha fazla bilgiyi Verileri sıralama bölümünde bulabilirsiniz.

İmza:

export declare function orderByChild(path: string): QueryConstraint;

Parametreler

Parametre	Tür	Açıklama
yol	dize	Sıralama ölçütü:

Şunu döndürür:

SorguKısıtlaması

function(sorgu; ...)

get(sorgu)

Bu sorgu için en güncel sonucu alır.

İmza:

export declare function get(query: Query): Promise<DataSnapshot>;

Parametreler

Parametre	Tür	Açıklama
query	Sorgu	Çalıştırılacak sorgu.

Şunu döndürür:

Promise<DataSnapshot>

Bir değer varsa sonuçta oluşturulan DataSnapshot'ı çözümleyen veya istemci bir değer döndüremiyorsa (ör. sunucuya erişilemiyorsa ve önbelleğe alınan hiçbir şey yoksa) reddeden bir Promise.

off(sorgu, eventType, geri çağırma)

İlgili on*() (onValue, onChildAdded) işleyicisine daha önce ekli bir geri aramayı kaldırır. Not: Bir işleyiciyi kaldırmak için bu yöntemin önerilmez. Bunun yerine, lütfen ilgili on* geri çağırmasından döndürülen geri çağırma işlevini kullanın.

Daha önce on*() ile ekli bir geri çağırmayı ayırın. Bir üst işleyicide off() çağrısı yapıldığında alt düğümlerde kayıtlı işleyiciler otomatik olarak kaldırılmaz. Geri çağırmanın kaldırılması için off(), tüm alt işleyicilerde de çağrılmalıdır.

Bir geri çağırma belirtilmezse belirtilen eventType için tüm geri çağırmalar kaldırılır. Benzer şekilde, herhangi bir eventType belirtilmezse Reference için tüm geri çağırmalar kaldırılır.

Bağımsız dinleyiciler, abonelikten çıkma geri arama çağrılarını çağırarak da kaldırılabilir.

İmza:

export declare function off(query: Query, eventType?: EventType, callback?: (snapshot: DataSnapshot, previousChildName?: string | null) => unknown): void;

Parametreler

Parametre	Tür	Açıklama
query	Sorgu	İşleyicinin kaydedildiği sorgu.
eventType	EventType	Şu dizelerden biri: "value", "child_added", "child_changed", "child_removed" veya "child_moved". Atlanırsa `Reference` için tüm geri çağırmalar kaldırılır.
geri çağırma	(anlık görüntü: DataSnapshot, beforeChildName?: string \| null) => bilinmiyor	Tüm geri çağırmaları kaldırmak için `on()` veya `undefined` işlevine geçirilen geri çağırma işlevi.

Şunu döndürür:

geçersiz

onChildAttach(sorgu, geri çağırma, cancelCallback)

Belirli bir konumdaki veri değişikliklerini dinler.

Bu, Veritabanı'ndaki verileri okumanın birincil yoludur. Geri çağırma işleminiz, ilk veriler için ve veriler her değiştiğinde tekrar tetiklenir. Güncelleme almayı durdurmak için döndürülen e-posta listesinden çıkma geri aramasını çağırın. Daha fazla bilgi için Web'de Veri Alma başlıklı makaleyi inceleyin.

Bu konumdaki her ilk alt öğe için bir onChildAdded etkinliği tetiklenir ve yeni bir alt öğe eklendiğinde tekrar tetiklenir. Geri çağırmaya iletilen DataSnapshot, ilgili alt yayıncının verilerini yansıtır. Sıralama amacıyla, ikinci bir bağımsız değişken, sıralama sırasına göre önceki eşdüzey alt öğenin anahtarını içeren bir dize veya ilk alt öğeyse null iletilir.

İmza:

export declare function onChildAdded(query: Query, callback: (snapshot: DataSnapshot, previousChildName?: string | null) => unknown, cancelCallback?: (error: Error) => unknown): Unsubscribe;

Parametreler

Parametre	Tür	Açıklama
query	Sorgu	Çalıştırılacak sorgu.
geri çağırma	(anlık görüntü: DataSnapshot, beforeChildName?: string \| null) => bilinmiyor	Belirtilen etkinlik gerçekleştiğinde tetiklenen bir geri çağırma. Geri çağırma, sıralama düzenine göre bir DataSnapshot ve önceki alt öğenin anahtarını içeren bir dize ya da ilk alt öğeyse `null` iletir.
iptal	(hata: Hata) => bilinmiyor	İstemcinizin bu verileri okuma izni olmadığı (veya izni olmasına rağmen artık kaybettiği için) etkinlik aboneliğinizin iptal edilmesi halinde bildirilecek isteğe bağlı bir geri arama özelliği. Bu geri çağırma, hatanın neden oluştuğunu belirten bir `Error` nesnesi iletilecek.

Şunu döndürür:

E-posta listesinden çık

İşleyiciyi kaldırmak için çağrılabilen bir işlev.

onChildadded(sorgu, geri arama, seçenekler)

Belirli bir konumdaki veri değişikliklerini dinler.

İmza:

export declare function onChildAdded(query: Query, callback: (snapshot: DataSnapshot, previousChildName: string | null) => unknown, options: ListenOptions): Unsubscribe;

Parametreler

Parametre	Tür	Açıklama
query	Sorgu	Çalıştırılacak sorgu.
geri çağırma	(anlık görüntü: DataSnapshot, beforeChildName: string \| null) => bilinmiyor	Belirtilen etkinlik gerçekleştiğinde tetiklenen bir geri çağırma. Geri çağırma, sıralama düzenine göre bir DataSnapshot ve önceki alt öğenin anahtarını içeren bir dize ya da ilk alt öğeyse `null` iletir.
seçenekler	ListenOptions (Dinleme Seçenekleri)	`onlyOnce` hizmetini yapılandırmak için kullanılabilecek ve ilk çağrısından sonra işleyiciyi kaldıran bir nesnedir.

Şunu döndürür:

E-posta listesinden çık

İşleyiciyi kaldırmak için çağrılabilen bir işlev.

onChildAttach(sorgu, geri çağırma, cancelCallback, options)

Belirli bir konumdaki veri değişikliklerini dinler.

İmza:

export declare function onChildAdded(query: Query, callback: (snapshot: DataSnapshot, previousChildName: string | null) => unknown, cancelCallback: (error: Error) => unknown, options: ListenOptions): Unsubscribe;

Parametreler

Parametre	Tür	Açıklama
query	Sorgu	Çalıştırılacak sorgu.
geri çağırma	(anlık görüntü: DataSnapshot, beforeChildName: string \| null) => bilinmiyor	Belirtilen etkinlik gerçekleştiğinde tetiklenen bir geri çağırma. Geri çağırma, sıralama düzenine göre bir DataSnapshot ve önceki alt öğenin anahtarını içeren bir dize ya da ilk alt öğeyse `null` iletir.
iptal	(hata: Hata) => bilinmiyor	İstemcinizin bu verileri okuma izni olmadığı (veya izni olmasına rağmen artık kaybettiği için) etkinlik aboneliğinizin iptal edilmesi halinde bildirilecek isteğe bağlı bir geri arama özelliği. Bu geri çağırma, hatanın neden oluştuğunu belirten bir `Error` nesnesi iletilecek.
seçenekler	ListenOptions (Dinleme Seçenekleri)	`onlyOnce` hizmetini yapılandırmak için kullanılabilecek ve ilk çağrısından sonra işleyiciyi kaldıran bir nesnedir.

Şunu döndürür:

E-posta listesinden çık

İşleyiciyi kaldırmak için çağrılabilen bir işlev.

onChildChanged(sorgu; geri çağırma, cancelCallback)

Belirli bir konumdaki veri değişikliklerini dinler.

Bir alt öğede (veya alt öğelerinde) depolanan veriler değiştiğinde bir onChildChanged etkinliği tetiklenir. Tek bir child_changed etkinliğinin, alt öğe için birden fazla değişikliği temsil edebileceğini unutmayın. Geri çağırmaya iletilen DataSnapshot, yeni alt içerikleri barındırır. Sıralama amacıyla geri çağırma, ikinci bir bağımsız değişken de iletilir. Bu bağımsız değişken, sıralama düzenine göre önceki eşdüzey alt öğenin anahtarını içeren bir dizedir. İlk alt değişkense null de iletilir.

İmza:

export declare function onChildChanged(query: Query, callback: (snapshot: DataSnapshot, previousChildName: string | null) => unknown, cancelCallback?: (error: Error) => unknown): Unsubscribe;

Parametreler

Parametre	Tür	Açıklama
query	Sorgu	Çalıştırılacak sorgu.
geri çağırma	(anlık görüntü: DataSnapshot, beforeChildName: string \| null) => bilinmiyor	Belirtilen etkinlik gerçekleştiğinde tetiklenen bir geri çağırma. Geri çağırma, sıralama düzenine göre bir DataSnapshot ve önceki alt öğenin anahtarını içeren bir dize ya da ilk alt öğeyse `null` iletir.
iptal	(hata: Hata) => bilinmiyor	İstemcinizin bu verileri okuma izni olmadığı (veya izni olmasına rağmen artık kaybettiği için) etkinlik aboneliğinizin iptal edilmesi halinde bildirilecek isteğe bağlı bir geri arama özelliği. Bu geri çağırma, hatanın neden oluştuğunu belirten bir `Error` nesnesi iletilecek.

Şunu döndürür:

E-posta listesinden çık

İşleyiciyi kaldırmak için çağrılabilen bir işlev.

onChildChanged(sorgu, geri arama, seçenekler)

Belirli bir konumdaki veri değişikliklerini dinler.

İmza:

export declare function onChildChanged(query: Query, callback: (snapshot: DataSnapshot, previousChildName: string | null) => unknown, options: ListenOptions): Unsubscribe;

Parametreler

Parametre	Tür	Açıklama
query	Sorgu	Çalıştırılacak sorgu.
geri çağırma	(anlık görüntü: DataSnapshot, beforeChildName: string \| null) => bilinmiyor	Belirtilen etkinlik gerçekleştiğinde tetiklenen bir geri çağırma. Geri çağırma, sıralama düzenine göre bir DataSnapshot ve önceki alt öğenin anahtarını içeren bir dize ya da ilk alt öğeyse `null` iletir.
seçenekler	ListenOptions (Dinleme Seçenekleri)	`onlyOnce` hizmetini yapılandırmak için kullanılabilecek ve ilk çağrısından sonra işleyiciyi kaldıran bir nesnedir.

Şunu döndürür:

E-posta listesinden çık

İşleyiciyi kaldırmak için çağrılabilen bir işlev.

onChildChanged(sorgu; geri çağırma, cancelCallback, options)

Belirli bir konumdaki veri değişikliklerini dinler.

İmza:

export declare function onChildChanged(query: Query, callback: (snapshot: DataSnapshot, previousChildName: string | null) => unknown, cancelCallback: (error: Error) => unknown, options: ListenOptions): Unsubscribe;

Parametreler

Parametre	Tür	Açıklama
query	Sorgu	Çalıştırılacak sorgu.
geri çağırma	(anlık görüntü: DataSnapshot, beforeChildName: string \| null) => bilinmiyor	Belirtilen etkinlik gerçekleştiğinde tetiklenen bir geri çağırma. Geri çağırma, sıralama düzenine göre bir DataSnapshot ve önceki alt öğenin anahtarını içeren bir dize ya da ilk alt öğeyse `null` iletir.
iptal	(hata: Hata) => bilinmiyor	İstemcinizin bu verileri okuma izni olmadığı (veya izni olmasına rağmen artık kaybettiği için) etkinlik aboneliğinizin iptal edilmesi halinde bildirilecek isteğe bağlı bir geri arama özelliği. Bu geri çağırma, hatanın neden oluştuğunu belirten bir `Error` nesnesi iletilecek.
seçenekler	ListenOptions (Dinleme Seçenekleri)	`onlyOnce` hizmetini yapılandırmak için kullanılabilecek ve ilk çağrısından sonra işleyiciyi kaldıran bir nesnedir.

Şunu döndürür:

E-posta listesinden çık

İşleyiciyi kaldırmak için çağrılabilen bir işlev.

onChildMoved(sorgu, geri çağırma, cancelCallback)

Belirli bir konumdaki veri değişikliklerini dinler.

Alt yayıncının sıralama düzeni, eşdüzeylerine göre konumu değişecek şekilde değiştiğinde onChildMoved etkinliği tetiklenir. Geri çağırmaya iletilen DataSnapshot, taşınan alt kullanıcının verileri içindir. Ayrıca, sıralama sırasına göre önceki eşdüzey alt öğenin anahtarını içeren bir dize olan ikinci bir bağımsız değişken veya ilk alt öğe ise null iletilir.

İmza:

export declare function onChildMoved(query: Query, callback: (snapshot: DataSnapshot, previousChildName: string | null) => unknown, cancelCallback?: (error: Error) => unknown): Unsubscribe;

Parametreler

Parametre	Tür	Açıklama
query	Sorgu	Çalıştırılacak sorgu.
geri çağırma	(anlık görüntü: DataSnapshot, beforeChildName: string \| null) => bilinmiyor	Belirtilen etkinlik gerçekleştiğinde tetiklenen bir geri çağırma. Geri çağırma, sıralama düzenine göre bir DataSnapshot ve önceki alt öğenin anahtarını içeren bir dize ya da ilk alt öğeyse `null` iletir.
iptal	(hata: Hata) => bilinmiyor	İstemcinizin bu verileri okuma izni olmadığı (veya izni olmasına rağmen artık kaybettiği için) etkinlik aboneliğinizin iptal edilmesi halinde bildirilecek isteğe bağlı bir geri arama özelliği. Bu geri çağırma, hatanın neden oluştuğunu belirten bir `Error` nesnesi iletilecek.

Şunu döndürür:

E-posta listesinden çık

İşleyiciyi kaldırmak için çağrılabilen bir işlev.

onChildMoved(sorgu, geri arama, seçenekler)

Belirli bir konumdaki veri değişikliklerini dinler.

İmza:

export declare function onChildMoved(query: Query, callback: (snapshot: DataSnapshot, previousChildName: string | null) => unknown, options: ListenOptions): Unsubscribe;

Parametreler

Parametre	Tür	Açıklama
query	Sorgu	Çalıştırılacak sorgu.
geri çağırma	(anlık görüntü: DataSnapshot, beforeChildName: string \| null) => bilinmiyor	Belirtilen etkinlik gerçekleştiğinde tetiklenen bir geri çağırma. Geri çağırma, sıralama düzenine göre bir DataSnapshot ve önceki alt öğenin anahtarını içeren bir dize ya da ilk alt öğeyse `null` iletir.
seçenekler	ListenOptions (Dinleme Seçenekleri)	`onlyOnce` hizmetini yapılandırmak için kullanılabilecek ve ilk çağrısından sonra işleyiciyi kaldıran bir nesnedir.

Şunu döndürür:

E-posta listesinden çık

İşleyiciyi kaldırmak için çağrılabilen bir işlev.

onChildMoved(sorgu, geri çağırma, cancelCallback, options)

Belirli bir konumdaki veri değişikliklerini dinler.

İmza:

export declare function onChildMoved(query: Query, callback: (snapshot: DataSnapshot, previousChildName: string | null) => unknown, cancelCallback: (error: Error) => unknown, options: ListenOptions): Unsubscribe;

Parametreler

Parametre	Tür	Açıklama
query	Sorgu	Çalıştırılacak sorgu.
geri çağırma	(anlık görüntü: DataSnapshot, beforeChildName: string \| null) => bilinmiyor	Belirtilen etkinlik gerçekleştiğinde tetiklenen bir geri çağırma. Geri çağırma, sıralama düzenine göre bir DataSnapshot ve önceki alt öğenin anahtarını içeren bir dize ya da ilk alt öğeyse `null` iletir.
iptal	(hata: Hata) => bilinmiyor	İstemcinizin bu verileri okuma izni olmadığı (veya izni olmasına rağmen artık kaybettiği için) etkinlik aboneliğinizin iptal edilmesi halinde bildirilecek isteğe bağlı bir geri arama özelliği. Bu geri çağırma, hatanın neden oluştuğunu belirten bir `Error` nesnesi iletilecek.
seçenekler	ListenOptions (Dinleme Seçenekleri)	`onlyOnce` hizmetini yapılandırmak için kullanılabilecek ve ilk çağrısından sonra işleyiciyi kaldıran bir nesnedir.

Şunu döndürür:

E-posta listesinden çık

İşleyiciyi kaldırmak için çağrılabilen bir işlev.

onChildRemoved(sorgu, geri çağırma, cancelCallback)

Belirli bir konumdaki veri değişikliklerini dinler.

Her alt öğe kaldırıldığında bir onChildRemoved etkinliği tetiklenir. Geri çağırmaya iletilen DataSnapshot, kaldırılan alt hesabın eski verileri olur. Çocuklar şu durumlarda kaldırılır:

bir istemci bu alt veya üst öğelerinden biri için açıkça remove() (istemci, bu alt öğe veya üst öğelerinden biri için set(null) çağırır) ve tüm alt öğeleri kaldırılmış olur ve geçerli bir sorgu vardır ve artık alt öğe filtrelenir (çünkü sıralama düzeni değiştiği ya da maksimum sınıra ulaşıldığı için).

İmza:

export declare function onChildRemoved(query: Query, callback: (snapshot: DataSnapshot) => unknown, cancelCallback?: (error: Error) => unknown): Unsubscribe;

Parametreler

Parametre	Tür	Açıklama
query	Sorgu	Çalıştırılacak sorgu.
geri çağırma	(anlık görüntü: DataSnapshot) => bilinmiyor	Belirtilen etkinlik gerçekleştiğinde tetiklenen bir geri çağırma. Geri çağırma, sıralama düzenine göre bir DataSnapshot ve önceki alt öğenin anahtarını içeren bir dize ya da ilk alt öğeyse `null` iletir.
iptal	(hata: Hata) => bilinmiyor	İstemcinizin bu verileri okuma izni olmadığı (veya izni olmasına rağmen artık kaybettiği için) etkinlik aboneliğinizin iptal edilmesi halinde bildirilecek isteğe bağlı bir geri arama özelliği. Bu geri çağırma, hatanın neden oluştuğunu belirten bir `Error` nesnesi iletilecek.

Şunu döndürür:

E-posta listesinden çık

İşleyiciyi kaldırmak için çağrılabilen bir işlev.

onChildRemoved(sorgu, geri arama, seçenekler)

Belirli bir konumdaki veri değişikliklerini dinler.

bir istemci bu alt veya üst öğelerinden biri için açıkça remove() (istemci, bu alt öğe veya üst öğelerinden biri için set(null) çağırır) ve tüm alt öğeleri kaldırılmış olur ve geçerli bir sorgu vardır ve artık alt öğe filtrelenir (çünkü sıralama düzeni değiştiği ya da maksimum sınıra ulaşıldığı için).

İmza:

export declare function onChildRemoved(query: Query, callback: (snapshot: DataSnapshot) => unknown, options: ListenOptions): Unsubscribe;

Parametreler

Parametre	Tür	Açıklama
query	Sorgu	Çalıştırılacak sorgu.
geri çağırma	(anlık görüntü: DataSnapshot) => bilinmiyor	Belirtilen etkinlik gerçekleştiğinde tetiklenen bir geri çağırma. Geri çağırma, sıralama düzenine göre bir DataSnapshot ve önceki alt öğenin anahtarını içeren bir dize ya da ilk alt öğeyse `null` iletir.
seçenekler	ListenOptions (Dinleme Seçenekleri)	`onlyOnce` hizmetini yapılandırmak için kullanılabilecek ve ilk çağrısından sonra işleyiciyi kaldıran bir nesnedir.

Şunu döndürür:

E-posta listesinden çık

İşleyiciyi kaldırmak için çağrılabilen bir işlev.

onChildRemoved(sorgu, geri çağırma, cancelCallback, options)

Belirli bir konumdaki veri değişikliklerini dinler.

bir istemci bu alt veya üst öğelerinden biri için açıkça remove() (istemci, bu alt öğe veya üst öğelerinden biri için set(null) çağırır) ve tüm alt öğeleri kaldırılmış olur ve geçerli bir sorgu vardır ve artık alt öğe filtrelenir (çünkü sıralama düzeni değiştiği ya da maksimum sınıra ulaşıldığı için).

İmza:

export declare function onChildRemoved(query: Query, callback: (snapshot: DataSnapshot) => unknown, cancelCallback: (error: Error) => unknown, options: ListenOptions): Unsubscribe;

Parametreler

Parametre	Tür	Açıklama
query	Sorgu	Çalıştırılacak sorgu.
geri çağırma	(anlık görüntü: DataSnapshot) => bilinmiyor	Belirtilen etkinlik gerçekleştiğinde tetiklenen bir geri çağırma. Geri çağırma, sıralama düzenine göre bir DataSnapshot ve önceki alt öğenin anahtarını içeren bir dize ya da ilk alt öğeyse `null` iletir.
iptal	(hata: Hata) => bilinmiyor	İstemcinizin bu verileri okuma izni olmadığı (veya izni olmasına rağmen artık kaybettiği için) etkinlik aboneliğinizin iptal edilmesi halinde bildirilecek isteğe bağlı bir geri arama özelliği. Bu geri çağırma, hatanın neden oluştuğunu belirten bir `Error` nesnesi iletilecek.
seçenekler	ListenOptions (Dinleme Seçenekleri)	`onlyOnce` hizmetini yapılandırmak için kullanılabilecek ve ilk çağrısından sonra işleyiciyi kaldıran bir nesnedir.

Şunu döndürür:

E-posta listesinden çık

İşleyiciyi kaldırmak için çağrılabilen bir işlev.

onValue(sorgu, geri çağırma, cancelCallback)

Belirli bir konumdaki veri değişikliklerini dinler.

Bir onValue etkinliği, bu konumda depolanan ilk verilerle bir kez tetiklenir ve ardından veriler her değiştiğinde tekrar tetiklenir. Geri çağırmaya iletilen DataSnapshot, on() çağrıldığı konum için olacaktır. Bu işlem, içeriğin tamamı senkronize edilene kadar tetiklenmez. Konumda veri yoksa boş bir DataSnapshot ile tetiklenir (val(), null değerini döndürür).

İmza:

export declare function onValue(query: Query, callback: (snapshot: DataSnapshot) => unknown, cancelCallback?: (error: Error) => unknown): Unsubscribe;

Parametreler

Parametre	Tür	Açıklama
query	Sorgu	Çalıştırılacak sorgu.
geri çağırma	(anlık görüntü: DataSnapshot) => bilinmiyor	Belirtilen etkinlik gerçekleştiğinde tetiklenen bir geri çağırma. Geri çağırmaya bir DataSnapshot aktarılır.
iptal	(hata: Hata) => bilinmiyor	İstemcinizin bu verileri okuma izni olmadığı (veya izni olmasına rağmen artık kaybettiği için) etkinlik aboneliğinizin iptal edilmesi halinde bildirilecek isteğe bağlı bir geri arama özelliği. Bu geri çağırma, hatanın neden oluştuğunu belirten bir `Error` nesnesi iletilecek.

Şunu döndürür:

E-posta listesinden çık

İşleyiciyi kaldırmak için çağrılabilen bir işlev.

onValue(sorgu; geri arama; seçenekler)

Belirli bir konumdaki veri değişikliklerini dinler.

İmza:

export declare function onValue(query: Query, callback: (snapshot: DataSnapshot) => unknown, options: ListenOptions): Unsubscribe;

Parametreler

Parametre	Tür	Açıklama
query	Sorgu	Çalıştırılacak sorgu.
geri çağırma	(anlık görüntü: DataSnapshot) => bilinmiyor	Belirtilen etkinlik gerçekleştiğinde tetiklenen bir geri çağırma. Geri çağırmaya bir DataSnapshot aktarılır.
seçenekler	ListenOptions (Dinleme Seçenekleri)	`onlyOnce` hizmetini yapılandırmak için kullanılabilecek ve ilk çağrısından sonra işleyiciyi kaldıran bir nesnedir.

Şunu döndürür:

E-posta listesinden çık

İşleyiciyi kaldırmak için çağrılabilen bir işlev.

onValue(sorgu; geri arama, iptalCallback, seçenekler)

Belirli bir konumdaki veri değişikliklerini dinler.

İmza:

export declare function onValue(query: Query, callback: (snapshot: DataSnapshot) => unknown, cancelCallback: (error: Error) => unknown, options: ListenOptions): Unsubscribe;

Parametreler

Parametre	Tür	Açıklama
query	Sorgu	Çalıştırılacak sorgu.
geri çağırma	(anlık görüntü: DataSnapshot) => bilinmiyor	Belirtilen etkinlik gerçekleştiğinde tetiklenen bir geri çağırma. Geri çağırmaya bir DataSnapshot aktarılır.
iptal	(hata: Hata) => bilinmiyor	İstemcinizin bu verileri okuma izni olmadığı (veya izni olmasına rağmen artık kaybettiği için) etkinlik aboneliğinizin iptal edilmesi halinde bildirilecek isteğe bağlı bir geri arama özelliği. Bu geri çağırma, hatanın neden oluştuğunu belirten bir `Error` nesnesi iletilecek.
seçenekler	ListenOptions (Dinleme Seçenekleri)	`onlyOnce` hizmetini yapılandırmak için kullanılabilecek ve ilk çağrısından sonra işleyiciyi kaldıran bir nesnedir.

Şunu döndürür:

E-posta listesinden çık

İşleyiciyi kaldırmak için çağrılabilen bir işlev.

sorgu(sorgu; queryConstraints)

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

İmza:

export declare function query(query: Query, ...queryConstraints: QueryConstraint[]): Query;

Parametreler

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

Şunu döndürür:

Sorgu

İstisnalar

değerini girin.

function(ref; ...)

onBağlantıyı kesme(ref)

Bir OnDisconnect nesnesini döndürür. Bu nesnenin nasıl kullanılacağı hakkında daha fazla bilgi için JavaScript'te Çevrimdışı Özellikleri Etkinleştirme konusuna bakın.

İmza:

export declare function onDisconnect(ref: DatabaseReference): OnDisconnect;

Parametreler

Parametre	Tür	Açıklama
referans	DatabaseReference	OnConnection tetikleyicilerinin ekleneceği referans.

Şunu döndürür:

Bağlantıyı Kes

remove(ref)

Bu Veritabanı konumundaki verileri kaldırır.

Alt konumlardaki tüm veriler de silinir.

Kaldırma işleminin etkisi hemen görünür ve ilgili etkinlik "value" (değer) gösterilir. tetiklenecektir. Kaldırma işleminin Firebase sunucularıyla senkronizasyonu da başlatılır ve döndürülen Vaat, işlem tamamlandığında çözüme ulaştırılır. Sağlanmışsa, onComplete geri çağırması senkronizasyon bittikten sonra eşzamansız olarak çağrılır.

İmza:

export declare function remove(ref: DatabaseReference): Promise<void>;

Parametreler

Parametre	Tür	Açıklama
referans	DatabaseReference	Kaldırılacak konum.

Şunu döndürür:

Taahhüt<void>

Sunucudan kaldırma işlemi tamamlandığında çözümlenir.

runTransaction(ref; transactionUpdate; seçenekler)

Bu konumdaki verileri anomik olarak değiştirir.

Bu konumdaki verileri atomik olarak değiştirin. Önceki değerinden bağımsız olarak verilerin üzerine yazan normal set() yönteminin aksine runTransaction(), mevcut değeri yeni bir değerle değiştirmek için kullanılır. Böylece, aynı konuma aynı anda yazan diğer istemcilerle çakışma olmaması sağlanır.

Bunu yapmak için runTransaction() ürününe mevcut değeri yeni bir değere dönüştürmek için kullanılan bir güncelleme işlevi iletirsiniz. Başka bir istemci yeni değeriniz başarıyla yazılmadan önce konuma yazarsa güncelleme işleviniz yeni geçerli değerle tekrar çağrılır ve yazma işlemi yeniden denenir. Bu durum, yazma işleminiz çakışma olmadan başarılı olana veya güncelleme işlevinizden bir değer döndürmeyerek işlemi iptal edene kadar tekrar tekrar gerçekleşir.

İmza:

export declare function runTransaction(ref: DatabaseReference, transactionUpdate: (currentData: any) => unknown, options?: TransactionOptions): Promise<TransactionResult>;

Parametreler

Parametre	Tür	Açıklama
referans	DatabaseReference	Atom olarak değiştirilecek konum.
transactionUpdate	(currentData: any) => bilinmiyor	Geliştirici tarafından sağlanan ve bu konumda saklanan mevcut verileri iletecek bir işlev (JavaScript nesnesi olarak). İşlev, yazılmasını istediği yeni değeri (JavaScript nesnesi olarak) döndürmelidir. `undefined` döndürülürse (yani bağımsız değişken olmadan döndürürseniz) işlem iptal edilir ve bu konumdaki veriler değiştirilmez.
seçenekler	İşlem Seçenekleri	İşlemleri yapılandıran bir seçenekler nesnesi.

Şunu döndürür:

Promise<TransactionResult>

Başarılı ve başarısız durumları ele almak için onComplete geri çağırması yerine isteğe bağlı olarak kullanılabilecek bir Promise.

set(ref; değer)

Bu Veritabanı konumuna veri yazar.

Bu işlem, bu konumdaki ve tüm alt konumlardaki verilerin üzerine yazacaktır.

Yazma işleminin etkisi hemen görünür ve ilgili etkinlikler ("value", "child_added" vb.) tetiklenir. Verilerin Firebase sunucularıyla senkronizasyonu da başlatılır ve döndürülen Promise işlem tamamlandığında çözüme kavuşturulur. Sağlanmışsa onComplete geri çağırması, senkronizasyon bittikten sonra eşzamansız olarak çağrılır.

Yeni değer için null iletmek, remove() yöntemini çağırmakla eşdeğerdir; diğer bir deyişle, bu konumdaki ve tüm alt konumlardaki tüm veriler silinecek.

set(), bu konumda depolanan tüm öncelikleri kaldırır. Bu nedenle önceliğin korunması isteniyorsa bunun yerine setWithPriority() yönergesini kullanmanız gerekir.

Verileri set() ile değiştirmenin söz konusu konumdaki bekleyen tüm işlemleri iptal edeceğini unutmayın. Bu nedenle, aynı verileri değiştirmek için set() ve transaction() öğelerini birlikte kullanırken çok dikkatli olmalısınız.

Tek bir set() tek bir "value" oluşturur set() etkinliğinin gerçekleştirildiği yerdeki etkinliktir.

İmza:

export declare function set(ref: DatabaseReference, value: unknown): Promise<void>;

Parametreler

Parametre	Tür	Açıklama
referans	DatabaseReference	Yazılacak konum.
value	bilinmiyor	Yazılacak değer (dize, sayı, boole, nesne, dizi veya null).

Şunu döndürür:

Taahhüt<void>

Sunucuya yazma tamamlandığında çözümlenir.

setPriority(ref; öncelik)

Bu Veritabanı konumundaki verilere öncelik verir.

Uygulamaların öncelik kullanması gerekmez ancak koleksiyonları normal mülklere göre sıralayabilir (Verileri sıralama ve filtreleme bölümüne bakın).

İmza:

export declare function setPriority(ref: DatabaseReference, priority: string | number | null): Promise<void>;

Parametreler

Parametre	Tür	Açıklama
referans	DatabaseReference	Yazılacak konum.
öncelik	dize \| sayı \| boş	Yazılacak öncelik (dize, sayı veya null).

Şunu döndürür:

Taahhüt<void>

Sunucuya yazma tamamlandığında çözümlenir.

setWithPriority(ref; değer; öncelik)

Verileri Veritabanı konumuna yazar. set() gibidir ancak bu verilerin önceliğini de belirtir.

Uygulamaların öncelik kullanması gerekmez ancak koleksiyonları normal mülklere göre sıralayabilir (Verileri sıralama ve filtreleme bölümüne bakın).

İmza:

export declare function setWithPriority(ref: DatabaseReference, value: unknown, priority: string | number | null): Promise<void>;

Parametreler

Parametre	Tür	Açıklama
referans	DatabaseReference	Yazılacak konum.
value	bilinmiyor	Yazılacak değer (dize, sayı, boole, nesne, dizi veya null).
öncelik	dize \| sayı \| boş	Yazılacak öncelik (dize, sayı veya null).

Şunu döndürür:

Taahhüt<void>

Sunucuya yazma tamamlandığında çözümlenir.

güncelleme(başvuru, değerler)

Veritabanına aynı anda birden fazla değer yazar.

values bağımsız değişkeni, Veritabanına birlikte yazılacak birden fazla özellik-değer çifti içeriyor. Her alt mülk, basit bir özellik (ör. "ad") veya geçerli konumdan güncellenecek verilere giden göreli bir yol (ör. "ad/ad") olabilir.

set() yönteminin aksine update(), geçerli konumdaki tüm alt mülkleri değiştirmek yerine yalnızca geçerli konumdaki başvurulan özellikleri seçerek güncellemek için kullanılabilir.

Tek bir update() tek bir "value" oluşturur Değiştirilen çocuk sayısına bakılmaksızın, update() işleminin gerçekleştirildiği konumdaki etkinlik.

Verileri update() ile değiştirmenin söz konusu konumdaki bekleyen tüm işlemleri iptal edeceğini unutmayın. Bu nedenle, aynı verileri değiştirmek için update() ve transaction() öğelerini birlikte kullanırken çok dikkatli olmalısınız.

update() adlı cihaza null aktarmak bu konumdaki verilerin kaldırılmasına neden olur.

Çoklu konum güncellemeleri ve daha fazlasıyla tanışın başlıklı makaleyi inceleyin.

İmza:

export declare function update(ref: DatabaseReference, values: object): Promise<void>;

Parametreler

Parametre	Tür	Açıklama
referans	DatabaseReference	Yazılacak konum.
values	nesne	Birden çok değer içeren nesne.

Şunu döndürür:

Taahhüt<void>

Sunucuda güncelleme tamamlandığında çözümlenir.

fonksiyon(değer; ...)

endAt(değer; anahtar)

Belirtilen bitiş noktasıyla bir QueryConstraint oluşturur.

startAt(), startAfter(), endBefore(), endAt() ve equalTo() özelliklerini kullanmak, sorgularınız için rastgele başlangıç ve bitiş noktaları seçmenize olanak tanır.

Bitiş noktası kapsayıcı olduğundan tam olarak belirtilen değere sahip alt öğeler sorguya dahil edilir. İsteğe bağlı anahtar bağımsız değişkeni, sorgunun aralığını daha fazla sınırlamak için kullanılabilir. Belirtilirse, tam olarak belirtilen değere sahip alt öğelerin de belirtilen anahtardan küçük veya ona eşit bir anahtar adına sahip olması gerekir.

endAt() hakkında daha fazla bilgiyi Verileri filtreleme bölümünde bulabilirsiniz.

İmza:

export declare function endAt(value: number | string | boolean | null, key?: string): QueryConstraint;

Parametreler

Parametre	Tür	Açıklama
value	sayı \| dize \| boole \| boş	Bitiş tarihi. Bağımsız değişken türü, bu sorguda hangi `orderBy()` işlevinin kullanıldığına bağlıdır. `orderBy``()` türüyle eşleşen bir değer belirtin. `orderByKey()` ile birlikte kullanıldığında değer bir dize olmalıdır.
anahtar	dize	Daha önce belirtilen önceliğe sahip alt öğeler arasında sonlanacak alt anahtar. Bu bağımsız değişkene yalnızca alt öğe, değer veya önceliğe göre sıralama yapılıyorsa izin verilir.

Şunu döndürür:

SorguKısıtlaması

endBefore(değer; anahtar)

Belirtilen bitiş noktasıyla (hariç) bir QueryConstraint oluşturur.

startAt(), startAfter(), endBefore(), endAt() ve equalTo() özelliklerini kullanmak, sorgularınız için rastgele başlangıç ve bitiş noktaları seçmenize olanak tanır.

Bitiş noktası dışlayıcıdır. Yalnızca bir değer sağlanırsa belirtilen değerden düşük bir değere sahip alt öğeler sorguya dahil edilir. Bir anahtar belirtilirse alt öğelerin, belirtilen değerden küçük veya ona eşit bir değere ve belirtilen anahtardan küçük bir anahtar adına sahip olması gerekir.

İmza:

export declare function endBefore(value: number | string | boolean | null, key?: string): QueryConstraint;

Parametreler

Parametre	Tür	Açıklama
value	sayı \| dize \| boole \| boş	Kendinden önce bitecek değer. Bağımsız değişken türü, bu sorguda hangi `orderBy()` işlevinin kullanıldığına bağlıdır. `orderBy``()` türüyle eşleşen bir değer belirtin. `orderByKey()` ile birlikte kullanıldığında değer bir dize olmalıdır.
anahtar	dize	Daha önce belirtilen önceliğe sahip alt öğeler arasında önce sona erecek alt anahtar. Bu bağımsız değişkene yalnızca alt öğe, değer veya önceliğe göre sıralama yapılıyorsa izin verilir.

Şunu döndürür:

SorguKısıtlaması

eşittir(değer; anahtar)

Belirtilen değerle eşleşen alt öğeleri içeren bir QueryConstraint oluşturur.

startAt(), startAfter(), endBefore(), endAt() ve equalTo() özelliklerini kullanmak, sorgularınız için rastgele başlangıç ve bitiş noktaları seçmenize olanak tanır.

İsteğe bağlı anahtar bağımsız değişkeni, sorgunun aralığını daha fazla sınırlamak için kullanılabilir. Belirtilmişse tam olarak belirtilen değere sahip alt yayıncılar, anahtar adı olarak belirtilen anahtarı da tam olarak kullanmalıdır. Bu özellik, aynı değer için çok sayıda eşleşme içeren sonuç kümelerini filtrelemek için kullanılabilir.

equalTo() hakkında daha fazla bilgiyi Verileri filtreleme bölümünde bulabilirsiniz.

İmza:

export declare function equalTo(value: number | string | boolean | null, key?: string): QueryConstraint;

Parametreler

Parametre	Tür	Açıklama
value	sayı \| dize \| boole \| boş	Eşleştirilecek değerdir. Bağımsız değişken türü, bu sorguda hangi `orderBy()` işlevinin kullanıldığına bağlıdır. `orderBy``()` türüyle eşleşen bir değer belirtin. `orderByKey()` ile birlikte kullanıldığında değer bir dize olmalıdır.
anahtar	dize	Daha önce belirtilen önceliğe sahip alt öğeler arasında başlatılacak alt anahtar. Bu bağımsız değişkene yalnızca alt öğe, değer veya önceliğe göre sıralama yapılıyorsa izin verilir.

Şunu döndürür:

SorguKısıtlaması

startAfter(değer; anahtar)

Belirtilen başlangıç noktasıyla (hariç) bir QueryConstraint oluşturur.

startAt(), startAfter(), endBefore(), endAt() ve equalTo() özelliklerini kullanmak, sorgularınız için rastgele başlangıç ve bitiş noktaları seçmenize olanak tanır.

Başlangıç noktası dışlayıcıdır. Yalnızca değer sağlanırsa belirtilen değerden büyük olan alt öğeler sorguya dahil edilir. Bir anahtar belirtilirse alt öğelerin, belirtilen değerden büyük veya ona eşit bir değere ve belirtilen anahtardan büyük bir anahtar adına sahip olması gerekir.

İmza:

export declare function startAfter(value: number | string | boolean | null, key?: string): QueryConstraint;

Parametreler

Parametre	Tür	Açıklama
value	sayı \| dize \| boole \| boş	Sonra başlayacak değer. Bağımsız değişken türü, bu sorguda hangi `orderBy()` işlevinin kullanıldığına bağlıdır. `orderBy``()` türüyle eşleşen bir değer belirtin. `orderByKey()` ile birlikte kullanıldığında değer bir dize olmalıdır.
anahtar	dize	Sonra başlanacak alt anahtar. Bu bağımsız değişkene yalnızca alt öğe, değer veya önceliğe göre sıralama yapılıyorsa izin verilir.

Şunu döndürür:

SorguKısıtlaması

startAt(değer; anahtar)

Belirtilen başlangıç noktasıyla bir QueryConstraint oluşturur.

startAt(), startAfter(), endBefore(), endAt() ve equalTo() özelliklerini kullanmak, sorgularınız için rastgele başlangıç ve bitiş noktaları seçmenize olanak tanır.

Başlangıç noktası kapsayıcı olduğundan tam olarak belirtilen değere sahip alt öğeler sorguya dahil edilir. İsteğe bağlı anahtar bağımsız değişkeni, sorgunun aralığını daha fazla sınırlamak için kullanılabilir. Belirtilirse, tam olarak belirtilen değere sahip alt öğelerin de belirtilen anahtardan büyük veya ona eşit bir anahtar adına sahip olması gerekir.

startAt() hakkında daha fazla bilgiyi Verileri filtreleme bölümünde bulabilirsiniz.

İmza:

export declare function startAt(value?: number | string | boolean | null, key?: string): QueryConstraint;

Parametreler

Parametre	Tür	Açıklama
value	sayı \| dize \| boole \| boş	Başlangıç değeri. Bağımsız değişken türü, bu sorguda hangi `orderBy()` işlevinin kullanıldığına bağlıdır. `orderBy``()` türüyle eşleşen bir değer belirtin. `orderByKey()` ile birlikte kullanıldığında değer bir dize olmalıdır.
anahtar	dize	Başlangıç için alt anahtardır. Bu bağımsız değişkene yalnızca alt öğe, değer veya önceliğe göre sıralama yapılıyorsa izin verilir.

Şunu döndürür:

SorguKısıtlaması

EventType

Şu dizelerden biri: "value", "child_added", "child_changed", "child_removed" veya "child_moved".

İmza:

export declare type EventType = 'value' | 'child_added' | 'child_changed' | 'child_moved' | 'child_removed';

Sorgu SınırlamasıTürü

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

İmza:

export declare type QueryConstraintType = 'endAt' | 'endBefore' | 'startAt' | 'startAfter' | 'limitToFirst' | 'limitToLast' | 'orderByChild' | 'orderByKey' | 'orderByPriority' | 'orderByValue' | 'equalTo';

Abonelikten çık

İşleyiciyi kaldırmak için çağrılabilen bir geri çağırma.

İmza:

export declare type Unsubscribe = () => void;