firebase-admin.extensions package

خدمة إضافات Firebase.

الوظائف

الوظيفة الوصف
getExtensions(app) يمكن الحصول على خدمة الإضافات للتطبيق التلقائي أو لتطبيق معيّن.يمكن استدعاء getExtensions() بدون وسيطات للوصول إلى خدمة Extensions في التطبيق التلقائي أو طلبه باسم getExtensions(app) للوصول إلى خدمة Extensions المرتبطة بتطبيق معيّن.

صفوف

الفئة الوصف
الإضافات واجهة خدمة Extensions في Firebase
وقت التشغيل يوفر وقت التشغيل طرقًا لتعديل بيانات وقت تشغيل مثيل الإضافة.

الأسماء المستعارة للنوع

النوع البديل الوصف
SettableProcessingState تمثّل السمة SettableProcessingState جميع حالات المعالجة التي يمكن ضبطها على بيانات وقت تشغيل مثيل الإضافة.

getExtensions(app)

يمكنك الحصول على خدمة الإضافات للتطبيق التلقائي أو لتطبيق معيّن.

يمكن طلب getExtensions() بدون وسيطات للوصول إلى خدمة Extensions للتطبيق التلقائي أو كـ getExtensions(app) للوصول إلى خدمة Extensions المرتبطة بتطبيقٍ معيّن.

Signature:

export declare function getExtensions(app?: App): Extensions;

المَعلمات

المَعلمة Type الوصف
التطبيق التطبيق التطبيق الاختياري الذي يتم عرض خدمة Extensions له. وفي حال عدم توفيرها، يتم عرض خدمة Extensions التلقائية.

المرتجعات:

الإضافات

هي خدمة Extensions التلقائية في حال عدم توفُّر أي تطبيق، أو خدمة Extensions المرتبطة بالتطبيق المقدَّم.

مثال 1

// Get the `Extensions` service for the default app
const defaultExtensions = getExtensions();

مثال 2

// Get the `Extensions` service for a given app
const otherExtensions = getExtensions(otherApp);

سياسة SettableProcessingState

تمثّل السمة SettableProcessingState جميع حالات المعالجة التي يمكن ضبطها على بيانات وقت تشغيل مثيل الإضافة.

يمكنك ضبط الحالات التالية:

  • NONE: لم يتم تنفيذ أي إجراءات ذات صلة بالأحداث الخاصة بمراحل النشاط. عليك ضبط هذا الخيار لمحو الحالات القديمة.

  • PROCESSING_COMPLETE: اكتمل عمل الحدث في مراحل النشاط بدون أخطاء.

  • PROCESSING_WARNING: نجح تشغيل الحدث في مراحل النشاط جزئيًا، أو حدث يجب تحذير المستخدم بشأنه.

  • PROCESSING_FAILED: تعذّر إتمام عمل حدث مراحل النشاط تمامًا، ولكن المثيل سيظل يعمل بشكل صحيح من الآن فصاعدًا.

إذا كانت مثيل الإضافة في حالة معطّلة بسبب أخطاء، عليك بدلاً من ذلك استدعاء الدالة Runtime.setFatalError().

يتم ضبط حالة "المعالجة" تلقائيًا عند بدء تشغيل معالج أحداث مراحل النشاط، ولا يمكنك ضبطها بشكل صريح. للإبلاغ عن الحالة المستمرة لوظيفة إحدى الإضافات، استخدِم console.log أو حزمة تطوير البرامج (SDK) لمسجِّل وظائف Cloud.

Signature:

export type SettableProcessingState = 'NONE' | 'PROCESSING_COMPLETE' | 'PROCESSING_WARNING' | 'PROCESSING_FAILED';