Symbol 是 JavaScript 中用于创建唯一、不可变值的原始类型,专为解决属性名冲突和实现私有键设计,具备唯一性、不可枚举性,支持全局注册(Symbol.for)及内置协议钩子(如 Symbol.iterator)。

Symbol 是 JavaScript 中一种原始数据类型,用来创建唯一、不可变的值,主要解决对象属性名冲突问题。 它不是“新字符串”,也不是“高级常量”,而是一种专门设计用来当“私有键”或“防碰撞标识”的底层工具。
Symbol 的核心特点:唯一性与不可枚举性
每次调用 Symbol() 都会返回一个全新的、与其他所有 Symbol 值不相等的值(即使描述相同):
例:Symbol('foo') === Symbol('foo') // falseconst s1 = Symbol('id'); const s2 = Symbol('id'); s1 === s2 // false
Symbol 作为对象属性键时,默认不会出现在 for...in、Object.keys()、JSON.stringify() 等遍历或序列化操作中——它天然“隐身”,适合做内部标记。
用作对象的“私有属性名”,避免命名冲突
当你在库、插件或多人协作中往别人对象上加属性,又不想覆盖已有属性或被别人覆盖时,Symbol 是最稳妥的选择:
立即学习“Java免费学习笔记(深入)”;
- 给数组添加自定义迭代行为,不影响原生方法:
arr[Symbol.iterator] = myCustomIterator - 为类实例添加内部状态字段:
const _cache = Symbol('cache'); this[_cache] = new Map() - 第三方库挂载元信息:
obj[Symbol.for('my-lib:version')] = '2.1.0'
全局 Symbol 注册表:Symbol.for() 和 Symbol.keyFor()
普通 Symbol() 每次都新建,但 Symbol.for(key) 会先查全局注册表——相同字符串 key 返回同一个 Symbol:
标签: nodejs javascript java js json node 工具 注册表
还木有评论哦,快来抢沙发吧~