Accéder à la console

A write batch, used to perform multiple writes as a single atomic unit.

A WriteBatch object can be acquired by calling Firestore.batch(). It provides methods for adding writes to the write batch. None of the writes will be committed (or visible locally) until WriteBatch.commit() is called.

Unlike transactions, write batches are persisted offline and therefore are preferable when you don't need to condition your writes on read data.

Index

Constructors

Methods

Constructors

Private constructor

Methods

commit

  • commit(): Promise<void>
  • Commits all of the writes in this write batch as a single atomic unit.

    Returns Promise<void>

    A Promise resolved once all of the writes in the batch have been successfully written to the backend as an atomic unit. Note that it won't resolve while you're offline.

delete

  • delete(documentRef: DocumentReference): WriteBatch
  • Deletes the document referred to by the provided DocumentReference.

    Parameters

    Returns WriteBatch

    This WriteBatch instance. Used for chaining method calls.

set

  • set(documentRef: DocumentReference, data: DocumentData, options?: SetOptions): WriteBatch
  • Writes to the document referred to by the provided DocumentReference. If the document does not exist yet, it will be created. If you pass SetOptions, the provided data can be merged into the existing document.

    Parameters

    • documentRef: DocumentReference

      A reference to the document to be set.

    • data: DocumentData

      An object of the fields and values for the document.

    • Optional options: SetOptions

      An object to configure the set behavior.

    Returns WriteBatch

    This WriteBatch instance. Used for chaining method calls.

update