SDK da Web do Cloud Firestore Lite

O Firestore é uma boa solução de banco de dados escalável para manter os dados sincronizados entre os clientes da Web.

Para muitos aplicativos, o suporte off-line gerenciado do Firestore é especialmente importante, permitindo criar aplicativos responsivos que funcionam independentemente da latência da rede ou da conectividade com a Internet. Mas os SDKs ricos em recursos têm um custo de tamanho. O que o Firebase oferece para aplicativos que só precisam usar operações básicas de criação, leitura, atualização e exclusão e não precisam de suporte off-line gerenciado?

Observação: antes de usar o Firestore Lite, entenda a API padrão da Web do Firestore e os recursos off-line do Firestore como parte do conjunto completo de recursos . Recomendamos o Firestore Lite para desenvolvedores que tenham experiência em criar com o Firestore e possam avaliar as vantagens de usar uma versão leve.

Solução: Firestore Lite

O Firestore Lite é um SDK Firestore leve e autônomo somente REST que oferece suporte a buscas de documentos únicos, execução de consultas e atualizações de documentos, em uma fração do tamanho normal do SDK da Web. O Firestore Lite omite compensação de latência, cache offline, retomada de consulta e listeners de instantâneos, mas para casos de uso específicos, as reduções no tamanho da biblioteca e no tempo de inicialização são uma grande compensação.

Importar Firestore Lite

O Firestore Lite está disponível via npm como parte do SDK modular . É, portanto, totalmente modular e agitável.

O seguinte estilo de importação é suportado.

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

Recursos de API não compatíveis com o Firestore Lite

Por tamanho e velocidade, o Firestore Lite omite estes recursos do SDK padrão do Firestore:

• Manipuladores de eventos DocumentSnapshot . O método onSnapshot e os objetos DocumentChange , SnapshotListenerOptions , SnapshotMetadata , SnapshotOptions e Unsubscribe não estão incluídos.
• Auxiliares de persistência . Os enableIndexedDBPersistence , enableMultiTabIndexedDbPersistence e clearIndexedDbPersistence não estão incluídos.
• Pacotes Firestore . O método loadBundle e métodos relacionados e os objetos LoadBundleTask e LoadBundleTaskProgress não estão incluídos.

Implemente buscas, consultas e atualizações de documentos

Depois de importar o Firestore Lite, você pode fazer todas as chamadas de obtenção e atualização da API familiar. Os casos de uso para adicionar e obter dados se aplicam.

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 usar o Firestore Lite

Pode ser complicado decidir quando deixar de lado os recursos offline de persistência e armazenamento em cache do Firestore SDK padrão. Você deve entender esses recursos antes de decidir trocá-los pela menor sobrecarga do Firestore Lite. Em geral, avalie estes fatores ao decidir se deve usar o Firestore Lite:

• Status online - Firestore Lite é bom para aplicativos que não precisam de atualizações ao vivo e têm conectividade.
• Restrições de tamanho - o Firestore Lite é ótimo se você quiser reduzir o tamanho geral do pacote JavaScript.