FireAuth
Creates a new Firebase user with Email and Password Authentication.
Logs in a Firebase user with Email and Password Authentication.
Changes a Firebase user's password.
Changes a Firebase user's email.
Sends a reset password email to the user.
Deletes a Firebase user with Email and Password Authentication.
Logs in a Firebase user with Facebook Authentication. Make sure your application is configured as a Facebook App.
Logs in a Firebase user with GitHub Authentication. Make sure your application is configured as a GitHub App.
Logs in a Firebase user with Google Authentication. Make sure your application is configured as a Google App.
Logs in a Firebase user with Twitter Authentication. Make sure your application is configured as a Twitter App.
Logs out a user and removes authentication token.
Event handler checks any changes in user authentication. Can also be used as an alternative to callbacks from other login functions.
Sets the token id or name.
string tokenName - name of the token that will be stored in user's browser (This should not be kept default and should remain constant)
### new FireAuth(firebaseURL)
| Param | Type | Description |
| --- | --- | --- |
| firebaseURL | string | The URL of the Firebase reference. |
## createUserWithEmail(email, password, callback)
Creates a new Firebase user with Email and Password Authentication.
**Kind**: global function
| Param | Type | Description |
| --- | --- | --- |
| email | string | The user's email |
| password | string | The user's password |
| callback | function | Optional callback function with parameter userData. (Called upon successful account creation) |
**Example**
```js
fireAuthInstance.createUserWithEmail("john@doe.com", "correcthorsebatterystaple", function(userData){
// The user creation was successful
doStuffWith(userData);
})
```
## loginWithEmail(email, password, token, callback)
Logs in a Firebase user with Email and Password Authentication.
**Kind**: global function
| Param | Type | Description |
| --- | --- | --- |
| email | string | The user's email |
| password | string | The user's password |
| token | boolean | True to create an auth token, false to not create one. |
| callback | function | Optional callback function with parameter authData. (Called upon successful login) |
**Example**
```js
fireAuthInstance.loginWithEmail("john@doe.com", "correcthorsebatterystaple", false, function(authData){
// The authentication was successful.
doStuffWith(authData);
})
```
## changeUserPassword(email, oldPassword, newPassword, callback)
Changes a Firebase user's password.
**Kind**: global function
| Param | Type | Description |
| --- | --- | --- |
| email | string | The user's email |
| oldPassword | string | The user's original password |
| newPassword | string | The user's new password |
| callback | function | Optional callback function. (Called upon successful password change) |
**Example**
```js
fireAuthInstance.changeUserPassword("john@doe.com", "correcthorsebatterystaple", "youwillneverguessthis", function(){
// Password has been changed - handle anything else here.
})
```
## changeUserEmail(oldEmail, newEmail, password, callback)
Changes a Firebase user's email.
**Kind**: global function
| Param | Type | Description |
| --- | --- | --- |
| oldEmail | string | The user's original email |
| newEmail | string | The user's new email |
| password | string | The user's password |
| callback | function | Optional callback function. (Called upon successful email change) |
**Example**
```js
fireAuthInstance.changeUserEmail("john@doe.com", "jane@doe.com", "correcthorsebatterystaple", function(){
// Email has been changed - handle anything else here.
})
```
## resetUserPassword(email, callback)
Sends a reset password email to the user.
**Kind**: global function
| Param | Type | Description |
| --- | --- | --- |
| email | string | The user's email |
| callback | function | Optional callback function. (Called once reset email is sent) |
**Example**
```js
fireAuthInstance.resetUserPassword("john@doe.com", function(){
// Email has been sent - handle anything else here.
})
```
## deleteUserWithEmail(email, password, callback)
Deletes a Firebase user with Email and Password Authentication.
**Kind**: global function
| Param | Type | Description |
| --- | --- | --- |
| email | string | The user's email |
| password | string | The user's password |
| callback | function | Optional callback function. (Called upon successful account deletion) |
**Example**
```js
fireAuthInstance.deleteUserWithEmail("john@doe.com", "correcthorsebatterystaple", function(){
// Successfully deleted user within Firebase - Handle anything else here.
})
```
## loginWithFacebook(redirect, token, sessionTime, permissions, callback)
Logs in a Firebase user with Facebook Authentication. Make sure your application is [configured as a Facebook App](https://www.firebase.com/docs/web/guide/login/facebook.html).
**Kind**: global function
| Param | Type | Description |
| --- | --- | --- |
| redirect | boolean | Whether the webpage should redirect the current page. If false the webpage will just open a popup to Facebook. |
| token | boolean | True to create an auth token, false to not create one. |
| sessionTime | string | If not specified - or set to default - sessions are persisted for as long as you have configured in the Login & Auth tab of your App Dashboard. To limit persistence to the lifetime of the current window, set this to sessionOnly. A value of none will not persist authentication data at all and will end authentication as soon as the page is closed. |
| permissions | string | A set of permissions your application may want to access from the user's Facebook account. Certain permissions will have to be approved by the user and Facebook. Each of these permissions can be accessed through the callback. [Click here](https://developers.facebook.com/docs/facebook-login/permissions/v2.4) to view some of the permissions that can be access from Facebook. |
| callback | function | Optional callback function with parameter [authData](https://www.firebase.com/docs/web/guide/login/facebook.html#section-logging-in) that will not get called if redirect is true. (Called upon successful login) [NOTE: Alternatively, this can be done with the "authChangeListener" function] |
**Example**
```js
fireAuthInstance.loginWithFacebook(false, true, "default", "email, user_likes" , function(authData){
// The authentication was successful and opened within a popup.
doStuffWith(authData);
});
```
## loginWithGithub(redirect, token, sessionTime, permissions, callback)
Logs in a Firebase user with GitHub Authentication. Make sure your application is [configured as a GitHub App](https://www.firebase.com/docs/web/guide/login/github.html).
**Kind**: global function
| Param | Type | Description |
| --- | --- | --- |
| redirect | boolean | Whether the webpage should redirect the current page. If false the webpage will just open a popup to GitHub. |
| token | boolean | True to create an auth token, false to not create one. |
| sessionTime | string | If not specified - or set to default - sessions are persisted for as long as you have configured in the Login & Auth tab of your App Dashboard. To limit persistence to the lifetime of the current window, set this to sessionOnly. A value of none will not persist authentication data at all and will end authentication as soon as the page is closed. |
| permissions | string | A set of permissions your application may want to access from the user's Github account. Certain permissions will have to be approved by the user and Github. Each of these permissions can be accessed through the callback. [Click here](https://developer.github.com/v3/oauth/#scopes) to view some of the permissions that can be access from Github. |
| callback | function | Optional callback function with parameter [authData](https://www.firebase.com/docs/web/guide/login/github.html#section-logging-in) that will not get called if redirect is true. (Called upon successful login) [NOTE: Alternatively, this can be done with the "authChangeListener" function] |
**Example**
```js
fireAuthInstance.loginWithGithub(false, false, "default", "user, notifications, read:org" , function(authData){
// The authentication was successful and opened within a popup.
doStuffWith(authData);
});
```
## loginWithGoogle(redirect, token, sessionTime, permissions, callback)
Logs in a Firebase user with Google Authentication. Make sure your application is [configured as a Google App](https://www.firebase.com/docs/web/guide/login/google.html).
**Kind**: global function
| Param | Type | Description |
| --- | --- | --- |
| redirect | boolean | Whether the webpage should redirect the current page. If false the webpage will just open a popup to Google. |
| token | boolean | True to create an auth token, false to not create one. |
| sessionTime | string | If not specified - or set to default - sessions are persisted for as long as you have configured in the Login & Auth tab of your App Dashboard. To limit persistence to the lifetime of the current window, set this to sessionOnly. A value of none will not persist authentication data at all and will end authentication as soon as the page is closed. |
| permissions | string | A set of permissions your application may want to access from the user's Google account. Certain permissions will have to be approved by the user and Google. Each of these permissions can be accessed through the callback. [Click here](https://developers.google.com/+/web/api/rest/oauth#scopes) to view some of the permissions that can be access from Google. |
| callback | function | Optional callback function with parameter [authData](https://www.firebase.com/docs/web/guide/login/google.html#section-logging-in) that will not get called if redirect is true. (Called upon successful login) [NOTE: Alternatively, this can be done with the "authChangeListener" function] |
**Example**
```js
fireAuthInstance.loginWithGoogle(true, false "none", "profile, openid" , function(authData){
// The authentication was successful and opened within a popup.
doStuffWith(authData);
});
```
## loginWithTwitter(options, callback)
Logs in a Firebase user with Twitter Authentication. Make sure your application is [configured as a Twitter App](https://www.firebase.com/docs/web/guide/login/twitter.html).
**Kind**: global function
| Param | Type | Description |
| --- | --- | --- |
| options | object | Object with optional values. |
| options.redirect | boolean | Whether the webpage should redirect the current page. If false or not defined the webpage will just open a popup to Twitter. |
| options.token | boolean | True to create an auth token, false or undefined to not create one. |
| options.sessionTime | string | If not specified - or set to default - sessions are persisted for as long as you have configured in the Login & Auth tab of your App Dashboard. To limit persistence to the lifetime of the current window, set this to sessionOnly. A value of none will not persist authentication data at all and will end authentication as soon as the page is closed. |
| callback | function | Optional callback function with parameters [error](https://www.firebase.com/docs/web/guide/user-auth.html#section-full-error) and [authData](https://www.firebase.com/docs/web/guide/login/twitter.html#section-logging-in) that will not get called if redirect is true. (Called upon successful or unsuccessful login)[NOTE: Alternatively, this can be done with the "authChangeListener" function] |
**Example**
```js
fireAuthInstance.loginWithTwitter(false, true, "sessionOnly", function(authData){
// The authentication was successful and opened within a popup.
doStuffWith(authData);
});
```
## logout()
Logs out a user and removes authentication token.
**Kind**: global function
## authChangeListener(onLogin, onLogout)
Event handler checks any changes in user authentication. Can also be used as an alternative to callbacks from other login functions.
**Kind**: global function
| Param | Type | Description |
| --- | --- | --- |
| onLogin | function | A function with parameter authData that will get called if the user becomes authenticated or is already logged in. |
| onLogout | function | A function with parameter authData that will get called if the user becomes unauthenticated or is already logged out. |
**Example**
```js
fireAuthInstance.authChangeListener(function(authData){
//The user has logged in
doStuffWith(authData);
}, function(authData){
//The user has logged out
doStuffWith(authData);
})
```
## setTokenName(newTokenName)
Sets the token id or name.
**Kind**: global function
| Param | Type | Description |
| --- | --- | --- |
| newTokenName | string | the new name of your token. |
**Example**
```js
setTokenName("myTokenForMyFirstWebApp");
```
##### Created by Ayush Jain and Rohan Iyer
---
_Source: https://npm.io/package/fireauth · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._