firebaseドキュメントの.oneの意味

Question

https://firebase.google.com/docs/database/web/read-and-write?hl=ja

このドキュメントでfirebaseのdatabaseの部分を見ているのですが下記の

var starCountRef = firebase.database().ref('posts/' + postId + '/starCount');
starCountRef.on('value', function(snapshot) {
  updateStarCount(postElement, snapshot.val());
});

.onってどういったものでしょうか？
また皆さんこういったメソッドってどうやって調べているでしょうか？
わからないものが出た時なかなか検索にも引っかからず困っています。。。

Answer 1

.on('value', function(snapshot)

valueにsnapshot関数の値を入れているとか何でしょうか？

valueが変化した時にfunction（{}の中身）を実行し，そこにdbのsnapshotを渡しています．
（ここでのvalueとはstarCountRefの示す先であって，特定の変数ではない）

皆さんこういったメソッドってどうやって調べているでしょうか？

より詳細な定義を示した，リファレンスがあります．
https://firebase.google.com/docs/reference/js/firebase.database.Reference#on

あるいはサンプルを見てしまったほうが，実践的で文脈もわかり，飲み込みやすいかもしれません．
同じコードが使われているサンプル
別のより大がかりなサンプル
公式サンプル一覧

Comments

[you88]

ありがとうございます！すごく分かりやすいです！
追加で質問申し訳ないのですがスナップショットはその時点での値を取ってくるという意味であっているでしょうか？

[Yatima]

ざっくり言えばそういうことです．
メソッドもいくつか用意されています．
該当リファレンス：
https://firebase.google.com/docs/reference/js/firebase.database.DataSnapshot

[you88]

ありがとうございました！助かりました！

Answer 2

その章の一番最初に書いてありますよ．

パスのデータを読み取り、変更をリッスンするには、on() メソッドまたは once() メソッドを firebase.database.Reference で使用して、イベントを監視します。

Comments

[you88]

具体的にどういう処理が行われているのかよく分からず。。。

.on('value', function(snapshot)

valueにsnapshot関数の値を入れているとか何でしょうか？