สภาพแวดล้อมที่รองรับ Firebase JavaScript SDK

สภาพแวดล้อมที่รองรับ

SDK Firebase JavaScript ได้รับการรองรับอย่างเป็นทางการในสภาพแวดล้อมต่อไปนี้

เบราว์เซอร์

ผลิตภัณฑ์ Firebase Edge Firefox Chrome iOS Safari 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
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"

นโยบายรักษาความปลอดภัยเนื้อหาและประเภทที่เชื่อถือได้

ผลิตภัณฑ์ 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 ของหน้าเว็บต้องอนุญาตสคริปต์เหล่านี้

หากหน้าเว็บของคุณบังคับใช้ Trusted Types ด้วยคำสั่ง CSP require-trusted-types-for 'script' SDK Firebase JavaScript จะตั้งค่า URL ของสคริปต์เหล่านี้ผ่านนโยบาย Trusted Types ที่ชื่อ 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 จะบันทึกข้อผิดพลาดในคอนโซลที่ระบุชื่อนโยบายที่จะเพิ่ม

Polyfill

SDK Firebase JavaScript สร้างขึ้นตามมาตรฐานล่าสุดของแพลตฟอร์มเว็บ เบราว์เซอร์และสภาพแวดล้อม JavaScript รุ่นเก่าบางรุ่นไม่รองรับฟีเจอร์ทั้งหมดที่ Firebase ต้องใช้ หากต้องรองรับเบราว์เซอร์/สภาพแวดล้อมเหล่านี้ คุณจะต้องโหลด Polyfill ตามความเหมาะสม

ส่วนด้านล่างจะระบุ Polyfill ส่วนใหญ่ที่คุณอาจต้องใช้

Polyfill ที่จำเป็น

สภาพแวดล้อม Polyfill
Safari 7, 8 และ 9 ES เวอร์ชันเสถียร
โหนด < 10 ES เวอร์ชันเสถียร

Polyfill ที่ไม่บังคับ

สภาพแวดล้อม Polyfill ผลิตภัณฑ์ Firebase
  • Safari < 10.1
  • iOS < 10.3
fetch
  • Authentication
  • Cloud Firestore
  • Cloud Functions
  • Performance Monitoring
  • โหนด < 18
fetch
  • Authentication
  • Cloud Firestore
  • Cloud Functions
  • Cloud Storage
  • React Native และ Expo
base-64
  • Cloud Storage

Polyfill ที่แนะนำ

Polyfill ใบอนุญาต
ES เสถียร MIT
fetch - `cross-fetch` - เหมาะที่สุดสำหรับเบราว์เซอร์รุ่นเก่า MIT
fetch - `undici` - เหมาะที่สุดสำหรับ Node.js MIT
base-64 MIT

การตั้งค่า Polyfill ที่จำเป็นสำหรับ React Native และ Expo

สำหรับ React Native และ Expo หากคุณอัปโหลดสตริงที่เข้ารหัส Base-64 คุณต้องทำดังนี้

ติดตั้ง 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;
}

เพิ่ม Polyfill ในแอปพลิเคชัน

ตัวเลือกที่ 1: (แนะนำ) ใช้ Bundler ที่ผสานรวมกับ Babel

หากใช้ Bundler ให้ผสานรวมกับ Babel และ @babel/preset-env เพื่อรับ Polyfill

ใช้คู่มือการตั้งค่าแบบอินเทอร์แอกทีฟของ Babel เพื่อดูวิธีผสานรวม Babel กับ Bundler

เมื่อใช้ Babel คุณไม่จำเป็นต้องกังวลเกี่ยวกับ Polyfill ที่แน่นอนที่จะรวมไว้ แต่คุณจะระบุสภาพแวดล้อมของเบราว์เซอร์ขั้นต่ำที่ต้องรองรับแทน จากนั้น Babel จะเพิ่ม Polyfill ที่จำเป็นให้คุณ Babel ช่วยให้มั่นใจว่าข้อกำหนดสำหรับการรองรับเบราว์เซอร์จะเป็นไปตามที่ต้องการเสมอ แม้ว่า Firebase หรือโค้ดของคุณเองจะเริ่มใช้ฟีเจอร์ ES ใหม่ก็ตาม

@babel/preset-env มีข้อมูลโดยละเอียดเกี่ยวกับตัวเลือกการกำหนดค่าที่ใช้ได้สำหรับการระบุเป้าหมายสภาพแวดล้อม (ตัวเลือก targets) และการเพิ่ม Polyfill (ตัวเลือก useBuiltIns)

ตัวเลือกที่ 2: (ไม่แนะนำ) เพิ่ม Polyfill ด้วยตนเอง

คุณสามารถเพิ่ม Polyfill ด้วยตนเองโดยใช้ไลบรารี Polyfill ที่คุณชื่นชอบ (เช่น core-js)

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

core-js ยังมีไฟล์ Polyfill แบบครบวงจรที่คุณรวมไว้ในหน้า HTML ได้โดยตรง

ตัวเลือกนี้เป็นวิธีที่สะดวกในการจัดการ Polyfill หากคุณไม่ได้ใช้ Babel อย่างไรก็ตาม เราไม่แนะนําตัวเลือกแบบครบวงจรนี้สําหรับแอปเวอร์ชันที่ใช้งานจริง เนื่องจากอาจมี Polyfill ที่ไม่จําเป็น ซึ่งจะเพิ่มน้ำหนักหน้าเว็บและเวลาในการโหลดหน้าเว็บ