Query
对数据库位置的数据进行排序和过滤,以便仅包含子数据的子集。这可用于按某些属性(例如恐龙的高度)对数据集合进行排序,以及将大型项目列表(例如聊天消息)限制为适合与客户端同步的数量。查询是通过将此处定义的一个或多个过滤器方法链接在一起来创建的。
就像DatabaseReference
一样,您可以使用on*()
方法从Query
接收数据。您只会收到事件和DataSnapshot
s 表示与您的查询匹配的数据子集。
有关详细信息,请参阅https://firebase.google.com/docs/database/web/lists-of-data#sorting_and_filtering_data 。
签名:
export declare interface Query
特性
财产 | 类型 | 描述 |
---|---|---|
参考 | 数据库参考 | Query 位置的DatabaseReference 。 |
方法
方法 | 描述 |
---|---|
是否等于(其他) | 返回当前查询和提供的查询是否表示同一位置、是否具有相同的查询参数以及来自同一FirebaseApp 实例。如果两个DatabaseReference 对象表示相同位置并且来自同一FirebaseApp 实例,则它们是等效的。如果两个Query 对象表示相同的位置、具有相同的查询参数并且来自同一FirebaseApp 实例,则它们是等效的。等效查询共享相同的排序顺序、限制以及起点和终点。 |
toJSON() | 返回此对象的 JSON 可序列化表示形式。 |
toString() | 获取此位置的绝对 URL。 toString() 方法返回一个 URL,可以将其放入浏览器、curl 命令或refFromURL() 调用中。由于所有这些都期望 URL 进行 url 编码, toString() 返回编码的 URL。在浏览器中输入时,将“.json”附加到返回的 URL 以下载 JSON 格式的数据。如果该位置是安全的(即不可公开读取),您将收到权限被拒绝的错误。 |
查询.ref
Query
的DatabaseReference
的位置。
签名:
readonly ref: DatabaseReference;
查询.isEqual()
返回当前查询和提供的查询是否表示同一位置、是否具有相同的查询参数以及来自同一FirebaseApp
实例。
如果两个DatabaseReference
对象表示相同位置并且来自FirebaseApp
的同一实例,则它们是等效的。
如果两个Query
对象代表相同的位置、具有相同的查询参数并且来自同一FirebaseApp
实例,则它们是等效的。等效查询共享相同的排序顺序、限制以及起点和终点。
签名:
isEqual(other: Query | null): boolean;
参数
范围 | 类型 | 描述 |
---|---|---|
其他 | 查询|无效的 | 要比较的查询。 |
返回:
布尔值
当前查询和提供的查询是否等效。
查询.toJSON()
返回此对象的 JSON 可序列化表示形式。
签名:
toJSON(): string;
返回:
细绳
该对象的 JSON 可序列化表示。
查询.toString()
获取此位置的绝对 URL。
toString()
方法返回一个 URL,可以将其放入浏览器、curl 命令或refFromURL()
调用中。由于所有这些都期望 URL 进行 url 编码, toString()
返回编码的 URL。
在浏览器中输入时,将“.json”附加到返回的 URL 以下载 JSON 格式的数据。如果该位置是安全的(即不可公开读取),您将收到权限被拒绝的错误。
签名:
toString(): string;
返回:
细绳
该位置的绝对 URL。