如何预处理任意JavaScript值以存入Firebase Firestore？

Firestore仅支持特定类型的数据存储（如null、布尔值、有限数字、字符串、日期、普通对象、数组等），自定义对象、宿主对象（如window）、函数、Symbol、循环引用、NaN/Infinity等都会触发报错。以下是通用的预处理方案，能递归处理任意值，将不支持的类型转为字符串或跳过，同时避免循环引用问题：

核心预处理函数 #

function prepareForFirestore(value, seen = new WeakMap()) {
  // 处理循环引用，避免栈溢出
  if (seen.has(value)) {
    return '[Circular Reference]';
  }

  // 基础合法类型直接保留
  const type = typeof value;
  if (value === null) return null;
  if (type === 'boolean') return value;
  if (type === 'string') return value;
  if (type === 'number') {
    return Number.isFinite(value) ? value : value.toString(); // 处理NaN/Infinity
  }

  // 日期类型Firestore原生支持，直接保留
  if (value instanceof Date) return value;

  // 递归处理数组
  if (Array.isArray(value)) {
    seen.set(value, true);
    return value.map(item => prepareForFirestore(item, seen));
  }

  // 递归处理普通对象（原型为Object的对象）
  if (Object.prototype.toString.call(value) === '[object Object]') {
    seen.set(value, true);
    const result = {};
    for (const key in value) {
      if (Object.prototype.hasOwnProperty.call(value, key)) {
        const processedVal = prepareForFirestore(value[key], seen);
        // 跳过undefined，也可改为转为字符串，按需调整
        if (processedVal !== undefined) {
          result[key] = processedVal;
        }
      }
    }
    return result;
  }

  // 转换Map为普通对象、Set为数组
  if (value instanceof Map) {
    seen.set(value, true);
    const obj = {};
    value.forEach((v, k) => obj[k] = prepareForFirestore(v, seen));
    return obj;
  }
  if (value instanceof Set) {
    seen.set(value, true);
    return Array.from(value).map(item => prepareForFirestore(item, seen));
  }

  // 处理函数、Symbol、undefined等不支持类型
  if (type === 'function') return '[Function]';
  if (type === 'symbol') return value.toString();
  if (type === 'undefined') return undefined;

  // 处理自定义对象/宿主对象（如window、DOM元素）
  try {
    // 优先尝试JSON序列化，失败则返回类型标识
    return JSON.stringify(value);
  } catch {
    return Object.prototype.toString.call(value);
  }
}

使用示例 #

捕获错误后先预处理，再存入Firestore：

try {
  // 模拟抛出包含特殊属性的错误
  throw new Error('测试错误', { cause: { windowRef: window, utilFn: () => {} } });
} catch (error) {
  // 预处理错误对象
  const processedError = prepareForFirestore({
    message: error.message,
    stack: error.stack,
    cause: error.cause,
    timestamp: new Date()
  });

  // 写入Firestore
  db.collection('errors').add(processedError);
}

可自定义调整规则 #

• 若不想保留函数、Symbol等类型，可在对应处理逻辑中直接跳过（不加入结果对象）
• 对宿主对象（如DOM元素）可自定义提取属性，比如只保留tagName、id等有用字段
• 若希望将undefined转为null而非跳过，可修改对应判断逻辑

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