Une Query trie et filtre les données à un emplacement de base de données afin que seul un sous-ensemble des données enfants soit inclus. Cela peut être utilisé pour classer une collection de données en fonction d'un attribut (par exemple, la taille des dinosaures) ainsi que pour restreindre une grande liste d'éléments (par exemple, des messages de discussion) à un nombre approprié pour la synchronisation avec le client. Les requêtes sont créées en enchaînant une ou plusieurs des méthodes de filtrage définies ici.
Tout comme avec une DatabaseReference , vous pouvez recevoir des données d'une Query en utilisant les méthodes on*() . Vous ne recevrez que les événements et DataSnapshot s pour le sous-ensemble de données qui correspond à votre requête.
Voir https://firebase.google.com/docs/database/web/lists-of-data#sorting_and_filtering_data pour plus d'informations.
Signature:
export declare interface Query
Propriétés
| Propriété | Taper | Description |
|---|---|---|
| réf | Référence de base de données | DatabaseReference pour l'emplacement de la Query . |
Méthodes
| Méthode | Description |
|---|---|
| est égal (autre) | Indique si les requêtes actuelles et fournies représentent ou non le même emplacement, ont les mêmes paramètres de requête et proviennent de la même instance de FirebaseApp . Deux objets DatabaseReference sont équivalents s'ils représentent le même emplacement et proviennent de la même instance de FirebaseApp . Deux objets Query sont équivalents s'ils représentent le même emplacement, ont les mêmes paramètres de requête et proviennent de la même instance de FirebaseApp . Les requêtes équivalentes partagent le même ordre de tri, les mêmes limites et les mêmes points de départ et de fin. |
| versJSON() | Renvoie une représentation sérialisable JSON de cet objet. |
| àChaîne() | Obtient l'URL absolue de cet emplacement. La méthode toString() renvoie une URL prête à être insérée dans un navigateur, une commande curl ou un appel refFromURL() . Puisque tous s'attendent à ce que l'URL soit codée en URL, toString() renvoie une URL codée. Ajoutez « .json » à l'URL renvoyée lorsque vous la saisissez dans un navigateur pour télécharger les données au format JSON. Si l'emplacement est sécurisé (c'est-à-dire non lisible publiquement), vous obtiendrez une erreur d'autorisation refusée. |
Requête.ref
La DatabaseReference pour la Query l'emplacement.
Signature:
readonly ref: DatabaseReference;
Requête.isEqual()
Indique si les requêtes actuelles et fournies représentent ou non le même emplacement, ont les mêmes paramètres de requête et proviennent de la même instance de FirebaseApp . .
Deux objets DatabaseReference sont équivalents s'ils représentent le même emplacement et proviennent de la même instance de FirebaseApp .
Deux objets Query sont équivalents s'ils représentent le même emplacement, ont les mêmes paramètres de requête et proviennent de la même instance de FirebaseApp . . Les requêtes équivalentes partagent le même ordre de tri, les mêmes limites et les mêmes points de départ et de fin.
Signature:
isEqual(other: Query | null): boolean;
Paramètres
| Paramètre | Taper | Description |
|---|---|---|
| autre | Requête | nul | Requête à comparer. |
Retour:
booléen
Si les requêtes actuelles et fournies sont équivalentes ou non.
Requête.toJSON()
Renvoie une représentation sérialisable JSON de cet objet.
Signature:
toJSON(): string;
Retour:
chaîne
Une représentation sérialisable JSON de cet objet.
Requête.toString()
Obtient l'URL absolue de cet emplacement.
La méthode toString() renvoie une URL prête à être insérée dans un navigateur, une commande curl ou un appel refFromURL() . Puisque tous s'attendent à ce que l'URL soit codée en URL, toString() renvoie une URL codée.
Ajoutez « .json » à l'URL renvoyée lorsque vous la saisissez dans un navigateur pour télécharger les données au format JSON. Si l'emplacement est sécurisé (c'est-à-dire non lisible publiquement), vous obtiendrez une erreur d'autorisation refusée.
Signature:
toString(): string;
Retour:
chaîne
L'URL absolue de cet emplacement.