Project: /docs/reference/js/_project.yaml Book: /docs/reference/_book.yaml page_type: reference

{% comment %} DO NOT EDIT THIS FILE! This is generated by the JS SDK team, and any local changes will be overwritten. Changes should be made in the source code at https://github.com/firebase/firebase-js-sdk {% endcomment %}

FacebookAuthProvider class

Provider for generating an OAuthCredential for ProviderId.FACEBOOK.

Signature:

typescript

export declare class FacebookAuthProvider extends BaseOAuthProvider

Extends: BaseOAuthProvider

Constructors

Constructor	Modifiers	Description
(constructor)()		Constructs a new instance of the <code>FacebookAuthProvider</code> class

Properties

Property	Modifiers	Type	Description
FACEBOOK_SIGN_IN_METHOD	<code>static</code>	'facebook.com'	Always set to SignInMethod<!-- -->.FACEBOOK.
PROVIDER_ID	<code>static</code>	'facebook.com'	Always set to ProviderId<!-- -->.FACEBOOK.

Methods

Method	Modifiers	Description
credential(accessToken)	<code>static</code>	Creates a credential for Facebook.
credentialFromError(error)	<code>static</code>	Used to extract the underlying OAuthCredential from a AuthError which was thrown during a sign-in, link, or reauthenticate operation.
credentialFromResult(userCredential)	<code>static</code>	Used to extract the underlying OAuthCredential from a UserCredential<!-- -->.

FacebookAuthProvider.(constructor)

Constructs a new instance of the FacebookAuthProvider class

Signature:

typescript

constructor();

FacebookAuthProvider.FACEBOOK_SIGN_IN_METHOD

Always set to SignInMethod.FACEBOOK.

Signature:

typescript

static readonly FACEBOOK_SIGN_IN_METHOD: 'facebook.com';

FacebookAuthProvider.PROVIDER_ID

Always set to ProviderId.FACEBOOK.

Signature:

typescript

static readonly PROVIDER_ID: 'facebook.com';

FacebookAuthProvider.credential()

Creates a credential for Facebook.

Signature:

typescript

static credential(accessToken: string): OAuthCredential;

Parameters

Parameter	Type	Description
accessToken	string	Facebook access token.

Returns:

OAuthCredential

Example

javascript

// `event` from the Facebook auth.authResponseChange callback.
const credential = FacebookAuthProvider.credential(event.authResponse.accessToken);
const result = await signInWithCredential(credential);

FacebookAuthProvider.credentialFromError()

Used to extract the underlying OAuthCredential from a AuthError which was thrown during a sign-in, link, or reauthenticate operation.

Signature:

typescript

static credentialFromError(error: FirebaseError): OAuthCredential | null;

Parameters

Parameter	Type	Description
error	FirebaseError

Returns:

OAuthCredential | null

FacebookAuthProvider.credentialFromResult()

Used to extract the underlying OAuthCredential from a UserCredential.

Signature:

typescript

static credentialFromResult(userCredential: UserCredential): OAuthCredential | null;

Parameters

Parameter	Type	Description
userCredential	UserCredential	The user credential.

Returns:

OAuthCredential | null

Example 1

javascript

// Sign in using a redirect.
const provider = new FacebookAuthProvider();
// Start a sign in process for an unauthenticated user.
provider.addScope('user_birthday');
await signInWithRedirect(auth, provider);
// This will trigger a full page redirect away from your app

// After returning from the redirect when your app initializes you can obtain the result
const result = await getRedirectResult(auth);
if (result) {
  // This is the signed-in user
  const user = result.user;
  // This gives you a Facebook Access Token.
  const credential = FacebookAuthProvider.credentialFromResult(result);
  const token = credential.accessToken;
}

Example 2

javascript

// Sign in using a popup.
const provider = new FacebookAuthProvider();
provider.addScope('user_birthday');
const result = await signInWithPopup(auth, provider);

// The signed-in user info.
const user = result.user;
// This gives you a Facebook Access Token.
const credential = FacebookAuthProvider.credentialFromResult(result);
const token = credential.accessToken;