Firestore模拟器：如何模拟外部数据更新？

你的核心需求是：监听器靠hasPendingWrites: false过滤本地变更，但测试时用客户端updateDoc会触发pending状态，监听器不响应，又不能全局关闭过滤。这里有几个可行的方案：

1. 用Firestore Admin SDK模拟外部更新 #

Admin SDK是直接操作Firestore后端（包括模拟器）的工具，不会产生本地客户端的pending writes。在测试代码里单独初始化Admin SDK指向模拟器，用它来更新文档——这样客户端监听器收到的快照hasPendingWrites会是false，完全符合外部变更的场景。

示例代码（Node.js测试环境）：

// 初始化Admin SDK指向模拟器
import { initializeApp } from "firebase-admin/app";
import { getFirestore } from "firebase-admin/firestore";

initializeApp({
  projectId: "your-test-project",
});
const adminFirestore = getFirestore();
adminFirestore.settings({
  host: "localhost:8080",
  ssl: false,
});

// 测试中用Admin SDK更新文档
await adminFirestore.collection("your-collection").doc("doc-id").update({
  field: "new-value"
});

这样客户端的监听器会正常触发，因为这个更新是从“外部”（模拟器后端）推过来的，没有本地pending状态。

2. 直接调用Firestore模拟器的REST API #

如果不想引入Admin SDK，也可以直接发HTTP请求到Firestore模拟器的API来修改数据。这种方式完全模拟外部服务或其他客户端的变更，同样不会产生本地pending writes。

示例请求（用fetch）：

await fetch("http://localhost:8080/v1/projects/your-test-project/databases/(default)/documents/your-collection/doc-id", {
  method: "PATCH",
  headers: {
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    fields: {
      field: { stringValue: "new-external-value" }
    }
  })
});

模拟器会把这个变更推送给客户端监听器，快照的hasPendingWrites为false，会通过你的过滤逻辑。

3. 测试环境下Mock快照的hasPendingWrites属性 #

如果只是单元测试监听器的逻辑，不想依赖模拟器，可以直接mock快照对象，强制把hasPendingWrites设为false。比如用Jest的mock功能：

// 假设你的监听器逻辑是这个函数
function handleSnapshot(snapshot) {
  if (!snapshot.metadata.hasPendingWrites) {
    // 处理外部变更
  }
}

// 测试时mock快照
const mockSnapshot = {
  metadata: { hasPendingWrites: false },
  // 其他需要的快照属性
};

handleSnapshot(mockSnapshot);
// 断言逻辑是否执行

这种方式适合快速验证监听器的过滤和处理逻辑，但不如前两种贴近真实场景。

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