Firebase 是一款由 Google 提供的云计算服务,包括实时数据库、认证、存储、分析和 ML 等功能。其中,@firebase/firestore 是 Firebase 发布的一款 NoSQL 数据库,用于存储和同步数据。它可以轻松地从移动设备或 Web 上的任何平台记录和查询数据,并允许实时与其他用户共享。
使用 @firebase/firestore 可以快速创建一个云数据库应用,并轻松处理复杂的增删改查操作。本文将教你如何在前端项目中使用 @firebase/firestore。
环境准备
使用 @firebase/firestore 需要安装 firebase 包,可以使用 npm 安装:
--- ------- -------- ------
初始化 Firebase
初始化 Firebase 是使用任何 Firebase 服务的前置条件,因为它会对用户身份验证和数据库密钥进行认证。在项目中引入 firebase 包后,在需要使用 @firebase/firestore 的文件中,首先引入 firebase,然后在代码中添加以下代码段:
------ -------- ---- -------------- ------ -------------------- -- ---------- -------- ----- -------------- - - -- ----- -------- ---- - -------------------------------------- ----- -- - --------------------
上面的代码段首先引入了 firebase 和 @firebase/firestore,然后使用 initializeApp()
方法来初始化 Firebase 并传入配置项。最后使用 firestore()
方法获得实例,这里我们将其存放在 db 变量中,以便在后文中使用。
使用 Firestore
通过上面的初始化代码,我们已经完成了 @firebase/firestore 的准备工作,接下来就可以开始使用 Firestore 进行操作了。
添加文档
向 Firestore 中添加文档是比较常见的操作,可以使用 add()
方法轻松地向集合中添加一个新文档。以下是一个添加新文档的代码示例:
----- ------- - ---------------------- ------------- ----- ----- ---- --- ------ ----------------- -- ------------ -- - --------------------- ------- ---- --- -- ---------- -- ------------ -- - -------------------- ------ --------- -- ------ --
通过 collection()
方法获取集合的引用,然后使用 add()
方法添加新文档,最后使用 Promise 处理成功或失败的情况。
读取文档
在 Firestore 中获取文档的方法与添加非常类似,通过 collection()
方法获取集合引用,然后使用 get()
方法获取该集合的所有文档。以下是一个读取集合文档的代码示例:
----- ------- - ---------------------- ------------- ------------------- -- - ------------------------- -- - ------------------- - -- -- ----------- -- -- ------------ -- - -------------------- ------- ---------- -- ------ --
使用 get()
方法会返回一个 Promise,该方法返回一个 QuerySnapshot 对象,QuerySnapshot 对象包含了所有符合条件的文档的快照,可以使用 forEach()
方法遍历所有文档输出到控制台。
更新文档
在 Firestore 中更新文档的操作是通过引用文档对象,然后使用 update()
方法来更新文档中的数据。以下是一个更新文档数据的代码示例:
----- ------- - -------------------------------------------------- ---------------- ---- -- -- -------- -- - --------------------- ------- --------------- -- ------------ -- - -------------------- -------- --------- -- ------ --
可以通过 doc()
方法获取文档引用并传入文档 ID 获取该文档的引用,然后使用 update()
方法更新该文档中的数据。需要注意的是,在调用 update()
方法时,该文档必须在数据库中存在,否则会抛出错误。
删除文档
同样的,通过文档引用使用 delete()
方法可以删除文档。以下是一个删除文档的代码示例:
----- ------- - -------------------------------------------------- ---------------- -------- -- - --------------------- ------- --------------- -- ------------ -- - -------------------- -------- --------- -- ------ --
在调用 delete()
方法时,会将该文档从 Firestore 中删除,如果文档不存在则会抛出错误。
结语
通过本文的介绍,你应该已经了解了如何在前端项目中使用 @firebase/firestore 库来访问 Firestore 数据库和进行增删改查的操作。当然,这里只是讲解了一些基本操作,实际上 Firestore 还有很多强大的功能没有介绍到,比如 Query 和 DocumentReference 等,希望通过本文能够为初学者提供更细致的指导和学习参考。
来源:JavaScript中文网 ,转载请联系管理员! 本文地址:https://www.javascriptcn.com/post/5eedc531b5cbfe1ea06121e3