DocumentSnapshot class

Un DocumentSnapshot contiene datos leídos de un documento de tu base de datos de Firestore. Los datos se pueden extraer con .data() o .get(<field>) para obtener un campo específico.

En el caso de un elemento DocumentSnapshot que apunta a un documento que no existe, cualquier acceso a los datos mostrará el valor "undefined". Puedes usar el método exists() para verificar explícitamente la existencia de un documento.

Firma:

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

Constructores

Constructor Teclas modificadoras Descripción
(constructor)() Construye una instancia nueva de la clase DocumentSnapshot.

Propiedades

Propiedad Teclas modificadoras Tipo Descripción
id string Es la propiedad de DocumentSnapshot que proporciona el ID del documento.
metadata SnapshotMetadata Metadatos sobre DocumentSnapshot, incluida la información sobre su fuente y las modificaciones locales
referencia DocumentReference<AppModelType, DbModelType> Es el DocumentReference del documento incluido en el DocumentSnapshot.

Métodos

Método Teclas modificadoras Descripción
datos(opciones) Recupera todos los campos del documento como una Object. Muestra undefined si el documento no existe.De forma predeterminada, los valores serverTimestamp() que aún no se establecieron en su valor final se mostrarán como null. Puedes anular esto si pasas un objeto de opciones.
exists() Devuelve si los datos existen o no. Es verdadero si el documento existe.
get(fieldPath, opciones) Recupera el campo especificado por fieldPath. Muestra undefined si el documento o campo no existe.De forma predeterminada, un serverTimestamp() que aún no se estableció en su valor final se mostrará como null. Puedes anular esto si pasas un objeto de opciones.

DocumentSnapshot.(constructor)

Construye una instancia nueva de la clase DocumentSnapshot.

Firma:

protected constructor();

ID de DocumentSnapshot.id

Es la propiedad de DocumentSnapshot que proporciona el ID del documento.

Firma:

get id(): string;

DocumentSnapshot.metadata

Metadatos sobre DocumentSnapshot, incluida la información sobre su fuente y las modificaciones locales

Firma:

readonly metadata: SnapshotMetadata;

DocumentSnapshot.ref

Es el DocumentReference del documento incluido en el DocumentSnapshot.

Firma:

get ref(): DocumentReference<AppModelType, DbModelType>;

DocumentSnapshot.data()

Recupera todos los campos del documento como una Object. Muestra undefined si el documento no existe.

De forma predeterminada, los valores de serverTimestamp() que aún no se establecieron en su valor final se mostrarán como null. Puedes anular esto si pasas un objeto de opciones.

Firma:

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

Parámetros

Parámetro Tipo Descripción
opciones SnapshotOptions Un objeto de opciones para configurar cómo se recuperan los datos de la instantánea (por ejemplo, el comportamiento deseado para las marcas de tiempo del servidor que aún no se establecieron en su valor final).

Muestra:

Tipo de modelo de aplicación | indefinido

Una Object que contiene todos los campos del documento o undefined si el documento no existe.

DocumentSnapshot.exists()

Devuelve si los datos existen o no. Es verdadero si el documento existe.

Firma:

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

Muestra:

esto es QueryDocumentSnapshot<AppModelType, DrModelType>

DocumentSnapshot.get()

Recupera el campo especificado por fieldPath. Muestra undefined si el documento o campo no existe.

De forma predeterminada, un serverTimestamp() que aún no se estableció en su valor final se mostrará como null. Puedes anular esto si pasas un objeto de opciones.

Firma:

get(fieldPath: string | FieldPath, options?: SnapshotOptions): any;

Parámetros

Parámetro Tipo Descripción
fieldPath cadena | Ruta de campo La ruta de acceso (por ejemplo, "foo" o "foo.bar") a un campo específico.
opciones SnapshotOptions Un objeto de opciones para configurar cómo se recupera el campo a partir de la instantánea (por ejemplo, el comportamiento deseado para las marcas de tiempo del servidor que aún no se establecieron en su valor final).

Muestra:

cualquiera

Los datos en la ubicación del campo especificado o no definidos si no existe tal campo en el documento.