为什么 JSON 深拷贝会忽略 undefined 和 Symbol 属性?

千敏酱_8097

千敏酱_8097

2026-06-13

568人浏览

原创

json深拷贝忽略undefined和symbol是严格遵循规范的必然结果:undefined因json标准不支持而被跳过,symbol因键非字符串且不可枚举而彻底隐身;需改用reflect.ownkeys递归克隆或structuredclone等方案。

为什么 json 深拷贝会忽略 undefined 和 symbol 属性?

JSON 深拷贝(即 JSON.parse(JSON.stringify(obj)))忽略 undefined 和 Symbol 属性,不是实现有误,而是严格遵循 JSON 规范与 JavaScript 引擎行为的必然结果。

undefined 被跳过,因为 JSON 标准不支持它

JSON 规范(RFC 8259 / ECMA-404)只定义六种合法类型:字符串、数字、布尔值、null、数组、对象。它**明确排除 undefined**——既不能作为值,也不能作为键名。

  • 在对象中:{ a: undefined } 的 a 属性会被整个忽略,不进入序列化流程
  • 在数组中:[1, undefined, 3] 会变成 [1, null, 3](这是唯一“降级”场景)
  • 顶层值为 undefined 时:JSON.stringify(undefined) 返回 undefined,紧接着 JSON.parse(undefined) 直接报错

Symbol 属性彻底隐身,连“被过滤”的机会都没有

Symbol 键和值在 JSON.stringify 中是“零存在感”,原因有两层硬限制:

dmap-jsapi-skill
dmap-jsapi-skill

DMap GL地图JSAPI(dmapgl)开发指南。用于编写、审查、调试 DMap 地图 API 代码,涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。

下载
  • 语法层面不合法:JSON 要求所有键必须是字符串,而 Symbol 是 JS 独有原始类型,无法转成合法 JSON 键
  • 遍历阶段就被跳过:引擎内部使用类似 Object.keys() 或 for...in 遍历属性,而 Symbol 属性默认不可枚举;即使设为可枚举,也因非字符串键被直接拒之门外
  • 值位置也不保留:如 { x: Symbol('id') },stringify 对该值做类型检查后直接返回 undefined,进而导致整条键值对被剔除

这不是 bug,而是设计边界清晰的体现

JSON.stringify 的目标从来不是“完整复制 JS 对象”,而是生成符合 JSON 标准的文本。它不负责保真、不处理语义歧义、不尝试降级转换。

  • 它把 undefined 当作“无意义字段”直接省略,而非“空值占位”
  • 它对 Symbol 连判断逻辑都不触发——没有 replacer 回调、没有警告、没有 fallback
  • 这种确定性行为反而让开发者能预判结果,避免隐式错误

想保留它们?得绕开 JSON 流程

若业务需要保留 undefined 或 Symbol,必须放弃 JSON.parse/stringify,改用可控方案:

  • 手动递归克隆:用 Reflect.ownKeys() 获取全部键(含不可枚举和 Symbol),逐个赋值,显式处理 undefined
  • 预处理映射:序列化前将 Symbol 键转为带前缀的字符串(如 $$sym_id),反序列化后再还原
  • 现代替代方案:浏览器可用 structuredClone()(原生支持 Symbol、undefined、Date 等,但不支持函数和循环引用)

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

json undefined js

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2135

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

3242

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

1096

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

3699

7

undefined是什么
undefined是什么

undefined是代表一个值或变量不存在或未定义的状态。它可以作为默认值来判断一个变量是否已经被赋值,也可以用于设置默认参数值。尽管在不同的编程语言中,undefined可能具有不同的含义和用法,但理解undefined的概念可以帮助我们更好地理解和编写程序。本专题为大家提供undefined相关的各种文章、以及下载和课程。

2023.07.31

11705

4

网页undefined是什么意思
网页undefined是什么意思

网页undefined是指页面出现了未知错误的意思,提示undefined一般是在开发网站的时候定义不正确或是转换不正确,或是找不到定义才会提示undefined未定义这个错误。想了解更多的相关内容,可以阅读本专题下面的文章。

2024.08.14

5507

7

网页undefined啥意思
网页undefined啥意思

本专题整合了undefined相关内容,阅读下面的文章了解更多详细内容。后续继续更新。

2025.12.25

2516

7

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

2026.10.16

60

10

OpenJDK怎么配置Java开发环境
OpenJDK怎么配置Java开发环境

怎样用OpenJDK搭建开发环境?本专题介绍版本选择、下载安装、环境变量配置和编译运行验证,帮助你理清JDK的作用及基本配置流程,并通过简单程序检查环境是否可用,为后续项目开发做好准备。

2026.10.16

20

10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程