Go to console

A QueryDocumentSnapshot contains data read from a document in your Firestore database as part of a query. The document is guaranteed to exist and its data can be extracted with .data() or .get(<field>) to get a specific field.

A QueryDocumentSnapshot offers the same API surface as a DocumentSnapshot. Since query results contain only existing documents, the exists property will always be true and data() will never return 'undefined'.

Index

Constructors

Properties

Methods

Constructors

Private constructor

Properties

exists

exists: boolean

Property of the DocumentSnapshot that signals whether or not the data exists. True if the document exists.

id

id: string

Property of the DocumentSnapshot that provides the document's ID.

metadata

Metadata about the DocumentSnapshot, including information about its source and local modifications.

ref

The DocumentReference for the document included in the DocumentSnapshot.

Methods

data

  • data(options?: SnapshotOptions): DocumentData
  • Retrieves all fields in the document as an Object.

    By default, FieldValue.serverTimestamp() values that have not yet been set to their final value will be returned as null. You can override this by passing an options object.

    override

    Parameters

    • Optional options: SnapshotOptions

      An options object to configure how data is retrieved from the snapshot (e.g. the desired behavior for server timestamps that have not yet been set to their final value).

    Returns DocumentData

    An Object containing all fields in the document.