Symbol是JavaScript的原始类型,用于创建唯一值,常作对象属性键以避免命名冲突。

Symbol 是 JavaScript 中的一种原始数据类型,用来创建唯一的值。它常用于对象属性的键名,避免属性名冲突。Symbol 的最大特点就是唯一性——即使两个 Symbol 的描述相同,它们也不相等。
Symbol 的基本使用
通过 Symbol() 函数可以创建一个 Symbol 值:
const sym1 = Symbol();const sym2 = Symbol('description');
console.log(sym1 === sym2); // false
每个 Symbol 值都是独一无二的,即便传入相同的描述字符串,也不会影响其唯一性。
用作对象属性的键
Symbol 最常见的用途是作为对象属性的键,防止命名冲突:
立即学习“Java免费学习笔记(深入)”;
const id = Symbol('id');const user = {
name: 'Alice',
[id]: 12345
};
console.log(user[id]); // 12345
这个 id 属性不会被常规遍历(如 for...in、Object.keys())访问到,增强了私密性。
防止属性覆盖
在多人协作或使用第三方库时,可能会不小心覆盖已有属性。Symbol 能有效避免这个问题:
const COLOR = Symbol('color');
const config = {
[COLOR]: 'blue'
};
// 自己的代码中也想加 color,但不想冲突
config['color'] = 'red'; // 不影响 Symbol(COLOR)
console.log(config[COLOR]); // blue
普通字符串键和 Symbol 键互不干扰,保障了原有逻辑不受影响。
获取 Symbol 属性的方法
虽然 Symbol 属性默认不可枚举,但可以通过特定方法获取:
- Object.getOwnPropertySymbols(obj):返回对象中所有 Symbol 类型的键
- Reflect.ownKeys(obj):返回所有键,包括字符串和 Symbol
const obj = { [mySym]: 'hello', prop: 'world' };
console.log(Object.getOwnPropertySymbols(obj)); // [Symbol(test)]
console.log(Reflect.ownKeys(obj)); // ['prop', Symbol(test)]
全局共享的 Symbol:Symbol.for()
如果希望多个地方使用同一个 Symbol,可以用 Symbol.for(key) 在全局注册表中查找或创建:
const s1 = Symbol.for('shared');const s2 = Symbol.for('shared');
console.log(s1 === s2); // true
它们基于“键名”共享,适合跨模块通信。对应的 Symbol.keyFor(sym) 可反向查询全局 Symbol 的键名。
内置 Symbol 值的应用
JavaScript 提供了一些以 Symbol.xxx 形式存在的内置 Symbol,用于自定义语言行为:
- Symbol.iterator:定义对象的默认迭代器,使其可被 for...of 遍历
- Symbol.toStringTag:控制 Object.prototype.toString 的返回结果
- Symbol.hasInstance:自定义 instanceof 的判断逻辑
[Symbol.iterator]() {
let i = 0;
return {
next() {
return i }
};
}
};
for (const n of collection) {
console.log(n); // 0, 1, 2
}
基本上就这些。Symbol 看似小众,但在避免命名冲突、实现高级抽象和定制对象行为方面非常有用。合理使用能让代码更健壮、更清晰。










