JavaScript 中 JSON 怎么利用 reviver 函数定制反序列化逻辑-js教程-PHP中文网

json.parse() 的 reviver 函数可在解析时逐层修改键值对，用于类型转换、敏感数据过滤等；它按深度优先顺序执行，接收key和value参数，返回值替换原值或undefined则删除该属性。

javascript 中 json 怎么利用 reviver 函数定制反序列化逻辑

JSON.parse() 的 reviver 函数让你能在解析过程中逐层修改每个键值对，实现字段类型转换、敏感数据过滤、日期字符串自动转 Date 对象等定制逻辑。

reviver 的执行时机和参数含义

reviver 是一个回调函数，会在 JSON.parse() 解析完每一层对象或数组的属性后立即调用，传入两个参数：key（当前属性名，根对象时为空字符串）和 value（当前属性值）。返回值将替代原 value 写入结果对象中；若返回 undefined，则该属性会被从结果中删除。

它按深度优先、从内到外的顺序执行：先处理叶子节点（如字符串、数字），再向上处理嵌套对象或数组
同一个对象的多个属性，reviver 会分别调用多次；数组元素也按索引依次调用
注意：reviver 无法区分原始 JSON 中的 null 和被显式设置为 null 的字段——它们都会以 null 传入

常见实用场景与写法

利用 reviver 可以在不额外遍历数据的前提下完成轻量级预处理：

Comprehensive Three.js 3D graphics reference

详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。

下载

自动转换 ISO 日期字符串为 Date 对象：检查 key 是否为 "createdAt"、"updatedAt" 等，且 value 是符合 ISO 格式的字符串，就 new Date(value)
过滤敏感字段：比如当 key === "password" 或 "token" 时，直接 return undefined，该字段就不会出现在最终对象里
统一数值精度处理：对特定 key（如 "price"、"rate"）的 number 值做 toFixed(2) 后转回 number，避免浮点误差影响展示
还原 Map / Set 等非标准序列化结构：约定某 key（如 "$map"）对应特殊标记，value 是键值对数组，则在 reviver 中 new Map(value)

注意事项和易错点

reviver 功能强大但容易误用，需留意几个关键细节：

不要在 reviver 中修改传入的 value 对象本身（比如给 object 添加方法），因为它是解析过程中的临时引用，可能影响后续层级
如果需要基于父级上下文做判断（例如“只有在 user 对象下才过滤 token”），只能靠 key 路径推断，reviver 本身不提供父对象信息；可考虑先完整解析，再用递归函数后处理
对数组，key 是字符串形式的索引（如 "0"、"1"），不是数字；若需区分数组项和对象属性，可结合 typeof value 判断
reviver 不适用于需要异步操作的场景（比如反序列化时请求远程解密），因为它必须同步返回结果

一个完整示例

把 API 返回的 JSON 中所有 timestamp 字段转成 Date，并移除内部使用的 _meta 字段：

const json = '{"name":"Alice","timestamp":"2024-05-20T10:30:00Z","_meta":{"id":123},"scores":[95,87]}';
const data = JSON.parse(json, (key, value) => {
  if (key === 'timestamp' && typeof value === 'string') {
    return new Date(value);
  }
  if (key === '_meta') {
    return undefined;
  }
  return value;
});
// 结果：{ name: "Alice", timestamp: Date, scores: [95, 87] }

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南