DocumentSnapshot class

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.
métadonnées Métadonnées d'instantané Métadonnées sur le DocumentSnapshot , y compris des informations sur sa source et ses modifications locales.
réf Référence de document <AppModelType, DbModelType> DocumentReference pour le document inclus dans DocumentSnapshot .

Méthodes

Méthode Modificateurs Description
données (options) Récupère tous les champs du document en tant Object . Renvoie undefined si le document n'existe pas. Par défaut, les valeurs serverTimestamp() qui n'ont pas encore été définies sur leur valeur finale seront renvoyées sous la forme null . Vous pouvez remplacer cela en passant un objet options.
existe() Renvoie si les données existent ou non. Vrai si le document existe.
obtenir (chemin de champ, options) Récupère le champ spécifié par fieldPath . Renvoie undefined si le document ou le champ n'existe pas. Par défaut, un serverTimestamp() qui n'a pas encore été défini sur sa valeur finale sera renvoyé sous la forme null . Vous pouvez remplacer cela en passant un objet options.

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.metadonnées

Métadonnées sur le DocumentSnapshot , y compris des informations sur sa source et ses modifications locales.

Signature:

readonly metadata: SnapshotMetadata;

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.

Par défaut, les valeurs serverTimestamp() qui n'ont pas encore été définies sur leur valeur finale seront renvoyées comme null . Vous pouvez remplacer cela en passant un objet options.

Signature:

data(options?: SnapshotOptions): AppModelType | undefined;

Paramètres

Paramètre Taper Description
choix Options d'instantané Un objet d'options pour configurer la manière dont les données sont récupérées à partir de l'instantané (par exemple le comportement souhaité pour les horodatages du serveur qui n'ont pas encore été définis sur leur valeur finale).

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()

Renvoie si les données existent ou non. Vrai si le document existe.

Signature:

exists(): this is QueryDocumentSnapshot<AppModelType, DbModelType>;

Retour:

c'est QueryDocumentSnapshot <AppModelType, DbModelType>

DocumentSnapshot.get()

Récupère le champ spécifié par fieldPath . Renvoie undefined si le document ou le champ n'existe pas.

Par défaut, un serverTimestamp() qui n'a pas encore été défini sur sa valeur finale sera renvoyé comme null . Vous pouvez remplacer cela en passant un objet options.

Signature:

get(fieldPath: string | FieldPath, options?: SnapshotOptions): 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.
choix Options d'instantané Un objet d'options pour configurer la manière dont le champ est récupéré à partir de l'instantané (par exemple le comportement souhaité pour les horodatages du serveur qui n'ont pas encore été définis sur leur valeur finale).

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.