讲师中心 微信公众号
AI工具推荐 视频效率加速

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

千敏酱_8097

千敏酱_8097

发布时间:2026-06-13 17:07:00

|

568人浏览过

|

来源于php中文网

原创

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 等,但不支持函数和循环引用)

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

相关专题

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

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

2135

2023.08.07

json是什么
json是什么

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

3242

2023.08.23

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

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

1096

2023.10.13

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

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

3699

2025.09.10

undefined是什么
undefined是什么

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

11705

2023.07.31

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

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

5507

2024.08.14

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

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

2516

2025.12.25

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

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

20

2026.10.16

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

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

20

2026.10.16

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn