Query interface

Query 會在資料庫位置中排序及篩選資料,因此只會包含部分子項資料。這可用於依據某些屬性 (例如恐龍的高度) 來排序資料收集結果,以及將大量項目清單 (例如即時通訊訊息) 縮減為適合與用戶端同步的數字。將此處定義的一或多個篩選方法鏈結在一起時,即可建立查詢。

DatabaseReference 一樣,您可以使用 on*() 方法從 Query 接收資料。您只會收到與查詢相符的部分資料事件和 DataSnapshot

詳情請參閱 https://firebase.google.com/docs/database/web/lists-of-data#sorting_and_filtering_data

簽名:

export declare interface Query 

屬性

屬性 類型 說明
參考資料 資料庫參考資料 Query 位置的 DatabaseReference

方法

方法 說明
isEqual(其他) 傳回目前和提供的查詢是否代表相同位置、有相同的查詢參數,以及來自同一個 FirebaseApp 例項。如果兩個 DatabaseReference 物件代表相同位置,且來自同一個 FirebaseApp 例項,則兩個物件會是相等的。如果兩個 Query 物件代表相同位置、具有相同查詢參數,且來自同一個 FirebaseApp 例項,則兩個物件相等。對等查詢會共用相同的排序順序、限制,以及起點和終點。
toJSON() 傳回此物件的 JSON 可序列化表示法。
toString() 取得這個位置的絕對網址。toString() 方法會傳回可以放入瀏覽器、curl 指令或 refFromURL() 呼叫的網址。因為這些網址都預期網址經過網址編碼,因此 toString() 會傳回經過編碼的網址。附加「.json」以便下載 JSON 格式的資料。如果位置安全無虞 (不會公開讀取),系統會顯示權限遭拒的錯誤。

Query.ref

Query 位置的 DatabaseReference

簽名:

readonly ref: DatabaseReference;

Query.isEqual()

傳回目前和提供的查詢是否代表同一個位置、擁有相同的查詢參數,以及來自同一個 FirebaseApp 例項。

如果兩個 DatabaseReference 物件代表相同位置,且來自同一個 FirebaseApp 例項,則兩個物件相同。

如果兩個 Query 物件代表相同的位置、有相同的查詢參數,且來自同一個 FirebaseApp 例項,則兩個物件相同。對等查詢會共用相同的排序順序、限制,以及起點和終點。

簽名:

isEqual(other: Query | null): boolean;

參數

參數 類型 說明
其他 查詢 |空值 要用於比較的查詢。

傳回:

布林值

目前查詢與提供的查詢是否相同。

Query.toJSON()

傳回此物件的 JSON 可序列化表示法。

簽名:

toJSON(): string;

傳回:

字串

此物件的 JSON 可序列化表示法。

Query.toString()

取得這個位置的絕對網址。

toString() 方法會傳回可以放入瀏覽器、curl 指令或 refFromURL() 呼叫的網址。因為這些字串會預期網址進行網址編碼,所以 toString() 會傳回經過編碼的網址。

附加「.json」以便下載 JSON 格式的資料。如果位置安全無虞 (不會公開讀取),系統會顯示權限遭拒的錯誤。

簽名:

toString(): string;

傳回:

字串

這個位置的絕對網址。