Поддерживаемые среды для Firebase JavaScript SDK

Поддерживаемые среды

Firebase JavaScript SDK официально поддерживается в следующих средах.

Браузеры

Продукт Firebase Edge Firefox Chrome Safari для iOS Safari
Firebase AI Logic 1
Analytics
App Check
Authentication
Cloud Firestore
(кроме
постоянства)

(кроме
сохранения
в iOS < 10)
Cloud Functions
Cloud Messaging
(Edge 17 и более поздние версии, кроме мобильных)
Cloud Storage
Crashlytics
Firebase установок
Performance Monitoring
Realtime Database
Remote Config
SQL Connect

1 Firebase AI Logic ранее назывался Vertex AI in Firebase.

Другие среды

Продукт Firebase React Native; Node.js (18+) Расширения
Chrome
Кордова
Firebase AI Logic 1
App Check
(с помощью стороннего поставщика для подтверждения устройств)

(с помощью стороннего поставщика)
Analytics
Authentication
(см. Примечание)

(см. Примечание)

(см. Примечание)

(см. Примечание)
Cloud Firestore
(кроме
постоянства)

(кроме
постоянства)
Cloud Functions
Cloud Messaging
Cloud Storage
(кроме
загрузок)
Crashlytics
Firebase установок
Performance Monitoring
Realtime Database
Remote Config
SQL Connect

1 Firebase AI Logic ранее назывался Vertex AI in Firebase.

Content Security Policy и доверенные типы

Некоторые продукты Firebase загружают внешние скрипты, добавляя на страницу элементы <script>:

Продукт Firebase Загруженные скрипты
Analytics
  • тегу Google https://www.googletagmanager.com/gtag/js;
App Check
  • reCAPTCHA v3: https://www.google.com/recaptcha/api.js
  • reCAPTCHA Enterprise: https://www.google.com/recaptcha/enterprise.js
Authentication
  • Загрузчик API Google для входа через всплывающее окно и перенаправление: https://apis.google.com/js/api.js
  • reCAPTCHA v2 для аутентификации по телефону: https://www.google.com/recaptcha/api.js
  • reCAPTCHA Enterprise, если вы используете интеграцию с reCAPTCHA Enterprise: https://www.google.com/recaptcha/enterprise.js.

Если на вашей странице используется Content Security Policy (CSP), то директива script-src должна разрешать эти скрипты.

Если на вашей странице принудительно применяются доверенные типы с директивой CSP require-trusted-types-for 'script', то Firebase JavaScript SDK задает эти URL скриптов с помощью политики доверенных типов под названием firebase-js-sdk-policy. Это правило принимает только URL скриптов, перечисленные выше. Если в вашей CSP также используется директива trusted-types, чтобы ограничить создание правил, добавьте в нее firebase-js-sdk-policy и другие правила, которые используются в вашем приложении. Пример:

Content-Security-Policy: require-trusted-types-for 'script'; trusted-types firebase-js-sdk-policy

Если правила не разрешены, эти продукты не смогут загрузить свои скрипты, а SDK зарегистрирует в консоли ошибку с указанием правила, которое необходимо добавить.

Полизаполнения

SDK Firebase JavaScript создан на основе новейших стандартов веб-платформы. Некоторые старые браузеры и среды JavaScript не поддерживают все функции, необходимые для Firebase. Если вам необходимо поддерживать эти браузеры/среды, вам нужно загрузить соответствующие полифилы.

Ниже перечислены наиболее распространенные полифилы.

Необходимые полифилы

Среды Полифилы
Safari 7, 8 и 9 ES Stable
Узел < 10 ES Stable

Необязательные полифилы

Среды Полифилы Продукты 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 и Expo
base-64
  • Cloud Storage

Рекомендуемые полифилы

Полифилы Лицензия
ES Стабильная MIT
fetch – `cross-fetch` – лучше всего подходит для старых браузеров. MIT
fetch – undici – лучше всего подходит для Node.js. MIT
base-64 MIT

Настройка полифила для React Native и Expo

Если вы загружаете строку в кодировке Base64 для React Native и Expo, выполните следующие действия:

Установите base-64 из npm:

npm install base-64

Импортируйте decode из base-64 и прикрепите его к глобальной области видимости как atob, чтобы Cloud Storage мог получить к нему доступ.

import { decode } from 'base-64';

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

Добавьте полифилы в приложение

Вариант 1. (Рекомендуется) Использовать сборщик, интегрированный с Babel

Если вы используете сборщик, интегрируйте его с Babel и @babel/preset-env, чтобы получить полифилы.

Чтобы узнать, как интегрировать Babel со сборщиком, воспользуйтесь интерактивным руководством по настройке.

С Babel вам не нужно беспокоиться о том, какие именно полифилы следует включить. Вместо этого вы указываете минимальные среды браузера, которые вам необходимо поддерживать. Затем Babel добавляет необходимые полифилы. Babel гарантирует, что ваши требования к поддержке браузеров всегда будут соблюдаться, даже если Firebase или ваш собственный код начнут использовать новые функции ES.

В документации по @babel/preset-env подробно описаны доступные параметры конфигурации для указания целевых сред (параметр targets) и добавления полифилов (параметр useBuiltIns).

Вариант 2. (Не рекомендуется) Добавьте полифилы вручную.

Вы можете добавить полифилы вручную, используя свои любимые библиотеки полифилов (например, core-js).

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

core-js также предоставляет универсальный файл полифила, который можно напрямую включить в HTML-страницу.

Этот вариант может быть удобен для управления полифилами, если вы не используете Babel. Однако мы не рекомендуем использовать этот вариант для рабочих приложений, поскольку он может включать ненужные полифилы, которые увеличивают размер страницы и, следовательно, время загрузки страницы.