Join us in person and online for Firebase Summit on October 18, 2022. Learn how Firebase can help you accelerate app development, release your app with confidence, and scale with ease. Register now

Cloud Firestore Lite Web SDK

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Firestore è una buona soluzione di database scalabile per mantenere i dati sincronizzati tra i client Web.

Per molte app, il supporto offline gestito di Firestore è particolarmente importante, poiché consente di creare app reattive che funzionano indipendentemente dalla latenza di rete o dalla connettività Internet. Ma gli SDK ricchi di funzionalità hanno un costo di dimensioni. Cosa offre Firebase per le app che devono utilizzare solo operazioni di base di creazione, lettura, aggiornamento ed eliminazione e non necessitano di supporto offline gestito?

Soluzione: Firestore Lite

Firestore Lite è un SDK Firestore leggero e autonomo, solo REST, che supporta il recupero di documenti singoli, l'esecuzione di query e gli aggiornamenti dei documenti, a una frazione delle normali dimensioni dell'SDK Web. Firestore Lite omette la compensazione della latenza, la memorizzazione nella cache offline, la ripresa delle query e gli snapshot listener, ma per casi d'uso particolari, le riduzioni delle dimensioni della libreria e del tempo di avvio rappresentano un ottimo compromesso.

Importa Firestore Lite

Firestore Lite è disponibile tramite npm come parte dell'SDK modulare . È quindi completamente modulare e scuotibile.

È supportato il seguente stile di importazione.

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

Funzionalità API non supportate da Firestore Lite

Per dimensioni e velocità, Firestore Lite omette queste funzionalità dall'SDK Firestore standard:

  • Gestori di eventi DocumentSnapshot . Il metodo onSnapshot e gli oggetti DocumentChange , SnapshotListenerOptions , SnapshotMetadata , SnapshotOptions e Unsubscribe non sono inclusi.
  • Aiutanti di persistenza . I enableIndexedDBPersistence , enableMultiTabIndexedDbPersistence e clearIndexedDbPersistence non sono inclusi.
  • Pacchetti Firestore . Il metodo loadBundle e i metodi correlati e gli oggetti LoadBundleTask e LoadBundleTaskProgress non sono inclusi.

Implementare recuperi, query e aggiornamenti di documenti

Dopo aver importato Firestore Lite, puoi effettuare tutte le chiamate API familiari per ottenere e aggiornare. Si applicano tutti i casi d'uso per l'aggiunta e il recupero dei dati .

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');

Quando usare Firestore Lite

Può essere difficile decidere quando abbandonare le funzionalità di persistenza offline e di memorizzazione nella cache dell'SDK standard di Firestore. Dovresti comprendere queste funzionalità prima di decidere di scambiarle con il sovraccarico inferiore di Firestore Lite. In generale, valuta questi fattori quando decidi se utilizzare Firestore Lite:

  • Stato online : Firestore Lite è utile per le app che non necessitano di aggiornamenti in tempo reale e dispongono di connettività.
  • Vincoli di dimensione - Firestore Lite è ottimo se desideri ridurre le dimensioni complessive del pacchetto JavaScript.