حزمة تطوير البرامج (SDK) للويب في Cloud Firestore Lite

‫Firestore هو حلّ جيد لقاعدة بيانات قابلة للتطوير من أجل مزامنة البيانات على مستوى عملاء الويب.

بالنسبة إلى العديد من التطبيقات، من المهم بشكل خاص أن يتوفّر في Firestore وضع "العمل بلا إنترنت" المُدار، مما يتيح لك إنشاء تطبيقات سريعة الاستجابة تعمل بغض النظر عن وقت استجابة الشبكة أو اتصال الإنترنت. ولكن حِزم SDK الغنية بالميزات تزيد من حجم التطبيق. ما هو الإجراء الذي تقدّمه Firebase للتطبيقات التي لا تحتاج سوى إلى استخدام عمليات الإنشاء والقراءة والتعديل والحذف الأساسية، ولا تحتاج إلى دعم مُدار بلا إنترنت؟

الحل: Firestore Lite

‫Firestore Lite هي حزمة تطوير برامج (SDK) خفيفة الوزن ومُستقلة تستخدم بروتوكول REST فقط في Firestore، وهي تسمح بجمع مستند واحد وتنفيذ طلبات بحث وتعديل مستندات، وذلك بحجم يمثّل ‫جزءًا بسيطًا من حجم حزمة تطوير البرامج (SDK) العادية للويب. لا يتضمّن Firestore Lite ميزة تعويض وقت الاستجابة، والتخزين المؤقت بلا إنترنت، واستئناف طلبات البحث، ومُستمعي اللقطات، ولكن في حالات استخدام معيّنة، يُعدّ تقليل حجم المكتبة ووقت بدء التشغيل ميزة رائعة.

استيراد Firestore Lite

تتوفّر أداة Firestore Lite من خلال npm كجزء من حزمة تطوير البرامج (SDK) المُجمَّعة. وبالتالي، فإنّه مكوّن من وحدات بالكامل ويمكن إزالة أي وحدات منه.

يتوفّر أسلوب الاستيراد التالي.

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

ميزات واجهة برمجة التطبيقات غير المتوافقة مع Firestore Lite

من أجل تقليل الحجم والسرعة، لا تتضمّن حزمة Firestore Lite الإصدار العادي من مكتبة تنمية البرامج (SDK) لـ Firestore:

  • معالجات أحداث DocumentSnapshot لا يتم تضمين الطريقة onSnapshot و كائنات DocumentChange وSnapshotListenerOptions وSnapshotMetadata وSnapshotOptions وUnsubscribe.
  • مساعِد الاحتفاظ بالبيانات لا يتم تضمين الطريقتَين enableIndexedDBPersistence وenableMultiTabIndexedDbPersistence وclearIndexedDbPersistence.
  • حِزم Firestore: لا يتم تضمين الطريقة loadBundle والطرق المرتبطة بها، والكائنَين LoadBundleTask وLoadBundleTaskProgress.

تنفيذ عمليات جلب المستندات وطلبات البحث عنها وتعديلها

بعد استيراد Firestore Lite، يمكنك إجراء جميع طلبات البيانات وتعديلات واجهة برمجة التطبيقات المألوفة. تنطبق جميع حالات استخدام إضافة البيانات والحصول على البيانات.

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 الإجمالية.