FIRDocumentSnapshot


@interface FIRDocumentSnapshot : NSObject

A FIRDocumentSnapshot contains data read from a document in your Firestore database. The data can be extracted with the data property or by using subscript syntax to access a specific field.

For a FIRDocumentSnapshot that points to a non-existing document, any data access will return nil. You can use the exists property to explicitly verify a documents existence.

  • Declaration

    Objective-C

    - (nonnull instancetype)init;
  • True if the document exists.

    Declaration

    Objective-C

    @property (readonly, assign, nonatomic) BOOL exists;
  • A FIRDocumentReference to the document location.

    Declaration

    Objective-C

    @property (readonly, strong, nonatomic) FIRDocumentReference *_Nonnull reference;
  • The ID of the document for which this FIRDocumentSnapshot contains data.

    Declaration

    Objective-C

    @property (readonly, copy, nonatomic) NSString *_Nonnull documentID;
  • Metadata about this snapshot concerning its source and if it has local modifications.

    Declaration

    Objective-C

    @property (readonly, strong, nonatomic) FIRSnapshotMetadata *_Nonnull metadata;
  • Retrieves all fields in the document as an NSDictionary. Returns nil if the document doesn’t exist.

    Server-provided timestamps that have not yet been set to their final value will be returned as NSNull. You can use dataWithOptions() to configure this behavior.

    Declaration

    Objective-C

    - (nullable NSDictionary<NSString *, id> *)data;

    Return Value

    An NSDictionary containing all fields in the document or nil if the document doesn’t exist.

  • Retrieves all fields in the document as a Dictionary. Returns nil if the document doesn’t exist.

    Declaration

    Objective-C

    - (nullable NSDictionary<NSString *, id> *)dataWithServerTimestampBehavior:
        (FIRServerTimestampBehavior)serverTimestampBehavior;

    Parameters

    serverTimestampBehavior

    Configures how server timestamps that have not yet been set to their final value are returned from the snapshot.

    Return Value

    A Dictionary containing all fields in the document or nil if the document doesn’t exist.

  • Retrieves a specific field from the document. Returns nil if the document or the field doesn’t exist.

    The timestamps that have not yet been set to their final value will be returned as NSNull. The can use get(_:options:) to configure this behavior.

    Declaration

    Objective-C

    - (nullable id)valueForField:(nonnull id)field;

    Parameters

    field

    The field to retrieve.

    Return Value

    The value contained in the field or nil if the document or field doesn’t exist.

  • Retrieves a specific field from the document. Returns nil if the document or the field doesn’t exist.

    The timestamps that have not yet been set to their final value will be returned as NSNull. The can use get(_:options:) to configure this behavior.

    Declaration

    Objective-C

    - (nullable id)valueForField:(nonnull id)field
         serverTimestampBehavior:
             (FIRServerTimestampBehavior)serverTimestampBehavior;

    Parameters

    field

    The field to retrieve.

    serverTimestampBehavior

    Configures how server timestamps that have not yet been set to their final value are returned from the snapshot.

    Return Value

    The value contained in the field or nil if the document or field doesn’t exist.

  • Retrieves a specific field from the document.

    Declaration

    Objective-C

    - (nullable id)objectForKeyedSubscript:(nonnull id)key;

    Parameters

    key

    The field to retrieve.

    Return Value

    The value contained in the field or nil if the document or field doesn’t exist.