如何让 JSON.stringify 正确序列化所有属性（包括非枚举属性）-js教程-PHP中文网

如何让 JSON.stringify 正确序列化所有属性（包括非枚举属性）

JSON.stringify() 默认忽略非枚举属性（如通过 Object.defineProperty 设置 enumerable: false 的属性），导致数据丢失；本文详解原因及三种可靠解决方案：启用可枚举性、自定义 replacer 函数、或使用结构化克隆替代方案。

`json.stringify()` 默认忽略非枚举属性（如通过 `object.defineproperty` 设置 `enumerable: false` 的属性），导致数据丢失；本文详解原因及三种可靠解决方案：启用可枚举性、自定义 replacer 函数、或使用结构化克隆替代方案。

JSON.stringify() 是 JavaScript 中最常用的序列化工具，但它遵循 ECMAScript 规范中对“可枚举性（enumerability）”的严格约定：仅遍历并序列化对象自身、且 enumerable: true 的自有属性。这意味着通过 Object.defineProperty 显式设置 enumerable: false 的属性（如私有字段、元信息、内部状态等）将被完全跳过——这并非 bug，而是设计行为。

例如，以下代码输出 {"prop1":"value1"}，prop2 消失：

const obj = { prop1: 'value1' };
Object.defineProperty(obj, 'prop2', {
  value: 'value2',
  enumerable: false,  // ← 关键：不可枚举 → 被 stringify 忽略
  writable: true,
  configurable: true
});
console.log(JSON.stringify(obj)); // {"prop1":"value1"}

✅ 解决方案一：确保属性可枚举（最直接）

若业务逻辑允许，将属性设为可枚举是最简洁的做法：

Object.defineProperty(obj, 'prop2', {
  value: 'value2',
  enumerable: true, // ✅ 改为 true
  writable: true,
  configurable: true
});
console.log(JSON.stringify(obj)); // {"prop1":"value1","prop2":"value2"}

⚠️ 注意：enumerable: true 会使该属性出现在 for...in 循环和 Object.keys() 中，需评估是否影响现有遍历逻辑。

Wjs Localizing Video
用于端到端视频本地化流程的轻量编排器，路由至四个专注子技能——/wjs-transcribing-audio、/wjs-translating-subtitles...

下载

✅ 解决方案二：使用自定义 replacer 函数（灵活可控）

当无法修改属性枚举性（如处理第三方库对象或冻结对象）时，可通过 replacer 参数主动捕获所有自有属性（含不可枚举）：

function includeNonEnumerable(obj) {
  const allKeys = Object.getOwnPropertyNames(obj); // 获取所有自有属性名（含不可枚举）
  const result = {};
  for (const key of allKeys) {
    result[key] = obj[key];
  }
  return result;
}

// 使用示例
console.log(JSON.stringify(includeNonEnumerable(obj)));
// 输出：{"prop1":"value1","prop2":"value2"}

更通用的封装（支持嵌套对象）：

function deepIncludeNonEnumerable(value) {
  if (value === null || typeof value !== 'object') return value;

  const allKeys = Object.getOwnPropertyNames(value);
  const cloned = Array.isArray(value) ? [] : {};

  for (const key of allKeys) {
    cloned[key] = deepIncludeNonEnumerable(value[key]);
  }
  return cloned;
}

console.log(JSON.stringify(deepIncludeNonEnumerable(obj)));

✅ 解决方案三：避免 stringify，改用 structuredClone()（现代环境推荐）

对于需要完整保留属性特性（包括不可枚举性、getter/setter、Symbol 键等）的场景，JSON.stringify() 本质就不适用。现代浏览器和 Node.js ≥18.13 支持 structuredClone()，它能深拷贝几乎全部对象特性（不支持函数、undefined、循环引用等限制仍存在）：

try {
  const clone = structuredClone(obj);
  console.log(JSON.stringify(clone)); // ✅ 包含 prop2（因 clone 后属性默认可枚举）
} catch (err) {
  console.warn('structuredClone not supported:', err);
}