Firebase中collection.get()返回的QuerySnapshot是什么数据类型？

Firebase Cloud Firestore 中调用集合/查询引用的 .get() 方法返回的 QuerySnapshot 是 Firebase SDK 自定义的不可变类实例，不属于 JavaScript 原生的数组或普通对象类型，是 Firestore 专门封装用来承载批量查询结果的容器类型。

它的核心特性如下：

• 实现了 JavaScript 可迭代接口，内置 forEach 遍历方法，所以使用体验和数组类似，但本身不具备数组的原生方法（比如 map、filter、push 等），直接调用这些数组方法会抛出错误。
• 自带多个只读属性和内置方法用来快速获取查询信息，常见的包括：
  • size：返回匹配查询的文档总数量
  • empty：布尔值，直接判断查询结果是否为空
  • docs：返回由所有查询到的QueryDocumentSnapshot（单条文档快照对象）组成的原生 JavaScript 数组，如果需要用数组方法处理结果，直接取这个属性即可
  • metadata：返回本次查询的元信息，比如数据来源是本地缓存还是远端服务器

相关代码示例：
获取集合数据的基础写法：

const collectionData = await collectionPath.get();
// 这里的 collectionData 就是 QuerySnapshot 实例

遍历及数组转换写法：

// 用 QuerySnapshot 内置的 forEach 遍历
collectionData.forEach(doc => {
  // 单个 doc 是 QueryDocumentSnapshot 实例，调用 doc.data() 可获取文档原始数据
  const docContent = doc.data();
});

// 转成原生数组后使用数组方法处理
const docList = collectionData.docs;
const allDocContent = docList.map(doc => doc.data());

内容的提问来源于stack exchange，提问作者Ziyaad Shiraz