Obsługiwane środowiska pakietu SDK Firebase JavaScript

Obsługiwane środowiska

Pakiet SDK Firebase JavaScript jest oficjalnie obsługiwany w tych środowiskach.

Przeglądarki

Usługa Firebase Edge Firefox Chrome iOS Safari Safari
Firebase AI Logic 1
Analytics
App Check
Authentication
Cloud Firestore
(z wyjątkiem
trwałości)

(z wyjątkiem
trwałości
w przypadku iOS < 10)
Cloud Functions
Cloud Messaging
(Edge 17 lub nowsza, z wyjątkiem urządzeń mobilnych)
Cloud Storage
Crashlytics
Firebase instalacje
Performance Monitoring
Realtime Database
Remote Config
SQL Connect

1 Firebase AI Logic wcześniej nosił nazwę „Vertex AI in Firebase”.

Inne środowiska

Usługa Firebase React Native Node.js (18+) Rozszerzenia
Chrome
Cordova
Firebase AI Logic 1
App Check
(przy użyciu niestandardowego dostawcy do natywnej atestacji urządzenia)

(przy użyciu niestandardowego dostawcy)
Analytics
Authentication
(patrz Uwaga)

(patrz Uwaga)

(patrz Uwaga)

(patrz Uwaga)
Cloud Firestore
(z wyjątkiem
trwałości)

(z wyjątkiem
trwałości)
Cloud Functions
Cloud Messaging
Cloud Storage
(z wyjątkiem
przesyłania)
Crashlytics
Firebase instalacje
Performance Monitoring
Realtime Database
Remote Config
SQL Connect

1 Firebase AI Logic wcześniej nosił nazwę „Vertex AI in Firebase”.

Kody polyfill

Pakiet SDK Firebase JavaScript został utworzony zgodnie z najnowszymi standardami platformy internetowej. Niektóre starsze przeglądarki i środowiska JavaScript nie obsługują wszystkich funkcji wymaganych przez Firebase. Jeśli musisz obsługiwać te przeglądarki lub środowiska, musisz odpowiednio wczytać polyfille.

W sekcjach poniżej znajdziesz większość polyfilli, których możesz potrzebować.

Wymagane polyfille

Środowiska Polyfills
Safari 7, 8 i 9 ES Stable
Węzeł < 10 ES Stable

Opcjonalne polyfille

Środowiska Polyfills Usługi 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 i Expo
base-64
  • Cloud Storage

Sugerowane polyfille

Polyfills Licencja
ES Stabilna MIT
fetch – `cross-fetch` – najlepsze rozwiązanie w przypadku starszych przeglądarek, MIT
fetch – `undici` – najlepsze rozwiązanie w przypadku Node.js MIT
base-64 MIT

Wymagana konfiguracja polyfilla w przypadku React Native i Expo

Jeśli w przypadku React Native i Expo przesyłasz ciąg znaków zakodowany w formacie Base64, musisz wykonać te czynności:

Zainstaluj base-64 z npm:

npm install base-64

Zaimportuj decode z base-64 i dołącz do zakresu globalnego jako atob, aby Cloud Storage miał do niego dostęp.

import { decode } from 'base-64';

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

Dodawanie polyfilli w aplikacji

Opcja 1. (Zalecana) Użyj bundlera zintegrowanego z Babel.

Jeśli używasz bundlera, zintegruj go z Babel i @babel/preset-env, aby uzyskać polyfille.

Skorzystaj z interaktywnego przewodnika po konfiguracji Babel, aby dowiedzieć się, jak zintegrować Babel z bundlerem.

Dzięki Babel nie musisz się martwić o dokładne polyfille, które należy uwzględnić. Zamiast tego określasz minimalne środowiska przeglądarki, które musisz obsługiwać. Babel doda wtedy niezbędne polyfille. Babel dba o to, aby wymagania dotyczące obsługi przeglądarki były zawsze spełnione, nawet jeśli Firebase lub Twój własny kod zacznie używać nowych funkcji ES.

@babel/preset-env zawiera szczegółowe informacje o dostępnych opcjach konfiguracji do określania środowisk docelowych (opcja targets) i dodawania polyfilli (opcja useBuiltIns).

Opcja 2. (Niezalecana) Ręczne dodawanie polyfilli

Możesz dodać polyfille ręcznie, korzystając z ulubionych bibliotek polyfilli (np. core-js).

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

core-js udostępnia też kompleksowy plik polyfill, który możesz bezpośrednio umieścić na stronie HTML.

Ta opcja może być wygodnym sposobem zarządzania polyfillami, jeśli nie używasz Babel. Nie zalecamy jednak tej opcji „wszystko w jednym” w przypadku aplikacji produkcyjnych, ponieważ prawdopodobnie będzie ona zawierać niepotrzebne kody polyfill, co zwiększy wagę strony, a tym samym czas wczytywania strony.