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

如何理解 Symbol 属性拷贝:为什么 JSON 方法会静默丢弃所有的 Symbol 键名

风明小哥_4054

风明小哥_4054

发布时间:2026-05-03 11:01:36

|

452人浏览过

|

来源于php中文网

原创

Symbol属性在JSON序列化中被完全忽略,因JSON标准(RFC 8259)仅支持七种类型且要求对象键必须为字符串,而Symbol是JavaScript独有的不可枚举非字符串类型,既不进入遍历队列也不触发replacer回调。

如何理解 symbol 属性拷贝:为什么 json 方法会静默丢弃所有的 symbol 键名

Symbol 属性在 JSON 序列化中被完全忽略,不是因为实现疏漏,而是由 JSON 标准本身决定的——它根本不支持 Symbol 类型。

JSON 规范不承认 Symbol

JSON(RFC 8259)只定义了七种合法数据类型:null、布尔值、数字、字符串、数组、对象、以及 null(重复强调是因对象键必须为字符串)。Symbol 是 JavaScript 引入的原始类型,用于创建唯一、不可枚举(默认)且非字符串的键名,天然超出 JSON 能表达的范围。因此,JSON.stringify() 在遍历对象属性时,根本不会把 Symbol 键纳入处理队列——连“丢弃”的动作都谈不上,是直接跳过。

Browser Js
Browser Js

轻量级CDP浏览器控制,适用于AI代理。相较于内置浏览器工具,token消耗降低3‑10倍,仅在浏览时使用。

下载

Symbol 键不会进入 replacer 回调

即使你传入 replacer 函数试图干预,它也收不到 Symbol 键的信息。这是因为 JSON.stringify() 的内部遍历逻辑只枚举对象上可枚举的字符串键属性(等价于 for...in + hasOwnProperty + typeof key === 'string'),而 Symbol 键既不可枚举(除非显式用 Object.defineProperty 设为 enumerable: true),又不是字符串,所以 replacer 完全感知不到它们的存在。

Symbol 值同样被静默过滤

  • 如果 Symbol 作为属性值(如 { x: Symbol('id') }),该属性会被整个忽略,结果变成 {}
  • 如果 Symbol 出现在数组中(如 [1, Symbol('a'), 3]),对应位置会转为 null(注意:这是值的处理,和键不同)
  • undefined 和函数值也按类似逻辑被剔除或转 null,但 Symbol 键的“隐身”是最彻底的——连痕迹都不留

想保留 Symbol 语义?得绕开 JSON

没有通用的自动方案。常见做法包括:

  • 序列化前手动提取 Symbol 键,用其 description 构造字符串键暂存(例如 { $$sym_b: 2 }),反序列化后再还原
  • 在对象上定义 toJSON() 方法,预先将 Symbol 相关数据映射为 JSON 可表达的结构
  • 改用其他序列化机制,如 structuredClone()(支持 Symbol,但不支持函数、循环引用等)、MessageChannel(浏览器环境)、或自研二进制/文本协议

热门AI工具

更多
WorkBuddy

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

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

豆包大模型

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

DeepSeek

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

讯飞智作

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

Laper
Laper Hot

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

UpDream
UpDream Hot

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

墨刀AI
墨刀AI Hot

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

相关专题

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

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

2035

2023.08.07

json是什么
json是什么

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

2962

2023.08.23

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

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

1016

2023.10.13

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

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

3339

2025.09.10

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

120

2026.09.30

LLVM RISC-V参数配置教程
LLVM RISC-V参数配置教程

本专题介绍LLVM对RISC-V基础ISA和扩展的支持方式,涵盖RV32、RV64、标准扩展、实验性扩展、厂商扩展、-menable-experimental-extensions和版本差异。

100

2026.09.30

LLVM IR中间表示入门指南
LLVM IR中间表示入门指南

本专题整理LLVM IR的核心概念,包括中间表示作用、模块结构、函数、基本块、SSA形式、类型系统和常见语法,帮助新手理解LLVM编译流程中的关键层。

80

2026.09.30

PDF转图片方法
PDF转图片方法

需要把 PDF 页面用于上传、预览、分享或图片归档时,PDF 转图片方法专题整理 JPG/PNG 格式选择、逐页导出、清晰度设置、批量下载和结果检查等流程,帮助用户稳定完成 PDF 图片化处理。

60

2026.09.30

PixTV AI视频生成与无限画布创作
PixTV AI视频生成与无限画布创作

PixTV专题整理AI视频与视觉内容创作相关功能使用教程,涵盖AI生图、视频生成、无限画布、多模型创作、素材管理、声音音乐及视频剪辑等功能,帮助用户快速掌握PixTV从创意到成片的完整制作方法。

80

2026.09.29

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 20.8万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 4.8万人学习

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

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