Obsługiwane środowiska pakietu SDK Firebase JavaScript

Obsługiwane środowiska

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

Ważne: nadal musisz uwzględniać polyfille w przypadku środowisk, które nie obsługują funkcji wymaganych przez Firebase.

Przeglądarki

Usługa Firebase	Edge	Firefox	Chrome	Safari na iOS	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
Firebase instalacji
Cloud Messaging	(Edge w wersji 17 lub nowszej, z wyjątkiem wersji mobilnej)
Cloud Storage
Data Connect
Performance Monitoring
Realtime Database
Remote Config

^{1 Firebase AI Logic wcześniej nazywała się „Vertex AI in Firebase”.}

Inne środowiska

Usługa Firebase	React Native	Node.js (18+).	Rozszerzenia do Chrome	Cordova
Firebase AI Logic ^1
App Check	(za pomocą niestandardowego dostawcy do przeprowadzania natywnej weryfikacji urządzenia)	(za pomocą 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
Data Connect
Firebase instalacji
Cloud Messaging
Cloud Storage	(z wyjątkiem plików )
Performance Monitoring
Realtime Database
Remote Config

^{1 Firebase AI Logic wcześniej nazywała się „Vertex AI in Firebase”.}

Uwaga: obsługiwane są wszystkie funkcje Authentication, z wyjątkiem uwierzytelniania przez telefon i operacji OAuth w przypadku wyskakujących okienek i przekierowań.

Watoliny

Pakiet SDK Firebase JavaScript jest oparty na najnowszych standardach 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 rozwiązania zastępcze

Środowiska	Wypełniacze
Safari 7, 8 i 9	ES Stabilna
Węzeł < 10	ES Stabilna

Opcjonalne rozwiązania zastępcze

Środowiska	Wypełniacze	Usługi Firebase
Safari w wersji < 10.1 iOS < 10.3	pobieranie	Authentication Cloud Firestore Cloud Functions Performance Monitoring
Węzeł Poniżej 18 lat	pobieranie	Authentication Cloud Firestore Cloud Functions Cloud Storage
React Native i Expo	base-64	Cloud Storage

Sugerowane rozwiązania zastępcze

Wypełniacze	Licencja
ES Stabilna	MIT
fetch – „cross-fetch” – najlepsze rozwiązanie w przypadku starszych przeglądarek.	MIT
fetch – „undici” – najlepiej nadaje się do Node.js	MIT
base-64	MIT

Wymagane skonfigurowanie wypełniacza w przypadku React Native i Expo

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

Zainstaluj pakiet base-64 z npm:

npm install base-64

Zaimportuj decode z base-64 i dołącz go do zakresu globalnego jako atob, aby Cloud Storage mógł z niego korzystać.

import { decode } from 'base-64';

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

Dodawanie polyfilli do aplikacji

Opcja 1: (zalecana) użyj narzędzia do tworzenia pakietów zintegrowanego z Babel

Jeśli używasz pakietu, zintegruj się z Babelem i @babel/preset-env, aby uzyskać polyfilly.

Aby dowiedzieć się, jak zintegrować Babel z bundlerem, skorzystaj z interaktywnego przewodnika po konfiguracji.

Dzięki Babel nie musisz się martwić, które polyfille uwzględnić. Zamiast tego określ minimalne środowisko przeglądarki, które musisz obsługiwać. Babel automatycznie doda do projektu niezbędne rozwiązania polyfill. Babel zapewnia, że wymagania dotyczące obsługi przeglądarki są zawsze spełnione, nawet jeśli Firebase lub Twój kod zacznie używać nowych funkcji ES.

@babel/preset-env zawiera szczegółowe informacje o dostępnych opcjach konfiguracji umożliwiających określenie celów środowiska (opcja targets) i dodanie polyfilli (opcja useBuiltIns).

Uwaga: jeśli używasz frameworka, konfigurowanie Babela i dodawanie polyfillów może wyglądać inaczej lub może to być już zrobione za Ciebie. Więcej informacji znajdziesz w interaktywnym przewodniku po konfiguracji Babel.

Opcja 2: (nie zalecane) Dodaj polyfille ręcznie.

Możesz ręcznie dodawać polyfilly za pomocą ulubionych bibliotek polyfill (na przykład core-js).

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

core-js udostępnia też uniwersalny 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 korzystania z tego rozwiązania typu „wszystko w jednym” w przypadku aplikacji produkcyjnych, ponieważ prawdopodobnie będzie ono zawierać niepotrzebne rozwiązania polyfill, które zwiększają rozmiar strony, a co za tym idzie – czas jej wczytywania.