Firebase JavaScript SDK Release Notes

To review release notes for the Firebase console and for other Firebase platforms and related SDKs, refer to the Firebase Release Notes.

Version 12.2.1 - August 28, 2025

AI Logic

  • Fixed an issue that caused TypeScript compilation errors.

Version 12.2.0 - August 28, 2025

AI Logic

  • Add support for the Gemini Live API.

  • Add thoughtSummary() convenience method to EnhancedGenerateContentResponse.

  • Add support for limited-use tokens with Firebase App Check. These limited-use tokens are required for an upcoming optional feature called replay protection. We recommend enabling the usage of limited-use tokens now so that when replay protection becomes available, you can enable it sooner because more of your users will be on versions of your app that send limited-use tokens.

  • Fixed an issue where AIError messages were too long after including an entire response body.

  • Added 'includeSafetyAttributes' field to Predict request payloads.

  • Excluded ChromeAdapterImpl code from Node entry point.

Cloud Firestore

  • Fixed a bug where a rejected promise with an empty message in a transaction would cause a timeout. See GitHub Issue #9147.

Cloud Functions for Firebase Client SDK

  • Fixed an issue which caused a CORS error in Firebase Studio when connected to emulators.

Version 12.1.0 - August 7, 2025

AI Logic

  • Added hybrid inference options to AI Logic. This provides options to perform inference tasks using the Prompt API in browsers that have the Prompt API enabled.

Performance Monitoring

  • Fixed errors thrown when capturing long target element names for out-of-the-box metrics. See GitHub Issue #9136.

Version 12.0.0 - July 17, 2025

  • Updated Node.js "engines" version to require a minimum of Node 20.

  • Updated the SDK to use ES2020. Developers whose apps are not using ES2020 or higher may need to update their tooling or configuration.

  • Removed the firebase/vertexai import alias. All the functionality is still available under the new name: firebase/ai, although some methods may be renamed (see AI Logic notes below).

AI Logic

  • Removed methods and symbols with the VertexAI name in them such as getVertexAI or VertexAIError. These were deprecated in 11.8.0 and were just wrappers on the newly introduced methods with the AI name, such as getAI or AIError.

  • Added support for Grounding with Google Search.

  • Added support for the Thinking Budget feature.

  • Added support for anyOf schemas.

  • Converted each enum export to a combination of a const map and a string literal type. This makes the constants available to non-TypeScript users and allows tree-shaking of unused variables.

  • Removed GroundingAttribution, which had previously been deprecated.

  • Fixed typings for functionDeclaration.parameters to prevent the use of optionalProperties when using an object literal.

Cloud Firestore

  • Reverted a fix for an issue where Cloud Firestore would send undefined for a document snapshot if the "clear site data" button was pressed in the web browser. This fix was introduced in v11.6.1 but inadvertently caused IndexedDB issues for some customers. See GitHub Issue #9165.

  • Further improved performance of UTF-8 string ordering logic, which had degraded in v11.3.0, was reverted in v11.3.1, and was reintroduced with some improvements in v11.5.0.

  • Fixed a regression where the SDK did not re-connect to IndexedDb after a disconnect.

Version 11.10.0 - June 26, 2025

  • Added React Native entry point.

AI Logic

  • Added deprecation label to totalBillableCharacters. totalTokens should be used instead.

Cloud Firestore

  • Added support for Firestore result types to be serialized with toJSON and then deserialized with fromJSON methods on the objects.
  • Added support to resume onSnapshot listeners in the CSR phase based on serialized DataSnapshots and QuerySnapshots built in the SSR phase.
  • Internal listener registration change for IndexedDB versionchange events.

Cloud Storage

  • Fixed CORS error that occurred in Firebase Studio.

Version 11.9.1 - June 10, 2025

Authentication

  • Fixed a Firebase Studio issue where Firebase Auth cookie refresh attempts issued in Firebase Studio resulted in CORS errors.

Cloud Storage

  • Fixed a Firebase Studio issue that didn't properly populate cookies for Storage users.

Version 11.9.0 - June 5, 2025

AI Logic

  • Added title, maximum, minimum, maxItems, minItems, and propertyOrdering to Schema.
  • Added HarmBlockThreshold.OFF support.

Cloud Firestore

  • Clean up leaked WebChannel instances when the Firestore instance is terminated.

Version 11.8.0 - May 20, 2025

  • The FirebaseApp setting automaticDataCollectionEnabled now defaults to true. This setting was previously only used by App Check and won't change the default behavior in App Check.

Cloud Firestore

  • Fixed a cache issue in Safari/WebKit that occurs when client-side indexing is used.

AI Logic

  • Initial release of the Firebase AI Logic SDK (@firebase/ai). This SDK replaces the previous Vertex AI in Firebase SDK (@firebase/vertexai) to accommodate the evolving set of supported features and services. The new Firebase AI Logic SDK provides preview support for the Gemini Developer API, including its free tier offering. Using the Firebase AI Logic SDK with the Vertex AI Gemini API is still generally available (GA).

    To start using the new SDK, use the getAI() instance getter imported from ’firebase/ai’. See details in the migration guide.

  • Added support for Gemini multimodal output.

  • Fixed an issue where GenerationConfig was not inherited from ChatSession.

Version 11.7.1 - May 7, 2025

  • Rolled back the change in 11.7.0 that set the value of automaticDataCollectionEnabled to true. Due to a backend setting not being ready yet, this will cause errors in Vertex AI in Firebase requests. This change will be restored when the backend is ready.

Version 11.7.0 - May 7, 2025

  • The FirebaseApp setting automaticDataCollectionEnabled now defaults to true. This setting was previously only used by App Check and won't change the default behavior in App Check.

Version 11.6.1 - April 24, 2025

Authentication

  • Fixed an issue where ActionCodeURL was not populating languageCode from the URL. Fixes GitHub Issue #8912.

Data Connect

  • Resolved a 'cannot extend private constructor' build error that occurred when using the DataConnectError and DataConnectOperationError types. See GitHub PR #8898.

Cloud Firestore

  • Fixed the null value handling in != and not-in filters. See GitHub PR #8915.
  • Fixed 'window is not defined' error when calling clearIndexedDbPersistence from a service worker. Fixes GitHub Issue #6465.
  • Fixed an issue where Firestore would produce undefined for document snapshot data if using IndexedDB persistence and "clear site data" (or equivalent) was selected in the web browser. Fixes GitHub Issue #8953.
  • Added unique IDs and state information into fatal error messages instead of the generic "unexpected state" message.

Version 11.6.0 - March 31, 2025

Authentication

  • Added Persistence.COOKIE, a new persistence method backed by cookies. The browserCookiePersistence implementation is designed to be used in conjunction with middleware that ensures both your front and backend authentication state remain synchronized.

Data Connect

  • Exposed partial errors to the user.

Vertex AI in Firebase

  • The SDK now throws an error when initializing models if appId is not defined in the given Vertex AI in Firebase instance.

  • Labeled GroundingAttribution as deprecated.

Version 11.5.0 - March 20, 2025

App Check

  • The getToken() method now throws internalError strings that were previously internally suppressed. Fixes GitHub issue #8822.

Cloud Firestore

Data Connect

  • Updated requests to point to the v1 backend endpoints instead of v1beta.

Performance Monitoring

Realtime Database

  • Added non-null parent properties to ThenableReference.

Vertex AI in Firebase

  • Added missing BlockReason and FinishReason enum values.

  • systemInstruction, tools, and generationConfig have been added to CountTokensRequest.

Version 11.4.0 - February 27, 2025

  • Added support for the FIREBASE_WEBAPP_CONFIG environment variable at install time. This feature supports auto-initialization for SSR apps using Firebase App Hosting.

Authentication

  • Invoking connectAuthEmulator multiple times with the same parameters will no longer cause an error. Fixes GitHub issue #6824.

App Check

  • Fixed a bug that caused an error to be thrown when the debug exchange request failed.

Realtime Database

  • Invoking connectDatabaseEmulator multiple times with the same parameters will no longer cause an error. Fixes GitHub issue #6824.

Vertex AI in Firebase

  • Public Preview: Added support for generating images using the Imagen 3 models.

  • Added support for modality-based token count.

  • The SDK now filters out empty text parts from streaming responses. Fixes GitHub issue #8714.

  • Created a separate entry point bundle for Node.js. This bundle can be automatically detected by any developer tooling configured to prefer Node.js fields in package.json, such as main or exports.node.

Remote Config

  • Added support for initial state hydration from SSR contexts.

Version 11.3.1 - February 11, 2025

Cloud Firestore

  • Reverted a change to use UTF-8 encoding in string comparisons because it caused a performance issue. Fixes GitHub issue #8778.

Version 11.3.0 - February 6, 2025

  • Added an appCheckToken parameter to FirebaseServerAppSettings. FirebaseServerApp will use the token when making service requests, unblocking the use of App Check enforced products in SSR environments.

Authentication

  • Added ActionCodeSettings.linkDomain to customize the Firebase Hosting link domain that is used in mobile out-of-band email action flows. Also, deprecated ActionCodeSettings.dynamicLinkDomain.

Performance Monitoring

  • Collect web vital metrics (INP,CLS,LCP) as part of page load event.

Realtime Database

  • Fixed a potential negative offset when calculating last reconnect times. This could cause lengthy reconnect delays in some scenarios. Fixes GitHub Issue #8718.

Cloud Firestore

  • Fixed an issue where the SDK's string sorting differed from the server's (UTF-8 byte order) for document fields and map/document keys, resolving a mismatch caused by special characters.

Version 11.2.0 - January 16, 2025

Data Connect

  • Usage of PromiseLike has been replaced with Promise.

Remote Config

  • Added support for custom signal targeting. Use the setCustomSignals API and to set custom signals that can be targeted using the new custom signal condition type in the Remote Config console.

Version 11.1.0 - December 12, 2024

Cloud Functions for Firebase Client SDK

  • Added .stream() API for callable functions to consume stream responses.

Data Connect

  • Fixed issue where multiple calls to connectDataConnectEmulator caused an exception.

Cloud Messaging

  • Fixed an issue where PushManager.subscribe() is called too soon after registering the default service worker. Fixes GitHub Issue #7784.

Vertex AI in Firebase

  • Clear fetch timeout after request completion. Fixes an issue that caused Node.js scripts to hang on exit due to a pending timeout.

Version 11.0.2 - November 14, 2024

  • Upgraded to TypeScript 5.5.4.

Cloud Firestore

  • Prevent a possible condition of slow snapshots, caused by a rapid series of document update(s) followed by a delete. Fixes GitHub Issue #8474.

Vertex AI in Firebase

  • Update to new base URL in documentation.
  • Remove indentation in API Not Enabled error.
  • Send App Check dummy token in header if there is an App Check getToken error.

Version 11.0.1 - October 22, 2024

Realtime Database

  • Bumped @firebase/database-compat by a major version to ensure downstream libraries like firebase-admin don't automatically pick up the Node.js engines update in package.json.

Version 11.0.0 - October 21, 2024

  • Vertex AI in Firebase is now Generally Available (GA) and can be used in production apps.

    Use the Vertex AI in Firebase SDK to call the Vertex AI Gemini API directly from your app. This client SDK is built specifically for use with Web apps, offering security options against unauthorized clients as well as integrations with other Firebase services.

  • The SDK no longer supports versions of Node.js below version 18. engines fields in all package.json files have been updated to reflect this.

  • Removed ES5 bundles. The minimum required ES version is now ES2017.

  • Removed usage of undici and node-fetch dependencies in our Node.js bundles, replacing them with the native Node.js fetch implementation.

Authentication

  • Added ReCAPTCHA Enterprise support for app verification during phone authentication.

Cloud Functions for Firebase Client SDK

  • The FunctionsError class is now publicly exported.

Cloud Firestore

  • Memory LRU GC is now enabled by default.

Version 10.14.1 - October 10, 2024

Cloud Messaging

  • Fixed a logging issue where Web Push data was missing in BigQuery logs.

Version 10.14.0 - September 30, 2024

Data Connect

  • Added the Data Connect package to the SDK.

  • Added App Check support.

Cloud Firestore

  • Re-enabled useFetchStreams with the latest WebChannel implementation. This reduces the memory usage of WebChannel.

  • Refactored Cloud Firestore client instantiation. This prepares for future releases that require the client to restart.

Version 10.13.2 - September 18, 2024

Authentication

  • Suppress the use of the parameter referrerPolicy within fetch requests originating from Cloudflare Workers. Cloudflare Worker environments do not support this parameter and all Auth operations would silently fail. Fixes GitHub Issue #8355.

Cloud Firestore

  • Fix an issue with metadata fromCache defaulting to true when listening to cache in multiple browser tabs. See GitHub PR #8343.

Version 10.13.1 - August 29, 2024

Cloud Functions for Firebase Client SDK

Version 10.13 - August 15, 2024

Cloud Firestore

  • Add support for reading and writing Firestore vectors. See GitHub PR #8215.

Authentication

  • Remove localStorage synchronization on storage events in Safari iframes. See GitHub PR #8408.

Cloud Storage

Version 10.12.5 - August 1, 2024

  • Reverted the change that added the safevalues library, as it is not compatible with ES5 bundles. We will return to using safevalues when we migrate all our builds away from ES5.

  • Properly handle the case in app-compat checks where window exists but self does not. (This occurs in Ionic Stencil's Jest preset, for example.)

  • Fixed typos in documentation and some internal variables and parameters.

Version 10.12.4 - July 18, 2024

  • The SDK now uses the safevalues library to sanitize HTML vulnerable to XSS.

Version 10.12.3 - July 3, 2024

  • Updated browser environment detection logic in firebase/util to allow for the experimental use of FirebaseServerApp instances in edge runtimes. See GitHub Issue #8299.
  • Guard the use of FinalizationRegistry in FirebaseServerApp initialization based on the availability of FinalizationRegistry in the JavaScript runtime. See GitHub Issue #8299.
  • The FirebaseServerAppSettings.name field inherited from FirebaseAppSettings is now omitted instead of overloading the value as undefined. This fixes a TypeScript compilation error. For more information, see GitHub Issue #8336.

Cloud Firestore

  • Fixed a metadata sync issue with multi-tab persistence and snapshot listeners. See GitHub Issue #8314.
  • Fixed a typo in the package.json of webchannel-wrapper that caused bloom-blob to be missing the esm5 specifier. See GitHub Issue #8319.

Firebase AI Logic

Version 10.12.2 - May 27, 2024

Authentication

  • Changed types paths to point to rolled-up public d.ts files. This fixes TypeScript compilation errors in the web extension and cordova bundles. See GitHub Issue #8222.

Firebase AI Logic

  • Changed types paths to point to point to rolled-up public d.ts files. This fixes some TypeScript compiler errors. See GitHub PR #8256

Version 10.12.1 - May 20, 2024

Analytics

  • Fixed a bug where setConsent was incorrectly passing consent parameters to gtag(). See GitHub Issue #8210.

Cloud Firestore

  • Fixed a multi-tab persistence issue that caused empty snapshots.

Version 10.12.0 - May 13, 2024

Firebase AI Logic

  • Initial release of the Vertex AI for Firebase SDK (public preview). Learn how to get started with the SDK in your app.

Cloud Firestore

  • Updated @firebase/webchannel-wrapper to consume Closure dependencies from the closure-net GitHub repo.

  • Fixed multi-byte character decoding bug by updating webchannel-wrapper dependency.

Version 10.11.1 - April 25, 2024

Authentication

  • The SDK now emits a module package file with esm2017 browser extension builds. See GitHub Issue #8115.
  • Update jszip transient dependency from 3.7.1 to 3.10.1.

Cloud Firestore

  • Prevent spurious "Backend didn't respond within 10 seconds" errors when network is in fact responding, but slowly. See GitHub PR #8145.
  • Update protobufjs transitive dependency from 6.11.3 to 7.2.6.
  • Return to using xmlhttprequest for bidi-streams, as fetch streams seem to be having connection issues.
  • Reduce code bundle size by 6.5 kB in applications that only use memory persistence (the default persistence mode). This bundle size regression was accidentally introduced in version 10.7.2.

Version 10.11.0 - April 11, 2024

  • FirebaseServerApp is no longer JSON serializable.
  • Upgraded undici version to 5.28.4 due to the low severity security issue CVE-2024-30260.
  • Updated dependencies in Auth, Firestore, Storage and App. See GitHub PR #8098.

Cloud Firestore

  • Fixed an issue where client side indexing on timestamp fields leads to incorrect query results. See GitHub issue #8031.

Cloud Messaging

  • Revised token update logic to prevent unnecessary token deletions during transient network issues. See GitHub PR #8141.

Version 10.10.0 - March 28, 2024

  • Added the new FirebaseServerApp interface to bridge state data between client and server runtime environments. This interface extends FirebaseApp.

Authentication

  • Updated transitive dependencies based on generated dependabot security reports. See GitHub PR #8088.
  • Additional protection against misuse of the authTokenSyncURL experiment. See GitHub PR #8076.

Version 10.9.0 - March 14, 2024

Authentication

  • Fixed a potential XSS vulnerability through FIREBASE_DEFAULTS settings. See PR #8056 for more information.

Cloud Firestore

  • Added the ListenSource enum to SnapshotListenOptions to provide an option to retrieve data from local cache only.

Version 10.8.1 - February 28, 2024

  • Upgrade undici version to 5.28.3 due to the low severity security issue CVE-2024-24758.

Version 10.8.0 - February 1, 2024

  • Fixed to catch transaction.done errors in readHeartbeatsFromIndexedDB and log them as a warning, because platform logging errors should never block user app functionality.

Authentication

  • Added a firebase/auth/web-extension entry point for web extension developers. This entry point does not include any code that loads remote scripts, which are disallowed under Manifest V3. In extensions, this entry point should replace firebase/auth completely, and developers should not try to use both in the same app. See GitHub issue #7617.

Analytics

  • Added two new consent options to the ConsentSettings interface: ad_personalization and ad_user_data.

Realtime Database

  • Fixed issue where queryConstraint.type was undefined.

Cloud Firestore

Version 10.7.2 - January 18, 2024

  • Catch and warn IndexedDB createObjectStore errors in Safari-based browsers. See GitHub issue #7829.

Cloud Firestore

  • Update the isEqual function for arrayUnion, arrayRemove and increment. See GitHub issue #7706.
  • Fixed leak of grpc-js resources on terminate. See GitHub issue #7747.
  • Adjusted the automatic index creation parameters to use more optimal values for the platform/browser detected at runtime.
  • Support special characters in query paths sent to getCountFromServer(...), getCount(...) (lite API), and getDocs(...) (lite API).

Version 10.7.1 - December 5, 2023

App Check

  • Prevent App Check from logging "uncaught" cancelled promises. The cancelled promises are part of App Check's expected behavior, and their cancellation wasn't intended to produce errors or warnings. See GitHub issue #7805.

Authentication

  • Added protections when enumerating an empty list in Auth's reading of IndexedDB results, as this causes errors in some macOS and iOS browser runtimes. See GitHub issue #7825.

Version 10.7.0 - November 27, 2023

  • Replaced node-fetch dependency with the latest version of undici in Node.js SDK builds for Auth, Firestore, Cloud Functions, and Storage. See GitHub issue #7280.
  • Introduced more safeguards to ensure that heartbeat objects queried from IndexedDB include a heartbeats field.

Authentication

  • Exposed INVALID_LOGIN_CREDENTIALS as auth/invalid-credential error and updated docs for various Auth SDK methods.

Cloud Firestore

  • Introduced fixes for high memory usage of Firestore in browsers. See GitHub issue #6118.

Version 10.6.0 - November 9, 2023

  • Provide a more robust check to cover more cases of empty heartbeat data.

Authentication

  • Add Sign in with Apple token revocation support.

Cloud Firestore

Version 10.5.2 - October 26, 2023

Authentication

  • Added the TotpMultiFactorGenerator and TotpSecret exports that were missing from the React Native entry point.

Cloud Firestore

  • Rolled back the use of useFetchStreams, which had led to hanging queries. This bug was introduced in 10.4.0.

Version 10.5.1 - October 26, 2023

Authentication

Cloud Firestore

  • Clarified API documentation around getFirestore() and initializeFirestore() functions.

Version 10.5.0 - October 12, 2023

Cloud Firestore

  • Added support for sum and average aggregations.

  • Added a default template type parameter to withConverter() methods to allow backward compatibility with version 9 of the SDK.

Version 10.4.0 - September 14, 2023

Cloud Firestore

  • Added enablePersistentCacheIndexAutoCreation() function to enable automatic creation of local cache query indexes, which can improve performance of local query execution.

  • Fixed an issue where Cloud Firestore was incorrectly using XHR instead of fetch for streaming response.

  • Updated dependency grpc-js from version ~1.8.17 to ~1.9.0.

Version 10.3.1 - August 31, 2023

Cloud Firestore

  • An internal refactor related to client-side index creation.

Version 10.3.0 - August 22, 2023

Authentication

  • Fixed a regression in version 10.0.0 caused by adding a hard dependency on @react-native-async-storage/async-storage as a convenience for React Native developers. This caused unnecessary warnings during npm or Yarn install for non-React Native users, and in some cases, React version conflicts.

    10.3.0 will break React Native users who have converted to using getAuth() to initialize Authentication. React Native users who want persistent auth state must now explicitly import @react-native-async-storage/async-storage and provide it to initializeAuth() as an option like so:

    import { initializeAuth, getReactNativePersistence } from 'firebase/auth';
import ReactNativeAsyncStorage from '@react-native-async-storage/async-storage';
const auth = initializeAuth(app, {
  persistence: getReactNativePersistence(ReactNativeAsyncStorage)
});
// getAuth() can be used any time after initialization

    See Github issue #7522.

Cloud Firestore

Version 10.2.0 - August 17, 2023

Authentication

  • Added a validatePassword method for validating passwords against the password policy configured for the project or a tenant. This method returns a status object that can be used to display the requirements of the password policy and whether each one was met.

  • Fixed a bug in the onAuthStateChanged canceller. See Github issue #7383.

  • The SDK now raises an error if initializeRecaptchaConfig is called in a Node.js environment.

Cloud Firestore

  • Updated @grpc/proto-loader from v0.6.13 to v0.7.8. This addresses a vulnerability in an older version of the transitive dependency protobufjs.

Version 10.1.0 - July 20, 2023

Authentication

  • Implemented authStateReady(), which returns a promise that resolves immediately when the initial auth state is settled and currentUser is available. When the promise is resolved, currentUser might be a valid user or null if there is no user signed in currently.

  • Unpinned the version of the dependency @react-native-async-storage/async-storage so that React Native users have more control over which version of it they use. See Github issue #7448.

Cloud Firestore

  • Updated the grpc dependency to the latest version. See Github PR #7452.

  • Fixed issue where count and firestore-lite API queries did not work with named databases. See Github PR #7440.

Version 10.0.0 - July 6, 2023

The Firebase JavaScript SDK v10.0.0 has a number of breaking changes related to the React Native bundle for Authentication, as well as typings changes across several products.

Authentication

  • Removed explicit firebase/auth/react-native entry point. The React Native bundle should be automatically picked up by React Native build tools which recognize the react-native fields in package.json (at the top level and in exports). See Github PR #7138.

  • Changed getAuth() in the React Native bundle to default to importing AsyncStorage from @react-native-async-storage/async-storage instead of from the react-native core package (which has recently removed it). See Github PR #7128.

  • Changed the type of ParsedToken values from any to unknown.

  • Reordered RecaptchaVerifier parameters so auth is the first parameter.

Realtime Database

  • Updated type of action parameter for DataSnapshot#forEach.

Cloud Firestore

  • Fixed updateDoc() typing issue by adding a second type parameter to FirestoreDataConverter. See Github PR #7310.

  • Changed UpdateData to expand support for types with index signatures. See Github PR #7318.

  • Fixed an issue where localCache was not copied as part of Settings.

  • Fixed some incorrectly generated source maps for the following bundles: index.esm2017.js, index.cjs.js, index.node.mjs, and index.browser.esm2017.js (lite SDK only).

Version 9.23.0 - June 21, 2023

Cloud Firestore

Version 9.22.2 - June 8, 2023

  • Fixed the types path for compat/app to deliver the proper typings to the compat packages. See Github issue #7279.

Cloud Firestore

  • Fix potentially false warning message when configuring host in both settings() and connectFirestoreEmulator(). See Github issue #7331.

Version 9.22.1 - May 25, 2023

App Check

  • Added support for App Check replay protection in callable functions. See Github PR #7296.

Cloud Firestore

  • Updated dependencies to enable setting experimentalLongPollingOptions.timeoutSeconds. See