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;
傳回:
字串
這個位置的絕對網址。