خيارات الإعداد الممنوحة لـ InitializeServerApp()
Signature:
export interface FirebaseServerAppSettings extends Omit<FirebaseAppSettings, 'name'>
للتمديد: حذف<FirebaseAppSettings, 'name'>
أماكن إقامة
| الموقع | Type | الوصف |
|---|---|---|
| authIdToken | سلسلة | يُستخدَم رمز مميّز اختياري لرقم تعريف المصادقة لاستئناف جلسة مستخدم تم تسجيل الدخول إليها من بيئة وقت تشغيل للعميل.يؤدي استدعاء getAuth مع FirebaseServerApp تم ضبطه باستخدام authIdToken تم التحقّق منه إلى محاولة تلقائية لتسجيل دخول المستخدم الذي تمثّله authIdToken. يجب إنشاء الرمز المميّز مؤخرًا لكي تنجح هذه العملية.إذا تعذّر الرمز المميّز في إجراء عملية التحقق على الجهاز، أو إذا تعذّر على خدمة المصادقة التحقُّق من صحة الرمز عند إعداد حزمة تطوير البرامج (SDK)، سيتم تسجيل تحذير في وحدة التحكّم ولن تسجِّل حزمة تطوير البرامج (SDK) للمصادقة دخول مستخدم عند الإعداد.إذا سجّل المستخدم الدخول بنجاح، يتم استدعاء مسار معاودة الاتصال onAuthStateChanged لمثيل المصادقة باستخدام كائن User وفقًا لخطوات المصادقة العادية. في المقابل، لا تحتوي كائنات User التي تم إنشاؤها من خلال authIdToken على رمز مميّز لإعادة التحميل. تعذّر إتمام عمليات refreshToken المحاولة. |
| ReleaseOnDeref | كائن | كائن اختياري. تستخدم حزمة تطوير البرامج (SDK) لمنصة Firebase، في حال توفيرها، كائن FinalizationRegistry لمراقبة حالة جمع البيانات غير المرغوب فيها للعنصر المقدَّم. تُصدِر حزمة تطوير البرامج (SDK) لمنصّة Firebase مرجعها على المثيل FirebaseServerApp عندما يتم جمع البيانات غير المرغوب فيها في كائن releaseOnDeref المقدَّم.يمكنك استخدام هذا الحقل لتقليل النفقات العامة لإدارة الذاكرة لتطبيقك. في حال توفُّر تطبيق يتم تشغيله باستخدام بطاقة SSR، لا يحتاج التطبيق إلى إزالة FirebaseServerApp، ما دام العنصر المرجعي محذوفًا (بسبب خروجه من نطاق SSR مثلاً).في حال عدم توفير أحد العناصر، يجب أن ينظف التطبيق مثيل FirebaseServerApp من خلال استدعاء deleteApp.إذا كان التطبيق يوفّر عنصرًا في هذه المَعلمة، ولكن يتم تنفيذ التطبيق في محرك JavaScript الذي يسبق إتاحة العقدة FinalizationRegistry.FirebaseServerApp |
FirebaseServerAppSettings.authIdToken
هو رمز مميّز اختياري لرقم تعريف المصادقة يُستخدَم لاستئناف جلسة مستخدم مسجّل الدخول من بيئة وقت تشغيل للبرنامج.
يؤدي استدعاء getAuth مع FirebaseServerApp تم ضبطه على authIdToken تم التحقّق منه إلى محاولة تلقائية لتسجيل دخول المستخدم الذي تمثّله authIdToken. يجب أن يكون الرمز المميّز قد تم إنشاؤه مؤخرًا لنجاح هذه العملية.
إذا تعذّر على الرمز المميّز إثبات الملكية على الجهاز، أو إذا تعذّر على خدمة المصادقة التحقّق من صحته عند إعداد حزمة تطوير البرامج (SDK) للمصادقة، سيتم تسجيل تحذير في وحدة التحكّم ولن تسجِّل حزمة تطوير البرامج (SDK) للمصادقة دخول مستخدم عند الإعداد.
إذا سجَّل مستخدم الدخول بنجاح، يتم استدعاء استدعاء onAuthStateChanged لمثيل Auth باستخدام العنصر User وفقًا لمسارات المصادقة العادية. في المقابل، لا تحتوي كائنات User التي تم إنشاؤها من خلال authIdToken على رمز مميّز لإعادة التحميل. تعذّر إتمام عمليات refreshToken المحاولة.
Signature:
authIdToken?: string;
FirebaseServerAppSettings.releaseOnDeref
كائن اختياري. تستخدم حزمة تطوير البرامج (SDK) لمنصة Firebase، في حال توفيرها، كائن FinalizationRegistry لمراقبة حالة جمع البيانات غير المرغوب فيها للعنصر المقدَّم. تُصدِر حزمة تطوير البرامج (SDK) لمنصّة Firebase مرجعها على المثيل FirebaseServerApp عندما يكون عنصر releaseOnDeref المُقدَّم غير صالح.
يمكنك استخدام هذا الحقل لتقليل عبء إدارة الذاكرة لتطبيقك. في حال توفير هذه الأذونات، لا يحتاج أي تطبيق يتم تشغيله باستخدام بطاقة SSR إلى إزالة البرامج غير المرغوب فيها FirebaseServerApp، ما دام قد تم حذف العنصر المرجعي (بسبب خروجه من نطاق SSR مثلاً).
في حال عدم توفير كائن، يجب أن يزيل التطبيق مثيل FirebaseServerApp من خلال استدعاء deleteApp.
وإذا كان التطبيق يوفّر عنصرًا في هذه المَعلمة، ولكن تم تنفيذه في محرّك JavaScript يسبق دعم FinalizationRegistry (تم طرحه في العقدة 14.6.0 مثلاً)، يحدث خطأ عند إعداد FirebaseServerApp.
Signature:
releaseOnDeref?: object;