Environnements compatibles avec le SDK Firebase JavaScript

Environnements compatibles

Le SDK Firebase JavaScript est officiellement compatible avec les environnements suivants.

Important : Vous devez toujours inclure des polyfills pour les environnements qui ne sont pas compatibles avec les fonctionnalités requises par Firebase.

Navigateurs

Produit Firebase	Edge	Firefox	Chrome	Safari iOS	Safari
Firebase AI Logic ^1
Analytics
App Check
Authentication
Cloud Firestore	(sauf persistance)			(sauf persistance si iOS < 10)
Cloud Functions
Cloud Messaging	(Edge 17 ou version ultérieure, sauf mobile)
Cloud Storage
Firebase installations
Performance Monitoring
Realtime Database
Remote Config
SQL Connect

^{1 Firebase AI Logic s'appelait auparavant "Vertex AI in Firebase".}

Autres environnements

Produit Firebase	React Native	Node.js (18+)	Chrome Extensions	Cordova
Firebase AI Logic ^1
App Check	(à l'aide d'un fournisseur personnalisé pour effectuer l'attestation d'appareil native)	(à l'aide d'un fournisseur personnalisé)
Analytics
Authentication	(voir la remarque)	(voir la remarque)	(voir la remarque)	(voir la remarque)
Cloud Firestore	(sauf persistance)	(sauf persistance)
Cloud Functions
Cloud Messaging
Cloud Storage	(sauf les importations)
Firebase installations
Performance Monitoring
Realtime Database
Remote Config
SQL Connect

^{1 Firebase AI Logic s'appelait auparavant "Vertex AI in Firebase".}

Remarque : Toutes les fonctionnalités de Authentication sont compatibles, à l'exception de l'authentification par téléphone et des opérations OAuth de pop-up/redirection.

Polyfills

Le SDK Firebase JavaScript est basé sur les dernières normes de la plate-forme Web. Certains navigateurs et environnements JavaScript plus anciens ne sont pas compatibles avec toutes les fonctionnalités requises par Firebase. Si vous devez prendre en charge ces navigateurs/environnements, vous devez charger les polyfills en conséquence.

Les sections ci-dessous identifient la plupart des polyfills dont vous pourriez avoir besoin.

Polyfills requis

Environnements	Polyfills
Safari 7, 8 et 9	ES Stable
Nœud < 10	ES Stable

Polyfills facultatifs

Environnements	Polyfills	Produits Firebase
Safari < 10.1 iOS < 10.3	fetch	Authentication Cloud Firestore Cloud Functions Performance Monitoring
Node < 18	fetch	Authentication Cloud Firestore Cloud Functions Cloud Storage
React Native et Expo	base-64	Cloud Storage

Polyfills suggérés

Polyfills	Licence
ES Stable	MIT
fetch : "cross-fetch", idéal pour les anciens navigateurs	MIT
fetch : "undici" : idéal pour Node.js	MIT
base-64	MIT

Configuration de polyfill requise pour React Native et Expo

Pour React Native et Expo, si vous importez une chaîne encodée en base64, vous devez procéder comme suit :

Installez base-64 à partir de npm :

npm install base-64

Importez decode depuis base-64 et associez-le au champ d'application global en tant que atob pour que Cloud Storage puisse y accéder.

import { decode } from 'base-64';

if(typeof atob === 'undefined') {
  global.atob = decode;
}

Ajouter des polyfills dans votre application

Option 1 : (recommandé) Utiliser un bundler intégré à Babel

Si vous utilisez un bundler, intégrez-le à Babel et @babel/preset-env pour obtenir des polyfills.

Utilisez le guide de configuration interactif de Babel pour apprendre à intégrer Babel à votre bundler.

Avec Babel, vous n'avez pas à vous soucier des polyfills exacts à inclure. À la place, vous spécifiez les environnements de navigateur minimaux que vous devez prendre en charge. Babel ajoute ensuite les polyfills nécessaires pour vous. Babel s'assure que vos exigences de compatibilité avec les navigateurs sont toujours respectées, même si Firebase ou votre propre code commence à utiliser de nouvelles fonctionnalités ES.

@babel/preset-env fournit des informations détaillées sur les options de configuration disponibles pour spécifier les cibles d'environnement (option targets) et ajouter des polyfills (option useBuiltIns).

Remarque : Si vous utilisez un framework, la configuration de Babel et l'ajout de polyfills peuvent être différents ou déjà gérés pour vous. Pour en savoir plus, consultez le guide de configuration interactif de Babel.

Option 2 : (Non recommandé) Ajouter des polyfills manuellement

Vous pouvez ajouter des polyfills manuellement à l'aide de vos bibliothèques de polyfills préférées (par exemple, core-js).

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

core-js fournit également un fichier polyfill tout-en-un que vous pouvez inclure directement dans la page HTML.

Cette option peut être un moyen pratique de gérer les polyfills si vous n'utilisez pas Babel. Toutefois, nous ne recommandons pas cette option tout-en-un pour les applications de production, car elle inclura probablement des polyfills inutiles, ce qui augmente la taille de la page et donc son temps de chargement.