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

JavaScript Changelog

JavaScript Client

Mar 28, 2016 - Version 2.4.2
fixed Fixed an issue that could case a transaction to run on stale data.
Feb 20, 2016 - Version 2.4.1
fixed Fixed an issue causing authWithOAuthRedirect to fail when used with AngularJS html5 mode.
fixed Ensure the Promise objects returned when there's no native Promise implementation still have a catch method.
changed "permission denied" warnings for reads now include the path that was denied.
changed Raised the default auth window width to 1025px for GitHub.
Jan 21, 2016 - Version 2.4.0
feature Each asynchronous API function now returns a Promise which can optionally be used instead of providing an onComplete callback.
fixed Fixed an issue that could cause occasional NS_ERROR_UNEXPECTED exceptions in Firefox.
fixed Fixed an issue where authWithOAuthRedirect() could fail in conjunction with certain frameworks that altered the value of window.location.hash.
Nov 19, 2015 - Version 2.3.2
fixed Fixed an issue that could cause a "listen() called twice for same path/queryId." internal error.
Sep 30, 2015 - Version 2.3.1
fixed Fixed a regression introduced in 2.3.0 that broke compatibility with certain legacy browsers.
Sep 24, 2015 - Version 2.3.0
feature update() now supports deep paths in addition to child keys.
feature orderByChild() now supports deep paths in addition to child keys.
fixed Fixed an issue when calling offAuth() from within an onAuth() handler.
fixed Fixed an edge case leading to cache inconsistencies (related to certain combinations of queries and deep update() calls).
fixed Fixed bug causing "INTERNAL ASSERT FAILED: listen() called twice for same path/queryId" error.
Jul 30, 2015 - Version 2.2.9
fixed Fixed regression in 2.2.8 that broke browserify / webpack usage.
Jul 29, 2015 - Version 2.2.8
fixed Fixed an edge case leading to cache inconsistencies (related to certain combinations of queries and deep update() calls).
changed Improved performance for writes (set() or update()), especially when writing locations deep under an event listener.
fixed Fixed issue preventing Firebase node module from connecting to Firebase if a document global has been defined.
Jun 9, 2015 - Version 2.2.7
fixed Fixed a regression introduced in 2.2.6 that broke some authentication methods in Internet Explorer.
fixed Fixed an issue with authentication methods sometimes not working in React Native.
fixed Fixed document.createElement error when using Firebase with React Native and Chrome debugging enabled.
changed Improved error messages for various auth methods.
changed firebase-debug.js no longer creates fb and goog globals. It is now compatible with Closure compilation.
Jun 1, 2015 - Version 2.2.6
fixed Authentication methods (authWithOAuthToken, createUser, changePassword, etc.) now work in React Native apps.
May 19, 2015 - Version 2.2.5
feature Firebase client now works in React Native apps.
changed Calling toString() on queries now just returns the URL of the reference (instead of including useless query parameters). This additionally resolves an exception with toString() on orderByKey() queries.
Apr 13, 2015 - Version 2.2.4
fixed Fixed an issue where Firebase.goOffline() wasn't persistent (the client might eventually reconnect).
fixed Fixed an issue where the onAuth event would incorrectly trigger with null while an authWithOAuthRedirect() was in progress.
changed Added Cordova usage tracking.
Mar 18, 2015 - Version 2.2.3
fixed Authentication bug that could trigger a TRANSPORT_UNAVAILABLE in PhoneGap / Cordova on Android 2.3.
Mar 4, 2015 - Version 2.2.2
feature Client is now compatible with web crawlers that are capable of executing JavaScript and doing XHR's (e.g. Google).
changed Added better client-side validation for data written to Firebase.
fixed Calls to .once() now log a warning if they rely on a missing index.
Feb 23, 2015 - Version 2.2.1
feature Added support for io.js.
fixed Fixed internal assertion that was being hit with priorities on node removal.
Feb 12, 2015 - Version 2.2.0
feature Added Query.orderByValue() for ordering by value.
changed startAt() and endAt() no longer allow null as parameter in combination with orderByKey(). Using null as parameter previously caused the client to crash at a later point.
fixed Fixed an edge case where child_added events could be delayed for local writes.
fixed Fixed a bug where an internal assertion was hit.
fixed Fixed a bug where events for server values were not raised after being acknowledged by the server.
fixed Fixed an internal error that could be thrown in the case of a revoked listener.
Jan 28, 2015 - Version 2.1.2
fixed Fixed bug impacting iFrame channel fallback for authentication via pop-up window.
Jan 12, 2015 - Version 2.1.1
changed Stack is logged for exceptions in user callbacks.
fixed Fixed two bugs that caused an internal assertion to be hit in rare cases when using update().
Jan 6, 2015 - Version 2.1.0
feature Added Node.js support for anonymous, password, and OAuth-token authentication methods.
feature Added Firebase.changeEmail() to enable updating a user's email.
fixed Improved performance for large queries with rapid updates.
fixed Fixed a bug where priorities were passed in on value events for queries.
fixed Fixed edge cases with temporarily inconsistent views.
Dec 4, 2014 - Version 2.0.6
fixed Fixed a bug that prevented event updates in some situations after coming back online.
fixed Fixed a bug that prevented event updates in rare occasions where clients would overwrite data with near identical copies.
Nov 26, 2014 - Version 2.0.5
changed Exposed created user ID via second argument in callback to createUser().
Nov 18, 2014 - Version 2.0.4
feature Added exists() method to DataSnapshot.
fixed Fixed bug causing completion callbacks to be invoked with extra string argument.
fixed Fixed bug impacting auth session persistence in IE9 and below.
fixed Fixed an issue that could lead to broken queries in IE9 and below.
Nov 12, 2014 - Version 2.0.3
fixed Fixed bug with incomplete data that could occur with onDisconnect().
fixed Fixed a potential crash when calling Firebase.goOnline().
Nov 6, 2014 - Version 2.0.2
fixed Fixed undefined function error on internal node comparisons in older browser environments.
fixed Fixed issue where the transaction update function was called with null instead of cached data from a query (fixes firebase-worker-queue example).
fixed Fixed a couple issues where events could be raised with incorrect data in certain situations.
Nov 4, 2014 - Version 2.0.1
fixed Fixed deprecation warning for .name.
Nov 4, 2014 - Version 2.0.0
feature Added Query.orderByChild() for ordering by arbitrary child attributes.
feature Added Query.orderByKey() and Query.orderByPriority() to explicitly set sort order.
feature Added Query.equalTo() for exact-match filtering using arbitrary child attributes.
feature Added Query.limitToFirst() and Query.limitToLast() to explicitly set limit direction.
feature Improved performance of existing query functionality.
changed Changes in priority now raise a child_changed event in addition to a child_moved event.
deprecated Deprecated in favor of Firebase.key().
deprecated Deprecated in favor of DataSnapshot.key().
deprecated Deprecated Query.limit() in favor of Query.limitToFirst() or Query.limitToLast().
removed Removed the previously-deprecated Firebase.setOnDisconnect() and Firebase.removeOnDisconnect() methods.
fixed Firebase.ServerValue.TIMESTAMP now works properly in transactions.
fixed Transaction callbacks now always return the snapshot from the specific transaction.
fixed Fixed transactions bug when running on cached data.
fixed Fixed some cases where child_added events were raised with only partially-complete data.
Oct 27, 2014 - Version 1.1.3
fixed Fixed customized session persistence for anonymous authentication.
fixed Render error template in auth popup for common configuration errors.
Oct 13, 2014 - Version 1.1.2
fixed Fixed maximum concurrent websocket error in Internet Explorer 10.
Oct 9, 2014 - Version 1.1.1
fixed Improved authentication transport detected in iOS webviews.
fixed Fixed broken redirect-based OAuth flows on the Web + PhoneGap / Cordova.
Oct 3, 2014 - Version 1.1.0
changed Firebase delegated authentication (previously Firebase Simple Login) is now integrated into the core Firebase library.
feature Added automatic session persistence for all authentication methods.
feature Added a synchronous accessor for authentication state: ref.getAuth().
feature Added a standardized authData returned for all authentication providers.
deprecated Deprecated auth(). Use authWithCustomToken() instead.
Sep 23, 2014 - Version 1.0.24
fixed Fixed minor bug.
Sep 23, 2014 - Version 1.0.23
fixed Fixed transaction bug.
Sep 19, 2014 - Version 1.0.22
fixed Fixed validation issue which previously allowed setPriority() and setWithPriority() to be called with non-finite numbers.
Aug 22, 2014 - Version 1.0.21
fixed Fixed issue with transaction hash mismatches on latest Chrome / V8.
Aug 21, 2014 - Version 1.0.20
feature Added Browserify support.
Aug 8, 2014 - Version 1.0.19
fixed Fixed potential Node.js hang due to calling setTimeout() with fractional timeout.
changed Avoid treating data as array when some keys have leading zeros.
Jul 25, 2014 - Version 1.0.18
changed Improved validation and error messages.
deprecated Deprecated passing an array to update().
Feb 28, 2014 - Version 1.0.8
deprecated Client releases are no longer applied to It will remain frozen at v1.0.6. Switch to versioned URLs.
Dec 4, 2013 - Version 1.0.0
feature Production ready JS clients cut from stable /v0/firebase.js; initial switch over to proper semver layout.

Simple Login Client

Oct, 2014
deprecated Simple Login has been deprecated. Please switch to the authentication features that have been integrated into the main Firebase client library.
Sep 18, 2014 - Version 1.6.4
fixed Improved error handling for XHR requests, including in the case of a lost network connection (thanks to @theSmaw for the contribution).
fixed Fixed race condition which caused error message popups to close immediately.
Aug 15, 2014 - Version 1.6.3
fixed Fixed issue where we accidentally formatted error messages twice resulting in wrong error messages.
fixed Fixed bug where we assumed a script tag existed for the JSONP transport.
changed The callback argument for createUser(), changePassword(), sendPasswordResetEmail(), and removeUser() is now optional.
removed Removed displayName from the anonymous authentication user payload.
Jul 19, 2014 - Version 1.6.2
fixed Fixed bug in PhoneGap,, and Windows Metro transports which caused response payloads with an ampersand in them to be improperly handled, resulting in an "UNKNOWN ERROR".
Jun 21, 2014 - Version 1.6.1
feature Added (internal) option to keep pop-up window alive after communicating reply to opener.
fixed Fixed issue where we accidentally formatted error messages twice resulting in wrong error messages.
Jun 13, 2014 - Version 1.6.0
important NOTE: This update modifies the Firebase Simple Login persistence, so updating to this version will have the effect of blowing away your users' existing, persisted sessions.
feature Removed dependency on cookies / SJCL to better support the PhoneGap / Cordova environments.
fixed Increased the PhoneGap / Cordova InAppBrowser timeout from 40 to 120 seconds (thanks @VishalRJoshi).
Jun 3, 2014 - Version 1.5.0
removed Officially removed Persona as an authentication provider.
Apr 30, 2014 - Version 1.4.1
deprecated Added Persona provider deprecation warning (will be removed on June 2, 2014).
Apr 18, 2014 - Version 1.4.0
feature Exposed FirebaseSimpleLogin.VERSION attribute in the client for programmatic detection.
feature Returned Promises/A+ standards-compliant promises (using RSVP) from all asynchronous login / user management methods.
fixed Fixed issue with cross-domain XHR in IE9.
Mar 31, 2014 - Version 1.3.2
fixed Fixed issue with session persistence - GitHub issue #22 (
Mar 30, 2014 - Version 1.3.1
feature Added support for isTemporaryPassword flag when logging in using the email / password provider - GitHub issue #17 (
feature Reduced file size by using a custom XHR integration (GitHub issue #13 (
Mar 1, 2014 - Version 1.3.0
feature Added support for Google / Google+ authentication - GitHub issue #1 (
feature Enabled automatic redirect-based OAuth for iOS standalone apps, Chrome on iOS, and the Twitter / Facebook iOS preview panes - GitHub issue #7 (
feature Enabled optional redirect-based OAuth via the preferRedirect: true flag for all OAuth-based .login(...) methods - GitHub issue #10 (
feature Added support for extra options for Mozilla Persona login - GitHub issue #8 (
Feb 6, 2014 - Version 1.2.5
fixed Fixed bug impacting persisting sessions across page refreshes.
Feb 6, 2014 - Version 1.2.4
feature Added support for Windows Metro applications via WebAuthenticationBroker.
Jan 28, 2014 - Version 1.2.3
fixed Fixed intermittent eventing issues with multiple clients on a single page.
Jan 25, 2014 - Version 1.2.2
fixed Fixed GitHub issue #5 - sessionLengthDays not used when setting the session in attemptAuth() (
Jan 20, 2014 - Version 1.2.1
fixed Fixed GitHub issue #4 - Persona not working (
Jan 16, 2014 - Version 1.2.0
feature Added support for password resets.