يمكنك تفعيل الوظائف استجابةً لإنشاء حسابات مستخدمي Firebase وحذفها. على سبيل المثال، يمكنك إرسال رسالة ترحيب إلكترونية إلى مستخدم أنشأ حسابًا في تطبيقك. تستند الأمثلة الواردة في هذه الصفحة إلى عيّنة تعمل على ذلك بالضبط، أي إرسال رسائل ترحيب إلكترونية ورسائل وداعًا بعد إنشاء الحساب وحذفه.
للحصول على المزيد من الأمثلة على حالات الاستخدام، يُرجى الاطّلاع على المقالة ما الذي يمكنني فعله باستخدام دوال Cloud؟.
تشغيل دالة عند إنشاء المستخدم
يمكنك إنشاء دالة يتم تشغيلها عند إنشاء مستخدم Firebase باستخدام معالج حدث functions.auth.user().onCreate():
exports.sendWelcomeEmail = functions.auth.user().onCreate((user) => {
// ...
});
ستشغّل حسابات Firebase أحداث إنشاء المستخدمين لـ Cloud Functions في الحالات التالية:
- ينشئ المستخدم حساب بريد إلكتروني وكلمة مرور.
- يسجِّل المستخدم الدخول لأول مرة باستخدام موفِّر هوية موحّد.
- يُنشئ مطوّر البرامج حسابًا باستخدام حزمة تطوير البرامج (SDK) لمشرف Firebase.
- يسجِّل المستخدم الدخول إلى جلسة مصادقة جديدة مجهولة المصدر لأول مرة.
لا يتم تشغيل حدث Cloud Functions عندما يسجِّل المستخدم الدخول لأول مرة باستخدام رمز مميّز مخصَّص.
الوصول إلى سمات المستخدمين
من بيانات المستخدمين التي تم إرجاعها إلى الدالة، يمكنك الوصول إلى قائمة سمات المستخدمين المتوفرة في كائن UserRecord للمستخدم الذي تم إنشاؤه حديثًا. على سبيل المثال، يمكنك الحصول على عنوان البريد الإلكتروني للمستخدم والاسم المعروض كما هو موضّح:
const email = user.email; // The email of the user. const displayName = user.displayName; // The display name of the user.
تشغيل دالة عند حذف المستخدم
مثلما يمكنك تشغيل دالة عند إنشاء المستخدم، يمكنك الرد على أحداث حذف المستخدم. استخدِم معالِج أحداث
functions.auth.user().onDelete()
كما هو موضّح:
exports.sendByeEmail = functions.auth.user().onDelete((user) => {
// ...
});
تشغيل دوال الحظر
إذا تمت الترقية إلى مصادقة Firebase باستخدام النظام الأساسي للهوية، يمكنك توسيع نطاق مصادقة Firebase من خلال حظر دوال Cloud.
تتيح لك دوال الحظر تنفيذ رموز مخصَّصة تعدِّل نتيجة تسجيل المستخدم لتطبيقك أو تسجيل الدخول إليه. على سبيل المثال، يمكنك منع المستخدم من المصادقة في حال عدم استيفائه معايير معيّنة، أو يمكنك تعديل معلومات المستخدم قبل عرضها على تطبيق العميل.