SDK של Cloud Firestore Lite Web

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

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

הפתרון: Firestore Lite

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

ייבוא Firestore Lite

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

אפשר לייבא את הסגנון הבא.

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

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

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

• גורמים מטפלים באירועים של DocumentSnapshot. ה-method onSnapshot והאובייקטים DocumentChange, ‏ SnapshotListenerOptions, ‏ SnapshotMetadata,‏ SnapshotOptions ו-Unsubscribe לא נכללים.
• כלי עזר לשמירה. ה-methods‏ 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

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

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