QuerySnapshot class

Un QuerySnapshot contient zéro ou plusieurs objets DocumentSnapshot représentant les résultats d'une requête. Les documents sont accessibles sous forme de tableau via la propriété docs ou énumérés à l'aide de la méthode forEach . Le nombre de documents peut être déterminé via les propriétés empty et size .

Signature:

export declare class QuerySnapshot<AppModelType = DocumentData, DbModelType extends DocumentData = DocumentData> 

Propriétés

Propriété Modificateurs Taper Description
documents Tableau< QueryDocumentSnapshot <AppModelType, DbModelType>> Un tableau de tous les documents du QuerySnapshot .
vide booléen True s’il n’y a aucun document dans le QuerySnapshot .
métadonnées Métadonnées d'instantané Métadonnées sur cet instantané, concernant sa source et s'il comporte des modifications locales.
requête Requête <AppModelType, DbModelType> La requête sur laquelle vous avez appelé get ou onSnapshot afin d'obtenir ce QuerySnapshot .
taille nombre Le nombre de documents dans le QuerySnapshot .

Méthodes

Méthode Modificateurs Description
docChanges(options) Renvoie un tableau des modifications apportées aux documents depuis le dernier instantané. S'il s'agit du premier instantané, tous les documents seront dans la liste en tant que modifications « ajoutées ».
pourEach(rappel, thisArg) Énumère tous les documents du QuerySnapshot .

QuerySnapshot.docs

Un tableau de tous les documents du QuerySnapshot .

Signature:

get docs(): Array<QueryDocumentSnapshot<AppModelType, DbModelType>>;

QuerySnapshot.empty

Vrai s'il n'y a aucun document dans le QuerySnapshot .

Signature:

get empty(): boolean;

QuerySnapshot.metadonnées

Métadonnées sur cet instantané, concernant sa source et s'il comporte des modifications locales.

Signature:

readonly metadata: SnapshotMetadata;

QuerySnapshot.query

La requête sur laquelle vous avez appelé get ou onSnapshot afin d'obtenir ce QuerySnapshot .

Signature:

readonly query: Query<AppModelType, DbModelType>;

QuerySnapshot.size

Le nombre de documents dans le QuerySnapshot .

Signature:

get size(): number;

QuerySnapshot.docChanges()

Renvoie un tableau des modifications apportées aux documents depuis le dernier instantané. S'il s'agit du premier instantané, tous les documents seront dans la liste en tant que modifications « ajoutées ».

Signature:

docChanges(options?: SnapshotListenOptions): Array<DocumentChange<AppModelType, DbModelType>>;

Paramètres

Paramètre Taper Description
choix SnapshotListenOptions SnapshotListenOptions qui contrôlent si les modifications de métadonnées uniquement (c'est-à-dire uniquement DocumentSnapshot.metadata modifié) doivent déclencher des événements d'instantané.

Retour:

Tableau< DocumentChange <AppModelType, DbModelType>>

QuerySnapshot.forEach()

Énumère tous les documents dans QuerySnapshot .

Signature:

forEach(callback: (result: QueryDocumentSnapshot<AppModelType, DbModelType>) => void, thisArg?: unknown): void;

Paramètres

Paramètre Taper Description
rappeler (résultat : QueryDocumentSnapshot <AppModelType, DbModelType>) => vide Un rappel à appeler avec un QueryDocumentSnapshot pour chaque document de l'instantané.
cetArg inconnu La liaison this pour le rappel.

Retour:

vide