在 JavaScript 中安装和设置

Firebase 实时数据库是一种托管在云端的数据库。数据以 JSON 格式存储并实时同步到所连接的每个客户端。当您使用我们的 Android、Apple 平台和 JavaScript SDK 构建跨平台应用时,所有的客户端共享一个 Realtime Database 实例,并自动接收包含最新数据的更新。

前提条件

如果您尚未安装 Firebase JS SDK 并初始化 Firebase,请先安装并进行初始化。

创建数据库

  1. 进入 Firebase 控制台Realtime Database 部分。 系统将会提示您选择一个现有的 Firebase 项目。按照数据库创建工作流操作。

  2. 为您的 Firebase 安全规则选择一个初始模式:

    测试模式

    此模式适合刚开始使用移动和 Web 客户端库的开发者,但会允许任何人读取和覆盖您的数据。测试完成后,请务必查看了解 Firebase Realtime Database 规则部分。

    如果是刚开始使用 Web、Apple 或 Android SDK,请选择测试模式。

    锁定模式

    拒绝来自移动和 Web 客户端的所有读写操作。经过身份验证的应用服务器仍然可以访问您的数据库。

  3. 为数据库选择位置。

    新数据库的网址将采用下列格式之一,具体取决于数据库的位置

    • DATABASE_NAME.firebaseio.com(位于 us-central1 的数据库)

    • DATABASE_NAME.REGION.firebasedatabase.app(位于所有其他位置的数据库)

  4. 点击完成

如果启用 Realtime Database,也就在 Cloud API 管理器中启用了相应 API。

配置 Realtime Database 安全规则

Realtime Database 提供了声明性规则语言,可用于定义数据的结构、将数据编入索引的方式,以及何时可以在其中读取和写入数据。

添加 Realtime Database JS SDK 并初始化 Realtime Database

在初始化 JavaScript SDK 时,您必须指定您的 Realtime Database 网址。

您可以在 Firebase 控制台的“Realtime Database”部分找到您的 Realtime Database 网址。数据库网址将采用下列格式之一,具体取决于数据库的位置

  • https://DATABASE_NAME.firebaseio.com(位于 us-central1 的数据库)
  • https://DATABASE_NAME.REGION.firebasedatabase.app(适用于所有其他位置的数据库)

使用以下这段代码初始化您的 SDK:

Web 模块化 API

import { initializeApp } from "firebase/app";
import { getDatabase } from "firebase/database";

// TODO: Replace the following with your app's Firebase project configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
  // The value of `databaseURL` depends on the location of the database
  databaseURL: "https://DATABASE_NAME.firebaseio.com",
};

// Initialize Firebase
const app = initializeApp(firebaseConfig);


// Initialize Realtime Database and get a reference to the service
const database = getDatabase(app);

Web 命名空间型 API

import firebase from "firebase/app";
import "firebase/compat/database";

// TODO: Replace the following with your app's Firebase project configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
  // The value of `databaseURL` depends on the location of the database
  databaseURL: "https://DATABASE_NAME.firebaseio.com",
};

// Initialize Firebase
firebase.initializeApp(firebaseConfig);


// Initialize Realtime Database and get a reference to the service
const database = firebase.database();

现在您就可以开始使用 Firebase Realtime Database 了!

后续步骤