Auth interface

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:

E-posta listesinden çık

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:

E-posta listesinden çık

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:

E-posta listesinden çık

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