Supported environments for the Firebase JavaScript SDK

Supported environments

The Firebase JavaScript SDK is officially supported in the following environments.

Important: You still need to include polyfills for environments that don't support the features required by Firebase.

	Authentication	Realtime Database	Cloud Messaging	Cloud Storage	Cloud Firestore	Performance Monitoring	Cloud Functions
IE11					(except persistence)
Edge			(Edge 17+)		(except persistence)
Firefox
Chrome
iOS Safari					(except persistence if iOS < 10)
Safari
React Native	(see Note)			(except uploads)	(except persistence)
Node.js	(see Note)				(except persistence)
Chrome Extensions	(see Note)
Cordova	(see Note)

Note: All Authentication features, except phone authentication and popup/redirect OAuth operations, are supported.

Polyfills

The Firebase JavaScript SDK is built on the latest standards of the web platform. Some older browsers and JavaScript environments do not support all the features required by Firebase. If you must support these browsers/environments, then you need to load polyfills accordingly.

The sections below identify most of the polyfills you might need.

Required polyfills

Environments	Polyfills
IE 11	ES Stable
Safari 7 & 8 & 9	ES Stable
Node < 6.5	ES Stable

Optional polyfills

Environments	Polyfills	Firebase products
IE 11 Node Safari < 10.1 iOS < 10.3	fetch	Cloud Functions Performance Monitoring

Suggested polyfills

Polyfills	License
ES Stable	MIT
fetch	MIT

Add polyfills in your application

Option 1: (Recommended) Use bundler integrated with Babel

If you're using a bundler, integrate with Babel and @babel/preset-env to get polyfills.

Use Babel's interactive setup guide to learn how to integrate Babel with your bundler.

With Babel, you don't need to worry about the exact polyfills to include. Instead, you specify the minimal browser environments that you need to support. Babel then adds the necessary polyfills for you. Babel ensures that your requirements for browser support are always met, even if Firebase or your own code starts using new ES features.

@babel/preset-env has detailed information about the available configuration options for specifying environment targets (option targets) and adding polyfills (option useBuiltIns).

Note: If you're using a framework, the work of configuring Babel and adding polyfills might be different or actually already handled for you. Refer to Babel's interactive setup guide for more information.

Option 2: (Not Recommended) Add polyfills manually

You can add polyfills manually using your favorite polyfill libraries (for example, core-js).

import 'core-js/stable'
import 'cross-fetch/polyfill';

core-js also provides an all-in-one polyfill file that you can directly include in the HTML page.

This option can be a convenient way for managing polyfills if you don't use Babel. However, we don't recommend this all-in-one option for production apps as it will likely include unnecessary polyfills, which increases the page weight and hence the page load time.