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;
返回:
字符串
此营业地点的绝对网址。