สภาพแวดล้อมที่รองรับ
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 |
|
| App Check |
|
| Authentication |
|
หากหน้าเว็บมีนโยบายรักษาความปลอดภัยเนื้อหา (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 |
|---|---|---|
|
fetch |
|
|
fetch |
|
|
base-64 |
|
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 ที่ไม่จําเป็น ซึ่งจะเพิ่มน้ำหนักหน้าเว็บและเวลาในการโหลดหน้าเว็บ