Environnements pris en charge pour le SDK JavaScript Firebase

Environnements pris en charge

Le SDK JavaScript Firebase est officiellement pris en charge dans les environnements suivants.

Navigateurs

Autres environnements

Polyfills

Le SDK JavaScript Firebase est construit sur les dernières normes de la plate-forme Web. Certains navigateurs et environnements JavaScript plus anciens ne prennent pas en charge 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

Polyfills facultatifs

Polyfills suggérés

Configuration Polyfill requise pour React Native et Expo

Pour React Native et Expo, si vous téléchargez une chaîne encodée en base 64, vous devez procéder comme suit :

Installez base-64 à partir de npm :

npm install base-64

Importez decode à partir de base-64 et associez-le au champ d'application global en tant atob afin 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 le 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. Au lieu de cela, vous spécifiez les environnements de navigateur minimaux que vous devez prendre en charge. Babel ajoute ensuite les polyfills nécessaires pour vous. Babel garantit que vos exigences en matière de prise en charge du navigateur sont toujours satisfaites, même si Firebase ou votre propre code commence à utiliser de nouvelles fonctionnalités ES.

@babel/preset-env contient 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 ).

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

Vous pouvez ajouter des polyfills manuellement à l'aide de vos bibliothèques de polyfill 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. Cependant, nous ne recommandons pas cette option tout-en-un pour les applications de production car elle inclura probablement des polyfills inutiles, ce qui augmente le poids de la page et donc le temps de chargement de la page.