SDK של Cloud Firestore Lite Web

Firestore הוא פתרון מסד נתונים גמיש שמאפשר לסנכרן נתונים בין לקוחות אינטרנט.

בתכנון אפליקציות רבות, התמיכה המנוהלת של Firestore במצב אופליין חשובה במיוחד, כי היא מאפשרת ליצור אפליקציות רספונסיביות שפועלות ללא קשר לזמן האחזור ברשת או לחיבור לאינטרנט. עם זאת, ערכות SDK עם הרבה תכונות גדולות יותר. מה Firebase מציעה לאפליקציות שצריכות רק לבצע פעולות בסיסיות של יצירה, קריאה, עדכון ומחיקה, ולא צריכות תמיכה מנוהלת אופליין?

פתרון: Firestore Lite

Firestore Lite הוא ערכת SDK של Firestore קלילה ועצמאית ל-REST בלבד, שתומכת באחזור של מסמך יחיד, בהרצת שאילתות ובעדכוני מסמכים, בחלק קטן מהגודל של ערכת ה-SDK הרגילה לאינטרנט. ב-Firestore Lite לא ניתן להשתמש בתכונות כמו תגמול על זמן אחזור, שמירה במטמון אופליין, המשך של שאילתות ומאזינים לתמונות מצב, אבל במקרים מסוימים, היתרון של צמצום גודל הספרייה וזמן ההפעלה הוא משמעותי.

ייבוא של Firestore Lite

Firestore Lite זמין דרך npm כחלק מה-SDK המודולרי. כך הוא גם מודולרי לחלוטין וגם ניתן לשימוש ב-tree-shake.

המערכת תומכת בסגנון הייבוא הבא.

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

תכונות API שלא נתמכות ב-Firestore Lite

כדי לשמור על גודל וזריזות, ב-Firestore Lite לא נכללות התכונות הבאות מ-Firestore SDK הרגיל:

• פונקציות טיפול באירועים של DocumentSnapshot. השיטה onSnapshot והאובייקטים DocumentChange, ‏ SnapshotListenerOptions, ‏ SnapshotMetadata,‏ SnapshotOptions ו-Unsubscribe לא נכללים.
• עזרים לשמירה. השיטות enableIndexedDBPersistence,‏ enableMultiTabIndexedDbPersistence ו-clearIndexedDbPersistence לא נכללות.
• חבילות של Firestore. השיטה loadBundle והשיטות הקשורות, והאובייקטים LoadBundleTask ו-LoadBundleTaskProgress לא נכללים.

הטמעת אחזור, שאילתה ועדכון של מסמכים

אחרי שמייבאים את Firestore Lite, אפשר לבצע את כל הקריאות המוכרות של API לקבלה ולעדכון. כל התרחישים לדוגמה להוספת נתונים ולקבלת נתונים רלוונטיים.

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

מתי כדאי להשתמש ב-Firestore Lite

לפעמים קשה להחליט מתי להפסיק להשתמש בתכונות השמירה אופליין והאחסון במטמון של Firestore SDK הסטנדרטי. כדאי להבין את התכונות האלה לפני שמחליטים להחליף אותן בעלות הנמוכה יותר של Firestore Lite. באופן כללי, כדאי להביא בחשבון את הגורמים הבאים כשמחליטים אם להשתמש ב-Firestore Lite:

• סטטוס אונליין – Firestore Lite מתאים לאפליקציות שאין בהן צורך בעדכונים בזמן אמת ויש להן קישוריות.
• אילוצים של גודל – Firestore Lite הוא פתרון מצוין אם רוצים לצמצם את הגודל הכולל של חבילת ה-JavaScript.