Pakiet SDK Cloud Firestore Lite Web SDK

Firestore to skalowalne rozwiązanie bazy danych, które umożliwia utrzymywanie synchronizacji danych na różnych klientach internetowych.

W przypadku wielu aplikacji obsługa zarządzanego trybu offline Firestore jest szczególnie ważna, ponieważ umożliwia tworzenie responsywnych aplikacji, które działają niezależnie od opóźnień w sieci lub połączenia z internetem. Pakiety SDK z większą liczbą funkcji są jednak większe. Co Firebase oferuje w przypadku aplikacji, które wymagają tylko podstawowych operacji tworzenia, odczytu, aktualizowania i usuwania, a nie potrzebują obsługi w trybie offline?

Rozwiązanie: Firestore Lite

Firestore Lite to lekki, samodzielny pakiet SDK Firestore obsługujący pobieranie pojedynczych dokumentów, wykonywanie zapytań i aktualizowanie dokumentów. Jego rozmiar jest ułamkiem rozmiaru zwykłego pakietu SDK internetowego. Firestore Lite nie obsługuje kompensacji opóźnień, pamięci podręcznej offline, wznawiania zapytań ani odbiorników zrzutów, ale w pewnych przypadkach zmniejszenie rozmiaru biblioteki i czasu uruchamiania może być warte poświęcenia.

Importowanie Firestore Lite

Firestore Lite jest dostępny w npm jako część modułowego pakietu SDK. Jest więc w pełni modułowa i można ją zredukować.

Obsługiwany jest poniższy styl importowania.

import { initializeApp } from "firebase/app";
import {
   getFirestore,
   getDoc,
   updateDoc
} from 'firebase/firestore/lite';

Funkcje interfejsu API nie są obsługiwane przez Firestore Lite

Ze względu na rozmiar i szybkość Firestore Lite pomija te funkcje ze standardowego pakietu SDK Firestore:

  • Moduły obsługi zdarzeń DocumentSnapshot. Metoda onSnapshot oraz obiekty DocumentChange, SnapshotListenerOptions, SnapshotMetadata, SnapshotOptions i Unsubscribe nie są uwzględniane.
  • Pomocnicy wytrwałości. Metody enableIndexedDBPersistence, enableMultiTabIndexedDbPersistence i clearIndexedDbPersistence nie są uwzględniane.
  • Pakiety Firestore. Metoda loadBundle i powiązane z nią metody oraz obiekty LoadBundleTask i LoadBundleTaskProgress nie są uwzględniane.

Wdrażanie pobierania, zapytań i aktualizacji dokumentów

Po zaimportowaniu Firestore Lite możesz wykonywać wszystkie znane wywołania interfejsu API get i update. Mają zastosowanie we wszystkich przypadkach dodawania danych i pobierania danych.

import {
 getFirestore,
 getDoc,
 updateDoc,
 doc
} from '@firebase/firestore/lite';

const firestore = getFirestore(app);
const docRef = doc(firestore, 'collection/doc');
const docSnap = await getDoc(docRef);
await updateDoc(docRef, "field", 'value');

Kiedy używać Firestore Lite

Trudno jest zdecydować, kiedy zrezygnować ze standardowych funkcji trwałości offline i buforowania w pakiecie SDK Firestore. Warto je poznać, zanim zdecydujesz się odmienić je na mniejsze opłaty za Firestore Lite. Ogólnie rzecz biorąc, przy podejmowaniu decyzji o użyciu Firestore Lite należy wziąć pod uwagę te czynniki:

  • Stan online – Firestore Lite dobrze sprawdza się w aplikacjach, które nie wymagają aktualizacji na żywo i mają połączenie.
  • Ograniczenia rozmiaru – Firestore Lite jest świetnym rozwiązaniem, jeśli chcesz zmniejszyć ogólny rozmiar pakietu JavaScript.