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.

Browsers

Firebase product	IE11	Edge	Firefox	Chrome	iOS Safari	Safari
Analytics
Authentication
Cloud Firestore	(except persistence)	(except persistence)			(except persistence if iOS < 10)
Cloud Functions
Cloud Messaging		(Edge 17+)
Cloud Storage
Performance Monitoring
Realtime Database
Remote Config

Other environments

Firebase product	React Native	Node.js	Chrome Extensions	Cordova
Analytics
Authentication	(see Note)	(see Note)	(see Note)	(see Note)
Cloud Firestore	(except persistence)	(except persistence)
Cloud Functions
Cloud Messaging
Cloud Storage	(except uploads)
Performance Monitoring
Realtime Database
Remote Config

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.