Firebase Auth hizmetini temsil eden arayüz.
Firebase Auth hizmetinin nasıl kullanılacağıyla ilgili eksiksiz bir kılavuz için Firebase Authentication bölümüne bakın.
İmza:
export interface Auth
Özellikler
Özellik | Tür | Açıklama |
---|---|---|
uygulama | FirebaseUygulaması | Auth hizmet örneğiyle ilişkili FirebaseApp. |
yapılandırma | Yapılandırma | Bu örneği başlatmak için kullanılan Config. |
geçerliKullanıcı | Kullanıcı | boş | Şu anda oturum açmış olan kullanıcı (veya null). |
emulatorConfig | EmulatorConfig | boş | Geçerli emülatör yapılandırması (veya boş). |
languageCode | dize | boş | Auth örneğinin dil kodu. |
name | dize | Auth hizmet örneğiyle ilişkilendirilen uygulamanın adı. |
ayarlar | AuthSettings (Kimlik Doğrulama Ayarları) | Auth örneğinin ayarları. |
kiracıNo | dize | boş | Auth örneğinin kiracı kimliği. |
Yöntemler
Yöntem | Açıklama |
---|---|
authStateReady() | ilk yetkilendirme durumu sağlandığında hemen çözümlenen bir taahhüt döndürür. Taahhüt yerine getirildiğinde geçerli kullanıcı, geçerli bir kullanıcı veya oturumu kapattığında null olabilir. |
beforeAuthStateChanged(callback, onAbort) | Bir kimlik doğrulama durumu değişikliği yeni bir kullanıcı ayarlamadan önce çalışan bir engelleme geri çağırması ekler. |
onAuthStateChanged(nextOrObserver, hata, tamamlandı) | Kullanıcının oturum açma durumundaki değişiklikler için bir gözlemci ekler. |
onIdTokenChanged(nextOrObserver, hata, tamamlandı) | Oturum açmış kullanıcının kimlik jetonundaki değişiklikler için bir gözlemci ekler. |
setPersistence(persistence) | Auth örneğindeki kalıcılık türünü değiştirir. |
signOut(): | Geçerli kullanıcının oturumu kapatılır. Bu işlem, kullanıcının kimlik jetonunu otomatik olarak iptal etmez. |
updateCurrentUser(kullanıcı) | Sağlanan kullanıcıyı eşzamansız olarak Auth. örneğinde Auth.currentUser olarak ayarlar. |
useDeviceLanguage() | Geçerli dili varsayılan cihaz/tarayıcı tercihine ayarlar. |
Auth.uygulama
Auth
hizmet örneğiyle ilişkili FirebaseApp.
İmza:
readonly app: FirebaseApp;
Kimlik doğrulama
Bu örneği başlatmak için kullanılan Config.
İmza:
readonly config: Config;
Auth.currentUser
Şu anda oturum açmış olan kullanıcı (veya null).
İmza:
readonly currentUser: User | null;
Auth.emulatorConfig
Geçerli emülatör yapılandırması (veya boş).
İmza:
readonly emulatorConfig: EmulatorConfig | null;
Auth.languageCode
Auth örneğinin dil kodu.
Bu, okunabilir/yazılabilir bir özelliktir. Null değerine ayarlanırsa varsayılan Firebase konsolu dil ayarı uygulanır. Belirtilen sağlayıcıların belirtilen dil koduyla yerelleştirmeyi desteklemesi koşuluyla, dil kodu e-posta işlem şablonlarına (şifre sıfırlama, e-posta doğrulaması ve e-posta değişikliği iptali), telefon kimlik doğrulaması için SMS şablonlarına, reCAPTCHA doğrulayıcı ve OAuth pop-up/yönlendirme işlemlerine gönderilir.
İmza:
languageCode: string | null;
Yetkilendirme adı
Auth
hizmet örneğiyle ilişkilendirilen uygulamanın adı.
İmza:
readonly name: string;
Kimlik doğrulama ayarları
Auth örneğinin ayarları.
Bu, telefonla kimlik doğrulama için uygulama doğrulama modu gibi yapılandırmayla ilgili seçenekleri düzenlemek/okumak için kullanılır.
İmza:
readonly settings: AuthSettings;
Kimlik Doğrulayıcı Kimliği
Auth örneğinin kiracı kimliği.
Bu, okunabilir/yazılabilir bir özelliktir. Bir Auth örneğinin kiracı kimliğini belirlediğinizde, gelecekteki tüm oturum açma/kaydolma işlemleri bu kiracı kimliğini iletir ve belirtilen kiracı projesinde oturum açar veya kullanıcıları kaydeder. Null olarak ayarlanırsa kullanıcılar üst projede oturum açar.
İmza:
tenantId: string | null;
Örnek
// Set the tenant ID on Auth instance.
auth.tenantId = 'TENANT_PROJECT_ID';
// All future sign-in request now include tenant ID.
const result = await signInWithEmailAndPassword(auth, email, password);
// result.user.tenantId should be 'TENANT_PROJECT_ID'.
Auth.authStateReady()
ilk yetkilendirme durumu sağlandığında hemen çözümlenen bir taahhüt döndürür. Taahhüt yerine getirildiğinde geçerli kullanıcı, geçerli bir kullanıcı veya oturumu kapattığında null
olabilir.
İmza:
authStateReady(): Promise<void>;
Şunu döndürür:
Taahhüt<void>
Auth.beforeAuthStateChanged()
Bir kimlik doğrulama durumu değişikliği yeni bir kullanıcı ayarlamadan önce çalışan bir engelleme geri çağırması ekler.
İmza:
beforeAuthStateChanged(callback: (user: User | null) => void | Promise<void>, onAbort?: () => void): Unsubscribe;
Parametreler
Parametre | Tür | Açıklama |
---|---|---|
geri çağırma | (kullanıcı: Kullanıcı | null) => geçersiz | Taahhüt<void> | yeni kullanıcı değeri ayarlanmadan önce geri çağırma tetiklendi. Bu uyarı yayınlanırsa kullanıcının ayarlanması engellenir. |
onİptal | () => geçersiz | Daha sonra bir beforeAuthStateChanged() geri çağırması yapılırsa geri çağırma tetiklenerek yan etkileri geri almanıza olanak tanır. |
Şunu döndürür:
Auth.onAuthStateChanged()
Kullanıcının oturum açma durumundaki değişiklikler için bir gözlemci ekler.
Eski davranışı korumak için Auth.onIdTokenChanged() öğesine bakın.
İmza:
onAuthStateChanged(nextOrObserver: NextOrObserver<User | null>, error?: ErrorFn, completed?: CompleteFn): Unsubscribe;
Parametreler
Parametre | Tür | Açıklama |
---|---|---|
sonrakiOrGözlemci | NextOrObserver<Kullanıcı | null> | değişiklikten sonra geri çağırma tetiklendi. |
hata | HataFn | Kullanımdan kaldırıldı. Bu geri çağırma hiçbir zaman tetiklenmez. Oturum açma/kapatma sırasında yapılan hatalar, oturum açma/oturum kapatma işlevlerinden döndürülen vaatlerde fark edilebilir. |
tamamlandı | TamamlaFn | Kullanımdan kaldırıldı. Bu geri çağırma hiçbir zaman tetiklenmez. |
Şunu döndürür:
Auth.onIdTokenChanged()
Oturum açmış kullanıcının kimlik jetonundaki değişiklikler için bir gözlemci ekler.
Buna oturum açma, oturum kapatma ve jeton yenileme etkinlikleri dahildir.
İmza:
onIdTokenChanged(nextOrObserver: NextOrObserver<User | null>, error?: ErrorFn, completed?: CompleteFn): Unsubscribe;
Parametreler
Parametre | Tür | Açıklama |
---|---|---|
sonrakiOrGözlemci | NextOrObserver<Kullanıcı | null> | değişiklikten sonra geri çağırma tetiklendi. |
hata | HataFn | Kullanımdan kaldırıldı. Bu geri çağırma hiçbir zaman tetiklenmez. Oturum açma/kapatma sırasında yapılan hatalar, oturum açma/oturum kapatma işlevlerinden döndürülen vaatlerde fark edilebilir. |
tamamlandı | TamamlaFn | Kullanımdan kaldırıldı. Bu geri çağırma hiçbir zaman tetiklenmez. |
Şunu döndürür:
Auth.setPersistence()
Auth
örneğindeki kalıcılık türünü değiştirir.
Bu durum, şu anda kayıtlı olan Auth oturumunu etkiler ve yönlendirme istekleriyle oturum açma da dahil olmak üzere gelecekteki oturum açma istekleri için bu tür kalıcılığı uygular.
Bu, oturum açan bir kullanıcının oturumunun hatırlanıp hatırlanmayacağını belirtmesini kolaylaştırır. Ayrıca, diğer kullanıcılar tarafından paylaşılan veya hassas veriler içeren uygulamalar için Yetkilendirme durumunun hiçbir zaman geçerli olmamasını da kolaylaştırır.
Bu yöntem Node.js ortamında çalışmaz.
İmza:
setPersistence(persistence: Persistence): Promise<void>;
Parametreler
Parametre | Tür | Açıklama |
---|---|---|
sebat | Kararlılık | Kullanılacak Kalıcılık. |
Şunu döndürür:
Taahhüt<void>
Örnek
auth.setPersistence(browserSessionPersistence);
Auth.signOut()
Geçerli kullanıcının oturumu kapatılır. Bu işlem, kullanıcının kimlik jetonunu otomatik olarak iptal etmez.
Bu yöntem, FirebaseServerApp ile oluşturulan Auth örnekleri tarafından desteklenmez.
İmza:
signOut(): Promise<void>;
Şunu döndürür:
Taahhüt<void>
Auth.updateCurrentUser()
Sağlanan kullanıcıyı eşzamansız olarak Auth.currentUser olarak, Auth örneğinde ayarlar.
Kullanıcının sağlanan yeni bir örnek kopyası oluşturulur ve currentUser olarak ayarlanır.
Bu, diğer oturum açma yöntemlerinde olduğu gibi Auth.onAuthStateChanged() ve Auth.onIdTokenChanged() işleyicilerini tetikler.
Güncellenecek kullanıcı farklı bir Firebase projesine aitse işlem başarısız olur.
İmza:
updateCurrentUser(user: User | null): Promise<void>;
Parametreler
Parametre | Tür | Açıklama |
---|---|---|
kullanıcı | Kullanıcı | boş | Yeni Kullanıcı. |
Şunu döndürür:
Taahhüt<void>
Auth.useDeviceLanguage()
Geçerli dili varsayılan cihaz/tarayıcı tercihine ayarlar.
İmza:
useDeviceLanguage(): void;
Şunu döndürür:
geçersiz