Các môi trường được hỗ trợ cho Firebase JavaScript SDK

Môi trường được hỗ trợ

SDK Firebase JavaScript được hỗ trợ chính thức trong các môi trường sau.

Trình duyệt

Sản phẩm của Firebase	Edge	Safari trên iOS
Firebase AI Logic ¹
Analytics
App Check
Authentication
Cloud Firestore	(ngoại trừ tính năng lưu trữ dữ liệu)	(ngoại trừ tính năng lưu trữ dữ liệu nếu iOS < 10)
Cloud Functions
Firebase installations
Cloud Messaging	(Edge 17 trở lên, ngoại trừ thiết bị di động)
Cloud Storage
Data Connect
Performance Monitoring
Realtime Database
Remote Config

^{1 Firebase AI Logic trước đây có tên là
"Vertex AI in Firebase".}

Các môi trường khác

Sản phẩm của Firebase	React Native	Node.js (18 trở lên)	Tiện ích Chrome	Cordova
Firebase AI Logic ¹
App Check	(sử dụng nhà cung cấp tuỳ chỉnh để chứng thực thiết bị gốc)	(sử dụng nhà cung cấp tuỳ chỉnh)
Analytics
Authentication	(xem phần Lưu ý)	(xem phần Lưu ý)	(xem phần Lưu ý)	(xem phần Lưu ý)
Cloud Firestore	(ngoại trừ tính năng lưu trữ dữ liệu)	(ngoại trừ tính năng lưu trữ dữ liệu)
Cloud Functions
Data Connect
Firebase installations
Cloud Messaging
Cloud Storage	(ngoại trừ tính năng tải lên)
Performance Monitoring
Realtime Database
Remote Config

^{1 Firebase AI Logic trước đây có tên là
"Vertex AI in Firebase".}

Polyfill

SDK Firebase JavaScript được xây dựng dựa trên các tiêu chuẩn mới nhất của nền tảng web. Một số trình duyệt và môi trường JavaScript cũ không hỗ trợ tất cả các tính năng mà Firebase yêu cầu. Nếu phải hỗ trợ các trình duyệt/môi trường này, thì bạn cần tải các polyfill tương ứng.

Các phần dưới đây xác định hầu hết các polyfill mà bạn có thể cần.

Polyfill bắt buộc

Môi trường	Polyfill
Safari 7, 8 và 9	ES ổn định
Node < 10	ES ổn định

Polyfill không bắt buộc

Môi trường	Polyfill	Sản phẩm của 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 và Expo	base-64	Cloud Storage

Polyfill nên dùng

Polyfill	Giấy phép
ES ổn định	MIT
fetch – `cross-fetch` – phù hợp nhất với các trình duyệt cũ	MIT
fetch – `undici` – phù hợp nhất với Node.js	MIT
base-64	MIT

Thiết lập Polyfill bắt buộc cho React Native và Expo

Đối với React Native và Expo, nếu bạn đang tải chuỗi được mã hoá base-64 lên, bạn cần làm như sau:

Cài đặt base-64 từ npm:

npm install base-64

Nhập decode từ base-64 và đính kèm vào phạm vi toàn cục dưới dạng atob để Cloud Storage có thể truy cập vào.

import { decode } from 'base-64';

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

Thêm polyfill vào ứng dụng

Cách 1: (Nên dùng) Sử dụng trình đóng gói tích hợp với Babel

Nếu đang sử dụng trình đóng gói, hãy tích hợp với Babel và @babel/preset-env để nhận polyfill.

Sử dụng hướng dẫn thiết lập tương tác của Babel để tìm hiểu cách tích hợp Babel với trình đóng gói.

Với Babel, bạn không cần lo lắng về các polyfill chính xác cần đưa vào. Thay vào đó, bạn chỉ định các môi trường trình duyệt tối thiểu mà bạn cần hỗ trợ. Sau đó, Babel sẽ thêm các polyfill cần thiết cho bạn. Babel đảm bảo rằng các yêu cầu của bạn về khả năng hỗ trợ trình duyệt luôn được đáp ứng, ngay cả khi Firebase hoặc mã của riêng bạn bắt đầu sử dụng các tính năng ES mới.

@babel/preset-env có thông tin chi tiết về các tuỳ chọn cấu hình hiện có để chỉ định mục tiêu môi trường (tuỳ chọn targets) và thêm polyfill (tuỳ chọn useBuiltIns).

Cách 2: (Không nên dùng) Thêm polyfill theo cách thủ công

Bạn có thể thêm polyfill theo cách thủ công bằng các thư viện polyfill yêu thích (ví dụ: core-js).

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

core-js cũng cung cấp một tệp polyfill tất cả trong một mà bạn có thể trực tiếp đưa vào trang HTML.

Cách này có thể là một cách thuận tiện để quản lý polyfill nếu bạn không sử dụng Babel. Tuy nhiên, chúng tôi không khuyên dùng cách tất cả trong một này cho các ứng dụng sản xuất vì cách này có thể bao gồm các polyfill không cần thiết, làm tăng dung lượng trang và do đó làm tăng thời gian tải trang.