@firebase/auth

What is @firebase/auth?

The @firebase/auth package is part of the Firebase JavaScript SDK, providing robust authentication functionality for web and mobile applications. It supports various authentication methods, including email and password, third-party providers like Google and Facebook, and more. This package helps in managing user authentication states, securing user data, and integrating with other Firebase services.

What are @firebase/auth's main functionalities?

Email and Password Authentication

Allows users to sign up using their email and password. It also handles user sign-in and management of user sessions.

firebase.auth().createUserWithEmailAndPassword(email, password).then((userCredential) => { var user = userCredential.user; }).catch((error) => { var errorCode = error.code; var errorMessage = error.message; });

Social Auth Providers

Supports authentication with different social media providers such as Google, Facebook, Twitter, etc. This example uses Google for authentication.

var provider = new firebase.auth.GoogleAuthProvider(); firebase.auth().signInWithPopup(provider).then((result) => { var token = result.credential.accessToken; var user = result.user; }).catch((error) => { var errorCode = error.code; var errorMessage = error.message; });

Phone Number Authentication

Enables sign-in using a phone number with SMS verification. This method sends an SMS to the user's phone number with a verification code.

firebase.auth().signInWithPhoneNumber(phoneNumber, appVerifier).then((confirmationResult) => { var verificationCode = window.prompt('Please enter the verification code that was sent to your mobile device.'); return confirmationResult.confirm(verificationCode); }).catch((error) => { var errorCode = error.code; var errorMessage = error.message; });

Other packages similar to @firebase/auth

passport

Passport is an authentication middleware for Node.js. Unlike @firebase/auth which is tightly integrated with Firebase services, Passport works with any type of application and supports extensive authentication mechanisms through strategies.

auth0

Auth0 is a flexible, drop-in solution to add authentication and authorization services to your applications. It provides a broader set of features compared to @firebase/auth, including advanced user management, multi-factor authentication, and extensive integration options.

README

@firebase/auth

This is the Firebase Authentication component of the Firebase JS SDK.

This package is not intended for direct usage, and should only be used via the officially supported firebase package.

Testing

The modular Auth SDK has both unit tests and integration tests, along with a host of npm scripts to run these tests. The most important commands are:

Command	Description
yarn test	This will run lint, unit tests, and integration tests against the live environment
yarn test:<platform>	Runs all browser tests, unit and integration
yarn test:<platform>:unit	Runs only <platform> unit tests
yarn test:<platform>:unit:debug	Runs <platform> unit tests, auto-watching for file system changes
yarn test:<platform>:integration	Runs only integration tests against the live environment
yarn test:<platform>:integration:local	Runs all headless <platform> integration tests against the emulator (more below)

Where <platform> is "browser" or "node". There are also cordova tests, but they are not broken into such granular details. Check out package.json for more.

Integration testing with the emulator

To test against the emulator, set up the Auth emulator (instructions). The easiest way to run these tests is to use the firebase emulators:exec command (documentation). You can also manually start the emulator separately, and then point the tests to it by setting the GCLOUD_PROJECT and FIREBASE_AUTH_EMULATOR_HOST environmental variables. In addition to the commands listed above, the below commands also run various tests:

• yarn test:integration:local — Executes Node and browser emulator integration tests, as well as the Selenium WebDriver tests

• yarn test:webdriver — Executes only the Selenium WebDriver integration tests

For example, to run all integration and WebDriver tests against the emulator, you would simply execute the following command:

firebase emulators:exec --project foo-bar --only auth "yarn test:integration:local"

Selenium Webdriver tests

These tests assume that you have both Firefox and Chrome installed on your computer and in your $PATH. The tests will error out if this is not the case. The WebDriver tests talk to the emulator, but unlike the headless integration tests, these run in a browser robot environment; the assertions themselves run in Node. When you run these tests a small Express server will be started to serve the static files the browser robot uses.