حزمة تطوير البرامج (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.