WriteBatch class

Wsad związany z zapisywaniem służący do wykonywania wielu zapisów jako pojedynczej jednostki atomowej.

Obiekt WriteBatch można uzyskać przez wywołanie metody writeBatch(). Udostępnia metody dodawania zapisów do wsadu zapisu. Żaden zapis nie zostanie zatwierdzony (ani widoczny lokalnie) do czasu wywołania funkcji WriteBatch.commit().

Podpis:

export declare class WriteBatch

Metody

Metoda Modyfikatory Opis
commit(), Zatwierdza wszystkie zapisy w tej wsadzie zapisu jako pojedynczą jednostkę atomową.Wynik tych zapisów będzie widoczny tylko w odczytach dokumentów, które nastąpią po rozwiązaniu zwróconej obietnicy. Jeśli klient jest offline, zapis się nie uda. Jeśli chcesz wyświetlać lokalne zmiany lub zapisy w buforze, dopóki klient nie będzie online, użyj pełnego pakietu SDK Firestore.
delete(documentRef) Usuwa dokument, do którego odwołuje się podany DocumentReference.
set(documentRef, data) Zapisuje dokument, do którego odwołuje się podany DocumentReference. Jeśli dokument jeszcze nie istnieje, zostanie utworzony.
set(documentRef, data, options) Zapisuje dokument, do którego odwołuje się podany DocumentReference. Jeśli dokument jeszcze nie istnieje, zostanie utworzony. Jeśli podasz merge lub mergeFields, podane dane zostaną scalone w istniejący dokument.
update(documentRef, data) Aktualizuje pola w dokumencie, do którego odwołuje się podany DocumentReference. Aktualizacja się nie powiedzie, jeśli zostanie zastosowana do nieistniejącego dokumentu.
update(documentRef, pole, wartość, moreFieldsAndValues) Aktualizuje pola w dokumencie, do którego odwołuje się ten DocumentReference. Aktualizacja nie powiedzie się, jeśli zostanie zastosowana do dokumentu, który nie istnieje.Zagnieżdżone pola można zaktualizować, podając ciągi ścieżki pól oddzielone kropkami lub obiekty FieldPath.

WriteBatch.commit()

Zatwierdź wszystkie zapisy w tej wsadzie zapisu jako pojedynczą jednostkę atomową.

Wynik tych zapisów będzie widoczny tylko w odczytach dokumentów, które mają miejsce po rozwiązaniu zwróconej obietnicy. Jeśli klient jest offline, zapis się nie uda. Jeśli chcesz wyświetlać lokalne zmiany lub zapisy w buforze, dopóki klient nie będzie online, użyj pełnego pakietu SDK Firestore.

Podpis:

commit(): Promise<void>;

Zwroty:

Obietnica<void>

Działanie Promise zostało rozwiązane, gdy wszystkie zapisy w grupie zostaną zapisane w backendzie jako jednostka atomowa (pamiętaj, że nie zostanie rozpoznana, gdy jesteś offline).

WriteBatch.delete()

Usuwa dokument, do którego odwołuje się podany DocumentReference.

Podpis:

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

Parametry

Parametr Typ Opis
odniesienie do dokumentu DocumentReference<AppModelType, DbModelType> Odwołanie do dokumentu, który ma zostać usunięty.

Zwroty:

Zapis wsadowy

Ta instancja WriteBatch. Służy do tworzenia łańcuchów wywołań metod.

WriteBatch.set()

Zapisuje dokument, do którego odwołuje się podany DocumentReference. Jeśli dokument jeszcze nie istnieje, zostanie utworzony.

Podpis:

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

Parametry

Parametr Typ Opis
odniesienie do dokumentu DocumentReference<AppModelType, DbModelType> Odwołanie do dokumentu, który ma zostać ustawiony.
dane WithFieldValue<AppModelType> Obiekt pól i wartości dokumentu.

Zwroty:

Zapis wsadowy

Ta instancja WriteBatch. Służy do tworzenia łańcuchów wywołań metod.

WriteBatch.set()

Zapisuje dokument, do którego odwołuje się podany DocumentReference. Jeśli dokument jeszcze nie istnieje, zostanie utworzony. Jeśli podasz merge lub mergeFields, podane dane zostaną scalone w istniejący dokument.

Podpis:

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

Parametry

Parametr Typ Opis
odniesienie do dokumentu DocumentReference<AppModelType, DbModelType> Odwołanie do dokumentu, który ma zostać ustawiony.
dane częściowo z wartością pola<AppModelType> Obiekt pól i wartości dokumentu.
opcje SetOptions Obiekt do skonfigurowania zachowania zestawu.

Zwroty:

Zapis wsadowy

Ta instancja WriteBatch. Służy do tworzenia łańcuchów wywołań metod.

Wyjątki

Błąd – jeśli podane dane wejściowe nie są prawidłowym dokumentem Firestore.

WriteBatch.update()

Aktualizuje pola w dokumencie, do którego odwołuje się podany DocumentReference. Aktualizacja się nie powiedzie, jeśli zostanie zastosowana do nieistniejącego dokumentu.

Podpis:

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

Parametry

Parametr Typ Opis
odniesienie do dokumentu DocumentReference<AppModelType, DbModelType> Odwołanie do dokumentu, który ma zostać zaktualizowany.
dane UpdateData<DbModelType> Obiekt zawierający pola i wartości do zaktualizowania dokumentu. Pola mogą zawierać kropki, aby odwoływać się do zagnieżdżonych pól w dokumencie.

Zwroty:

Zapis wsadowy

Ta instancja WriteBatch. Służy do tworzenia łańcuchów wywołań metod.

Wyjątki

Błąd – jeśli podane dane wejściowe są nieprawidłowe dla danych Firestore.

WriteBatch.update()

Aktualizuje pola w dokumencie, do którego odwołuje się ten DocumentReference. Aktualizacja się nie powiedzie, jeśli zostanie zastosowana do nieistniejącego dokumentu.

Zagnieżdżone pola można aktualizować, podając rozdzielone kropkami ciągi ścieżek pól lub obiekty FieldPath.

Podpis:

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

Parametry

Parametr Typ Opis
odniesienie do dokumentu DocumentReference<AppModelType, DbModelType> Odwołanie do dokumentu, który ma zostać zaktualizowany.
pole ciąg znaków | FieldPath Pierwsze pole do zaktualizowania.
wartość nieznany Pierwsza wartość.
więcej pól i wartości nieznana[] Dodatkowe pary klucz-wartość.

Zwroty:

Zapis wsadowy

Ta instancja WriteBatch. Służy do tworzenia łańcuchów wywołań metod.

Wyjątki

Błąd – jeśli podane dane wejściowe są nieprawidłowe dla danych Firestore.