Symbol是ES6引入的唯一值原始类型,用于避免属性冲突、定义唯一常量及自定义对象行为,如通过Symbol.iterator实现迭代。

Symbol 是 ES6 引入的一种原始数据类型,表示独一无二的值。JavaScript 中的七种基本数据类型包括:Number、String、Boolean、Null、Undefined、Object 和 Symbol。Symbol 的主要特点是每次创建的值都是唯一的,即使参数相同,也不会相等。
Symbol 的基本用法
使用 Symbol() 函数创建一个 Symbol 值:
const sym1 = Symbol();const sym2 = Symbol();
console.log(sym1 === sym2); // false
可以传入一个字符串作为描述,便于调试:
const symA = Symbol('apple');const symB = Symbol('apple');
console.log(symA.description); // "apple"
console.log(symA === symB); // false
注意:Symbol 值不能与其他类型进行隐式转换,但可通过 .toString() 或 .description 获取描述信息。
立即学习“Java免费学习笔记(深入)”;
Symbol 的应用场景
Symbol 的唯一性和不可枚举性使其在多个场景中非常有用:
1. 避免属性名冲突
当为对象添加“私有”属性时,使用 Symbol 可防止命名冲突,尤其在扩展第三方对象或库时:
const user = {
name: 'Alice',
[UID]: '12345'
};
console.log(user[UID]); // '12345'
这个 UID 属性不会被常规遍历方法(如 for...in)读取,避免干扰原有逻辑。
2. 定义常量和枚举值
使用 Symbol 定义一组互不相等的状态或类型,确保不会误判:
PENDING: Symbol('pending'),
FULFILLED: Symbol('fulfilled'),
REJECTED: Symbol('rejected')
};
if (status === STATUS.PENDING) { ... }
相比字符串常量,Symbol 能杜绝因拼写错误导致的判断失败。
3. 使用内置 Symbol 值干预语言行为
ES6 提供了一些以 Symbol.xxx 形式存在的内置符号,用于自定义对象的行为:
- Symbol.iterator:使对象可被 for...of 遍历
- Symbol.toStringTag:控制 Object.prototype.toString 的返回标签
- Symbol.hasInstance:自定义 instanceof 的判断逻辑
示例:让对象支持迭代
const myIterable = {[Symbol.iterator]() {
let step = 0;
return {
next() {
if (step return { value: ++step, done: false };
}
return { done: true };
}
}
}
}
};
for (const val of myIterable) {
console.log(val); // 1, 2, 3
}
Symbol 的特性与注意事项
- Symbol 值作为对象属性时,不会出现在 for...in、for...of 中,也不会被 Object.keys()、Object.getOwnPropertyNames() 返回
- 可通过 Object.getOwnPropertySymbols() 获取所有 Symbol 属性
- 使用 Reflect.ownKeys() 可获取包括 Symbol 在内的所有自身属性键
- Symbol 不会被 JSON.stringify() 序列化
- 全局共享 Symbol:使用 Symbol.for(key) 在全局注册并复用 Symbol
例如:
const s1 = Symbol.for('shared');const s2 = Symbol.for('shared');
console.log(s1 === s2); // true
基本上就这些。Symbol 虽不常直接暴露在业务代码中,但在设计库、框架或需要精细控制对象行为时非常关键。理解其唯一性和元编程能力,能写出更安全、更灵活的 JavaScript 代码。










