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 dostępny tylko w trybie REST, który obsługuje pobieranie pojedynczych dokumentów, wykonywanie zapytań i aktualizowanie dokumentów w ułamku zwykłego rozmiaru pakietu SDK internetowego. Firestore Lite pomija kompensację czasu oczekiwania, buforowanie offline, wznawianie zapytań i detektory zrzutów, ale w szczególnych przypadkach ograniczenie rozmiaru biblioteki i czasu uruchomienia to świetna korzyść.

Importowanie Firestore Lite

Usługa Firestore Lite jest dostępna przez npm w ramach modułowego pakietu SDK. Jest więc w pełni modułowa i można ją zredukować.

Obsługiwany jest ten styl importowania.

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

Funkcje interfejsu API nieobsługiwane przez Firestore Lite

Ze względu na rozmiar i szybkość Firestore Lite pomija te funkcje w standardowym pakiecie SDK Firestore:

  • Moduły obsługi zdarzeń DocumentSnapshot Metoda onSnapshot oraz obiekty DocumentChange, SnapshotListenerOptions, SnapshotMetadata, SnapshotOptions i Unsubscribe nie są uwzględnione.
  • Pomocnicze funkcje trwałości. Metody enableIndexedDBPersistence, enableMultiTabIndexedDbPersistenceclearIndexedDbPersistence nie są uwzględniane.
  • pakiety Firestore. Metoda loadBundle, powiązane z nią metody oraz obiekty LoadBundleTask i LoadBundleTaskProgress nie są uwzględnione.

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

Po zaimportowaniu Firestore Lite możesz wykonywać wszystkie znane wywołania interfejsu API get i update. Dotyczy to wszystkich przypadków użycia dotyczących dodawania danychpobierania 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. Zanim zdecydujesz się na zastąpienie tych funkcji niższym obciążeniem Firestore Lite, zapoznaj się z nimi. Ogólnie rzecz biorąc, przy podejmowaniu decyzji o użyciu Firestore Lite należy wziąć pod uwagę te czynniki:

  • Stan online – Firestore Lite jest odpowiedni dla aplikacji, które nie wymagają aktualizacji na bieżąco i mają połączenie z internetem.
  • Ograniczenia rozmiaru – Firestore Lite jest świetnym rozwiązaniem, jeśli chcesz zmniejszyć ogólny rozmiar pakietu JavaScript.