Firebase JavaScript SDK 支援的環境

支援的環境

Firebase JavaScript SDK 正式支援下列環境。

瀏覽器

Firebase 產品 Edge Firefox Chrome iOS Safari Safari
Firebase AI Logic 1
Analytics
App Check
Authentication
Cloud Firestore
(
持續性除外)

(iOS < 10 的
persistence
除外)
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
擴充功能
Cordova
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」。

內容安全政策和 Trusted Types

部分 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
  • Google API 載入器,用於彈出式視窗和重新導向登入: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

如果網頁設有內容安全政策 (CSP),其 script-src 指令必須允許這些指令碼。

如果您的網頁使用 require-trusted-types-for 'script' CSP 指令強制執行可信任類型,Firebase JavaScript SDK 會透過名為 firebase-js-sdk-policy 的可信任類型政策設定這些指令碼網址。這項政策僅接受上方列出的指令碼網址。如果 CSP 也使用 trusted-types 指令限制可建立的政策,請將 firebase-js-sdk-policy 和應用程式使用的其他政策一併加入。例如:

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

如果政策不允許,這些產品就無法載入指令碼,且 SDK 會在控制台中記錄錯誤,並列出要新增的政策。

Polyfill

Firebase JavaScript SDK 是根據網路平台的最新標準建構而成。部分舊版瀏覽器和 JavaScript 環境不支援 Firebase 所需的所有功能。如果必須支援這些瀏覽器/環境,則需要載入相應的 polyfill。

以下各節會列出您可能需要的大部分 polyfill。

必要的 Polyfill

環境 Polyfill
Safari 7、8 和 9 ES 穩定版
Node < 10 ES 穩定版

選用 Polyfill

環境 Polyfill 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

建議的 Polyfill

Polyfill 授權
ES 穩定版 麻省理工學院
fetch - `cross-fetch` - 最適合舊版瀏覽器 麻省理工學院
fetch - `undici` - 最適合 Node.js 麻省理工學院
base-64 麻省理工學院

React Native 和 Expo 的必要 Polyfill 設定

如果是 React Native 和 Expo,上傳以 Base-64 編碼的字串時,請按照下列步驟操作:

從 npm 安裝 base-64:

npm install base-64

從 base-64 匯入 decode,並將其附加至全域範圍做為 atob,以便 Cloud Storage 存取。

import { decode } from 'base-64';

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

在應用程式中新增 Polyfill

選項 1:(建議) 使用與 Babel 整合的 Bundler

如果您使用套件組合器,請與 Babel 和 @babel/preset-env 整合,以取得 polyfill。

請參閱 Babel 的互動式設定指南,瞭解如何將 Babel 與套件整合。

有了 Babel,您就不必擔心要加入哪些確切的 polyfill。而是指定需要支援的最低瀏覽器環境。Babel 接著會為您新增必要的 polyfill。即使 Firebase 或您自己的程式碼開始使用新的 ES 功能,Babel 也能確保您的瀏覽器支援需求始終獲得滿足。

@babel/preset-env 包含詳細資訊,說明可用於指定環境目標 (選項 targets) 和新增 polyfill (選項 useBuiltIns) 的設定選項。

方法 2:(不建議) 手動新增 polyfill

您可以使用偏好的 polyfill 程式庫 (例如 core-js) 手動新增 polyfill。

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

core-js 也提供多合一 polyfill 檔案,可直接加入 HTML 網頁。

如果您不使用 Babel,這個選項可以方便您管理 polyfill。不過,我們不建議在正式版應用程式中使用這種全包式選項,因為這可能會包含不必要的 polyfill,導致網頁權重增加,進而延長網頁載入時間。