auth

auth(app) returns firebase.auth.Auth

Gets the Auth service for the default app or a given app.

firebase.auth() can be called with no arguments to access the default app's Auth service or as firebase.auth(app) to access the Auth service associated with a specific app.

Parameter

app

Optional

firebase.app.App

Value must not be null.

Returns

non-null firebase.auth.Auth 

Examples

// Get the Auth service for the default app
var defaultAuth = firebase.auth();
// Get the Auth service for a given app
var otherAuth = firebase.auth(otherApp);

Classes

Interfaces

Abstract types

ActionCodeSettings

static

{url: string, iOS: ({bundleId: string} or undefined), android: ({packageName: string, installApp: (boolean or undefined), minimumVersion: (string or undefined)} or undefined), handleCodeInApp: (boolean or undefined)}

This is the interface that defines the required continue/state URL with optional Android and iOS bundle identifiers. The action code setting fields are:

  • url: Sets the link continue/state URL, which has different meanings in different contexts:

    • When the link is handled in the web action widgets, this is the deep link in the continueUrl query parameter.
    • When the link is handled in the app directly, this is the continueUrl query parameter in the deep link of the Dynamic Link.
  • iOS: Sets the iOS bundle ID. This will try to open the link in an iOS app if it is installed.
  • android: Sets the Android package name. This will try to open the link in an android app if it is installed. If installApp is passed, it specifies whether to install the Android app if the device supports it and the app is not already installed. If this field is provided without a packageName, an error is thrown explaining that the packageName must be provided in conjunction with this field. If minimumVersion is specified, and an older version of the app is installed, the user is taken to the Play Store to upgrade the app.
  • handleCodeInApp: The default is false. When set to true, the action code link will be be sent as a Universal Link or Android App Link and will be opened by the app if installed. In the false case, the code will be sent to the web widget first and then on continue will redirect to the app if installed.

AdditionalUserInfo

static

{providerId: string, profile: nullable Object, username: (nullable string or undefined), isNewUser: boolean}

A structure containing additional user information from a federated identity provider.

UserCredential

static

{user: nullable firebase.User, credential: nullable firebase.auth.AuthCredential, operationType: (nullable string or undefined), additionalUserInfo: (nullable firebase.auth.AdditionalUserInfo or undefined)}

A structure containing a User, an AuthCredential, the operationType, and any additional user information that was returned from the identity provider. operationType could be 'signIn' for a sign-in operation, 'link' for a linking operation and 'reauthenticate' for a reauthentication operation.