Query interface

Query 用于排序和过滤 Database 位置的数据,因此其中仅包含一部分子数据。这可用于按某个属性(例如恐龙的高度)对数据集进行排序,以及将大量项目(例如聊天消息)的数量限制到适合同步到客户端的数字。通过将此处定义的一个或多个过滤器方法链接在一起,可以创建查询。

DatabaseReference 一样,您可以使用 on*() 方法从 Query 接收数据。您将只会收到与您的查询匹配的部分数据的事件和 DataSnapshot

如需了解详情,请参阅 https://firebase.google.com/docs/database/web/lists-of-data#sorting_and_filtering_data

签名

export declare interface Query 

属性

属性 类型 说明
参考 DatabaseReference Query 位置的 DatabaseReference

方法

方法 说明
isEqual(other) 返回当前的查询和提供的查询是否表示相同的位置、是否具有相同的查询参数以及来自同一 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;

参数

参数 类型 说明
其他 查询 |null 要与之比较的查询。

返回

布尔值

当前查询和提供的查询是否等效。

Query.toJSON()

返回此对象的可序列化 JSON 表示法。

签名

toJSON(): string;

返回

字符串

此对象的可序列化 JSON 表示法。

Query.toString()

获取此位置的绝对网址。

toString() 方法会返回一个可以放入浏览器、curl 命令或 refFromURL() 调用的网址。由于所有这些都要求对网址进行网址编码,因此 toString() 会返回编码后的网址。

附加“.json”附加到返回的网址,以下载 JSON 格式的数据。如果该位置是安全的(即不可公开读取),您会收到权限遭拒错误。

签名

toString(): string;

返回

字符串

此营业地点的绝对网址。