You're viewing the legacy docs. They are deprecated as of May 18, 2016.
These docs are for version 2.4.2 and below of the Javascript SDK. Go to our current docs, or see our Web migration guide.

Official Code Releases @firebaserelease


Mar 28, 2016 - Version 1.2.0
feature Added $firebaseRefProvider for injecting Firebase references.
feature Added $firebaseAuthService for simplified authentication.
Feb 22, 2016 - Version 1.1.4
feature Upgraded Angular dependency to support 1.5.x
Sep 29, 2015 - Version 1.1.3
feature Upgraded Firebase dependency to 2.x.x.
Jun 25, 2015 - Version 1.1.2
fixed Fixed issued with $firebaseArray.$loaded() which caused it to resolve before updates from the server were populated to the array (thanks to @jamestalmage).
May 5, 2015 - Version 1.1.1
fixed Fixed bug where $firebaseArray.$loaded() was resolved before the data was actually available.
May 4, 2015 - Version 1.1.0
feature Improved performance (and fixed some timing bugs) by replacing custom internal batching logic with Angular's $evalAsync().
feature The $$added(),$$updated(), $$moved(), and $$removed() methods on $firebaseArray can now optionally return a promise (thanks to @jamestalmage).
changed The new keyword is now optional for services which use $extend() to add functionality to $firebaseArray and $firebaseObject.
removed Removed unnecessary debug logging in $firebaseArray.$destroy().
fixed $waitForAuth() and $requireAuth() now properly detect authentication state changes.
fixed Fixed cases where $$error() was being called on null objects.
fixed Resolved inconsistent argument validation in $changeEmail() (thanks to @whitneyit).
Mar 4, 2015 - Version 1.0.0
important Read carefully! There are several breaking changes in this release.
important The API is now official! Future 1.x.x releases will remain backwards-compatible with the current API contract.
important We have a migration guide here:
feature Upgraded Firebase dependency to 2.2.x.
feature Enhanced performance of $bindTo() (thanks @jamestalmage).
feature Added support for CommonJS (thanks @bendrucker).
removed $firebase has been removed; see the migration guide for alternatives.
removed $inst() was removed; use $ref() to get to the underlying Firebase reference.
removed The previously deprecated ability to pass in credentials to the user management methods of $firebaseAuth as individual arguments has been removed in favor of a single credentials argument.
removed The previously deprecated $sendPasswordResetEmail() method has been removed; use the equivalent $resetPassword() method instead.
changed $asArray() has been replaced by calling the $firebaseArray service directly.
changed $asObject() has been replaced by calling the $firebaseObject service directly.
changed $FirebaseArray renamed to $firebaseArray.
changed $FirebaseObject renamed to $firebaseObject.
changed $extendFactory() has been renamed to $extend() and has been simplified; see the migration guide for details.
changed A warning message is now displayed when trying to sync to array-like data, since this is error-prone.
changed Upgraded Angular dependency to 1.3.x and 1.4.x (Angular 1.2.x should still work but it is no longer officially supported).
fixed $value is now removed when data changes from a primitive to an object with child keys (thanks @jamestalmage).
Jan 24, 2015 - Version 0.9.2
fixed Fixed bug which caused $FirebaseObject.$remove() to not actually remove the object from Firebase and, in some cases, caused a PERMISSION_DENIED error.
Jan 8, 2015 - Version 0.9.1
feature Added $firebaseAuth.$changeEmail() to change the email address associated with an existing account.
feature $firebaseAuth.$createUser() is now fulfilled with a user object which contains the created user's uid.
feature Added several minor performance improvements implemented by @jamestalmage.
fixed $firebaseAuth.$onAuth() now properly fires a digest loop upon changes in authentication state.
fixed Fixed an issue with $firebaseAuth.$offAuth() which prevented the callback from actually being unbound (thanks to @jamestalmage).
fixed Fixed a bug in $firebase.$remove() when deleting a Firebase query reference (thanks to @jamestalmage).
deprecated Passing in credentials to the user management methods of $firebaseAuth as individual arguments has been deprecated in favor of a single credentials argument.
deprecated Deprecated $firebaseAuth.$sendPasswordResetEmail() in favor of the functionally equivalent $firebaseAuth.$resetPassword().
Nov 18, 2014 - Version 0.9.0
important AngularFire support for Simple Login has been removed in favor of the new authentication methods introduced in Firebase 1.1.0.
feature AngularFire is now available on npm as angularfire.
feature Upgraded Firebase dependency to 2.0.x.
feature Added $waitForAuth() and $requireAuth() methods to easily retrieve and require authentication state in Angular routers.
feature Added $remove() method to $FirebaseObject to remove an entire object from Firebase.
feature Simplified the code required to extend the $FirebaseArray and $FirebaseObject factories.
feature Added automatic session persistence for all authentication methods.
feature Added a standardized authData returned for all authentication providers.
changed The $firebaseSimpleLogin service has been replaced with $firebaseAuth, which supports the new Firebase authentication methods introduced in Firebase 1.1.0.
changed $login() has been replaced with the functionally equivalent $authWith*() methods.
changed $logout() has been renamed to $unauth().
changed The API for the user management methods have changed slightly.
removed The user property has been removed from the authentication service. You can now use $getAuth() to synchronously retrieve a client's authentication state.
Aug 28, 2014 - Version 0.8.2
fixed Fixed issue with bower install angularfire caused by the 0.8.1 release.
Aug 28, 2014 - Version 0.8.1
feature Optimized our $bindTo() code base.
feature Improved saving deeply nested data structures to Firebase (resolved invalid $$hashKey errors in ng-repeat).
feature Can now use $$defaults to set local, default values on synchronized objects.
fixed Fixed bug which caused $bindTo() to not work with inputs (cursor jumped to end).
fixed Changing $priority and $value when using $bindTo() now cause the server properly update (they are now stored as _id, _value, and _priority, which trigger updates for $watch()).
fixed $ fields no longer show up when looping over $asObject().
fixed Modified $add() to accept $priority and $value meta fields.
fixed $save() method now notifies listeners registered with $watch().
Jul 30, 2014 - Version 0.8.0
important NOTE: this release introduces several breaking changes as we work towards a stable 1.0.0 release.
feature Introduced synchronized arrays ($FirebaseArray) for handling collections.
feature Added support for extending the prototype of synchronized objects and arrays (via $extendObject()).
feature Almost all methods in the library now return a promise.
feature Created complete suite of unit tests and end-to-end tests for all API methods.
feature New enhanced docs and guides on!
changed The $firebase object is now a utility for obtaining synchronized objects/arrays and for calling Firebase write operations. A lot of previous functionality on $firebase has been moved to the new $FirebaseObject.
changed Renamed $bind() to $bindTo() (which now exists on $FirebaseObject).
changed $on("loaded") has been replaced with $loaded() (which now also returns a promise).
removed $child() no longer exists. The data already exists in the parent object and creating additional synchronized children is not efficient and discouraged. Use data transformations, flatten your data, or drop down to the Firebase SDK and use its child() method.
removed $on() and $off() no longer exist. Similar functionality can be obtained with $watch() but should be discouraged for trying to manually manage server events (manipulation should be done with data transformations through $extendFactory() instead).
removed orderByPriority was removed (is no longer needed since the new $FirebaseArray creates ordered arrays).
fixed Miscellaneous bug fixes.
Mar 19, 2014 - Version 0.7.1
feature Added a MockFirebase and some rudimentary unit tests (more to come).
feature Upgraded to Firebase Simple Login version 1.3.0.
changed $transaction() now returns a promise (previously returned nothing, so this is not an API breaking change).
fixed $getIndex() now works inside of $bind().
fixed Fixed issue with the value event when using $on().
Feb 26, 2014 - Version 0.7.0
feature Added $update() and $getRef() methods.
feature $on() is now chainable.
feature Root $firebase object now includes $id and respects priority.
feature $firebaseSimpleLogin now has a $sendPasswordResetEmail() method.
feature $bind() now supports default values.
feature Updated documentation for return values of various methods.
changed $createUser() no longer accepts noLogin argument.
fixed Fixed various bugs.
Jan 15, 2014 - Version 0.6.0
feature $on() now accepts regular Firebase events as an argument. In addition to "loaded" and "change", you may also subscribe for events like "value" and "child_added". (Full list of events available here:
feature $auth() was added to objects returned by $firebase. This method is intended to be used for custom authentication. If you have custom generated tokens, pass them in to this function (it behaves identical to the Firebase.auth() method).
feature The "anonymous" authentication provider has been added to the login service.
feature $changePassword(), $createUser(), and $removeUser() were added to the the login service. These behave identical to the corresponding Simple Login methods (
feature Added $getCurrentUser() to the the login service. It returns a promise that will resolve to the user object when they log in.
changed The $firebaseAuth service was renamed to $firebaseSimpleLogin.
changed $set(), $save(), $add() and $remove() now all return promises. The promises will be resolved when the corresponding changes have been made on the server, or will be rejected with an appropriate error object.
removed The login service no longer accepts a custom authentication token.
Dec 13, 2013 - Version 0.5.0
feature Overhauled the API to make it easier to understand and use in production Angular applications.
changed The angularFire and angularFireCollection services are no longer available, and have been replaced by a single service named $firebase.
changed The angularFireAuth service is now available as $firebaseAuth.
important The API for the $firebase service is significantly different than the old angularFire or angularFireCollection APIs.
Dec 11, 2013 - Version 0.3.2
fixed Fixed various bugs.
Sep 10, 2013 - Version 0.3.1
fixed Fixed various bugs.
Aug 30, 2013 - Version 0.3.0
feature Improved underlying data merge behavior.
changed The first argument to angularFire and angularFireCollection should be a Firebase reference, not a string. If you were passing a string URL, just call new Firebase(url) and pass that as reference instead.
changed The fourth argument to angularFire is no longer required. The type of data will be automatically inferred from the local and remote data.
changed angularFire returns a promise, but you no longer have to wait for the promise to resolve to modify the local models. Local and remote data will be merged when the remote data arrives.
Jul 23, 2013 - Version 0.2.0
feature Introduced support for Bower.
feature Added the angularFireAuth service for easy user authentication.
feature Added the ability to disassociate a binding to $scope.
fixed Fixed various bugs
Apr 8, 2013 - Version 0.1.0
feature Initial version of AngularFire which provides implicit and explicit synchronization primitives to associate Angular models and persist them with Firebase.