WriteBatch class

Un batch di scrittura, utilizzato per eseguire più scritture come una singola unità atomica.

Un oggetto WriteBatch può essere acquisito chiamando writeBatch() . Fornisce metodi per aggiungere scritture al batch di scrittura. Nessuna delle scritture verrà sottoposta a commit (o visibile localmente) finché non verrà chiamato WriteBatch.commit() .

Firma:

export declare class WriteBatch 

Metodi

WriteBatch.commit()

Esegue il commit di tutte le scritture in questo batch di scrittura come una singola unità atomica.

Il risultato di queste scritture si rifletterà solo nelle letture dei documenti che si verificano dopo la risoluzione della promessa restituita. Se il client è offline, la scrittura fallisce. Se desideri visualizzare le modifiche locali o le scritture nel buffer finché il client non è online, utilizza l'SDK completo di Firestore.

Firma:

commit(): Promise<void>;

Ritorna:

Promesso<vuoto>

Una Promise risolta una volta che tutte le scritture nel batch sono state scritte con successo sul backend come unità atomica (nota che non si risolverà mentre sei offline).

WriteBatch.delete()

Elimina il documento a cui fa riferimento il DocumentReference fornito .

Firma:

delete<AppModelType, DbModelType extends DocumentData>(documentRef: DocumentReference<AppModelType, DbModelType>): WriteBatch;

Parametri

Ritorna:

WriteBatch

Questa istanza WriteBatch . Utilizzato per concatenare le chiamate ai metodi.

WriteBatch.set()

Scrive al documento a cui fa riferimento il DocumentReference fornito . Se il documento non esiste ancora, verrà creato.

Firma:

set<AppModelType, DbModelType extends DocumentData>(documentRef: DocumentReference<AppModelType, DbModelType>, data: WithFieldValue<AppModelType>): WriteBatch;

Parametri

Ritorna:

WriteBatch

Questa istanza WriteBatch . Utilizzato per concatenare le chiamate ai metodi.

WriteBatch.set()

Scrive al documento a cui fa riferimento il DocumentReference fornito . Se il documento non esiste ancora, verrà creato. Se fornisci merge o mergeFields , i dati forniti possono essere uniti in un documento esistente.

Firma:

set<AppModelType, DbModelType extends DocumentData>(documentRef: DocumentReference<AppModelType, DbModelType>, data: PartialWithFieldValue<AppModelType>, options: SetOptions): WriteBatch;

Parametri

Ritorna:

WriteBatch

Questa istanza WriteBatch . Utilizzato per concatenare le chiamate ai metodi.

Eccezioni

Errore: se l'input fornito non è un documento Firestore valido.

WriteBatch.update()

Aggiorna i campi nel documento a cui fa riferimento il DocumentReference fornito . L'aggiornamento fallirà se applicato a un documento che non esiste.

Firma:

update<AppModelType, DbModelType extends DocumentData>(documentRef: DocumentReference<AppModelType, DbModelType>, data: UpdateData<DbModelType>): WriteBatch;

Parametri

Ritorna:

WriteBatch

Questa istanza WriteBatch . Utilizzato per concatenare le chiamate ai metodi.

Eccezioni

Errore: se l'input fornito non è un dato Firestore valido.

WriteBatch.update()

Aggiorna i campi nel documento a cui fa riferimento questo DocumentReference . L'aggiornamento fallirà se applicato a un documento che non esiste.

I campi nidificati possono essere aggiornati fornendo stringhe di percorsi di campo separati da punti o fornendo oggetti FieldPath .

Firma:

update<AppModelType, DbModelType extends DocumentData>(documentRef: DocumentReference<AppModelType, DbModelType>, field: string | FieldPath, value: unknown, ...moreFieldsAndValues: unknown[]): WriteBatch;

Parametri

Ritorna:

WriteBatch

Questa istanza WriteBatch . Utilizzato per concatenare le chiamate ai metodi.

Eccezioni

Errore: se l'input fornito non è un dato Firestore valido.