Un DocumentSnapshot
contient des données lues à partir d'un document dans votre base de données Firestore. Les données peuvent être extraites avec .data()
ou .get(<field>)
pour obtenir un champ spécifique.
Pour un DocumentSnapshot
qui pointe vers un document inexistant, tout accès aux données renverra « non défini ». Vous pouvez utiliser la méthode exists()
pour vérifier explicitement l'existence d'un document.
Signature:
export declare class DocumentSnapshot<AppModelType = DocumentData, DbModelType extends DocumentData = DocumentData>
Constructeurs
Constructeur | Modificateurs | Description |
---|---|---|
(constructeur)() | Construit une nouvelle instance de la classe DocumentSnapshot |
Propriétés
Propriété | Modificateurs | Taper | Description |
---|---|---|---|
identifiant | chaîne | Propriété du DocumentSnapshot qui fournit l'ID du document. | |
réf | Référence de document <AppModelType, DbModelType> | DocumentReference pour le document inclus dans DocumentSnapshot . |
Méthodes
Méthode | Modificateurs | Description |
---|---|---|
données() | Récupère tous les champs du document en tant Object . Renvoie undefined si le document n'existe pas. | |
existe() | Indique si le document à l'emplacement de l'instantané existe ou non. | |
obtenir (chemin de champ) | Récupère le champ spécifié par fieldPath . Renvoie undefined si le document ou le champ n'existe pas. |
DocumentSnapshot. (constructeur)
Construit une nouvelle instance de la classe DocumentSnapshot
Signature:
protected constructor();
DocumentSnapshot.id
Propriété du DocumentSnapshot
qui fournit l'ID du document.
Signature:
get id(): string;
DocumentSnapshot.ref
DocumentReference
pour le document inclus dans DocumentSnapshot
.
Signature:
get ref(): DocumentReference<AppModelType, DbModelType>;
DocumentSnapshot.data()
Récupère tous les champs du document en tant Object
. Renvoie undefined
si le document n'existe pas.
Signature:
data(): AppModelType | undefined;
Retour:
Type de modèle d'application | indéfini
Un Object
contenant tous les champs du document ou undefined
si le document n'existe pas.
DocumentSnapshot.exists()
Indique si le document à l'emplacement de l'instantané existe ou non.
Signature:
exists(): this is QueryDocumentSnapshot<AppModelType, DbModelType>;
Retour:
c'est QueryDocumentSnapshot <AppModelType, DbModelType>
vrai si le document existe.
DocumentSnapshot.get()
Récupère le champ spécifié par fieldPath
. Renvoie undefined
si le document ou le champ n'existe pas.
Signature:
get(fieldPath: string | FieldPath): any;
Paramètres
Paramètre | Taper | Description |
---|---|---|
champChemin | chaîne | Chemin de champ | Le chemin (par exemple « foo » ou « foo.bar ») vers un champ spécifique. |
Retour:
n'importe lequel
Les données à l'emplacement du champ spécifié ou non définies si aucun champ de ce type n'existe dans le document.