[ Web Proxy ]
URL:
Viewing: https://firebase.google.com/docs/reference/node/firebase.firestore.QueryDocumentSnapshot [Back]  [Original]
QueryDocumentSnapshot | JavaScript SDK  |  Node.js (client) API reference  |  Firebase Skip to main content
Firebase [Firebase]
Build Run Solutions Pricing Docs Support
Search:
Blog Go to console
Overview Fundamentals AI Build Run Reference Samples
Firebase [Firebase]
Send feedback Stay organized with collections Save and categorize content based on your preferences.

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'.

Type parameters

  • T

Index

Constructors

Properties

Methods

Constructors

Private constructor

Properties

exists

exists: boolean

Inherited from DocumentSnapshot.exists

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

id

id: string

Inherited from DocumentSnapshot.id

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

metadata

metadata: SnapshotMetadata

Inherited from DocumentSnapshot.metadata

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

ref

ref: DocumentReference<T>

Inherited from DocumentSnapshot.ref

The DocumentReference for the document included in the DocumentSnapshot.

Methods

data

  • data ( options ? :  SnapshotOptions ) : T

  • Overrides DocumentSnapshot.data

    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 T

    An Object containing all fields in the document.

get

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

  • Inherited from DocumentSnapshot.get

    Retrieves the field specified by fieldPath. Returns undefined if the document or field doesn't exist.

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

    Parameters

    • fieldPath: string | FieldPath

      The path (e.g. 'foo' or 'foo.bar') to a specific field.

    • Optional options: SnapshotOptions

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

    Returns any

    The data at the specified field location or undefined if no such field exists in the document.

isEqual

  • isEqual ( other :  DocumentSnapshot < T > ) : boolean

  • Inherited from DocumentSnapshot.isEqual

    Returns true if this DocumentSnapshot is equal to the provided one.

    Parameters

    Returns boolean

    true if this DocumentSnapshot is equal to the provided one.

Send feedback

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2022-07-27 UTC.

Need to tell us more? [[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2022-07-27 UTC."],[],[]]
Web Proxy Viewer  |  New URL  |  Original Page