1. 概述
ES5的对象属性名都是字符串,这容易造成属性名的冲突,如果有一种机制,保证每个属性的名字都是独一无二的就好,这样就从根本上防止属性名的冲突,这就是 ES6 引入 Symbol 的原因
ES6 引入了一种新的原始数据类型 Symbol,表示独一无二的值,它是 JS 语言的第七种数据类型
Symbol 值通过Symbol函数生成。这就是说,对象的属性名现在可以有两种类型,一种是原来就有的字符串,另一种就是新增的 Symbol 类型。凡是属性名属于 Symbol 类型,就都是独一无二的,可以保证不会与其他属性名产生冲突
let s = Symbol()
typeof s // 'symbol'
注意:Symbol 函数前不能使用new命令,否则会报错。这是因为生成的 Symbol 是一个原始类型的值,不是对象。也就是说,由于 Symbol 值不是对象,所以不能添加属性。基本上,它是一种类似于字符串的数据类型。
Symbol函数可以接受一个字符串作为参数,表示对 Symbol 实例的描述,主要是为了在控制台显示,或者转为字符串时,比较容易区分。
let s1 = Symbol('foo');
let s2 = Symbol('bar');
s1 // Symbol(foo)
s2 // Symbol(bar)
如果 Symbol() 的参数是一个对象,就会调用该对象的 toString() 方法,将其转为字符串,然后才生成一个 Symbol 值
const obj = {
toString() {
return 'abc'
}
}
const sym = Symbol(obj);
sym // Symbol(abc)
注意:Symbol 函数的参数只是表示对当前 Symbol 值的描述,因此相同参数的 Symbol 函数的返回值是不相等的
// 没有参数的情况
let s1 = Symbol();
let s2 = Symbol();
s1 === s2 // false
// 有参数的情况
let s1 = Symbol('foo');
let s2 = Symbol('foo');
s1 === s2 // false
Symbol 值不能与其他类型的值进行运算,会报错
let sym = Symbol('my symbol');
'your symbol is ' + sym
// TypeError: cant not convert symbol to string
但是,symbol值可以显示转为字符串
let sym = Symbol('My symbol');
String(sym) // 'Symbol(My symbol)'
另外,Symbol 值也可以转为布尔值,但是不能转为数值
let sym = Symbol();
Boolean(sym) // true
!sym // false
2. 作为属性名的 Symbol
由于每一个 Symbol 值都是不相等的,这意味着 Symbol 值可以作为标识符,用于对象的属性名,就能保证不会出现同名的属性。这对于一个对象由多个模块构成的情况非常有用,能防止某一个键被不小心改写或覆盖
let mySymbol = Symbol();
// 第一种写法
let a = {};
a[mySymbol] = 'Hello';
// 第二种写法
let a = {
[mySymbol]: 'Hello'
};
// 第三种写法
let a = {};
Object.defineProperty(a, mySymbol, {
value: 'Hello'
});
// 以上写法都得到同样的结果
a[mySymbol] = 'Hello'
注意,Symbol值作为对象属性名时,不能用点运算符
const mySymbol = Symbol();
const a = {};
a.mySymbol = 'Hello';
a[mySymbol] // undefined
a['mySymbol'] // 'Hello'
上面代码中,因为点运算符后面总是字符串,所以不会读取mySymbol作为标识名所指代的那个值,导致a的属性名实际上是一个字符串,而不是一个 Symbol 值
Symbol类型还可以用于定义一组常量,保证这组常量的值都是不相等的。
log.levels = {
DEBUG: Symbol('debug'),
INFO: Symbol('info'),
WARN: Symbol('warn')
}
3. 实例:消除魔术字符串
魔术字符串指的是,在代码之中多次出现,与代码形成强耦合的某一个具体的字符串或者数值。
4. 属性名的遍历
Symbol作为属性名,该属性不会出现在 for...in,for...of循环中,也不会被
Object.keys()、
Object.getOwnPropertyNames()、
JSON.stringify()
返回。但是,它也不是私有属性,有一个 Object.getOwnPropertySymbols 方法,可以获取指定对象的所有 Symbol 属性名
Object.getOwnPropertySymbols 方法返回一个数组,成员是当前对象的所有用作属性名的 Symbol 值
const obj = {};
let a = Symbol('a');
let b = Symbol('b');
obj[a] = 'Hello';
obj[b] = 'World';
const objectSymbols = Object.getOwnPropertySymbols(obj);
objectSymbols
// [Symbol(a), Symbol(b)]
另一个新的 API,Reflect.ownKeys 可以返回所有类型的键名,包括常规键名和Symbol键名
let obj = {
[Symbol('my_key')]: 1,
enum: 2,
nonEnum: 3
};
Reflect.ownKeys(obj)
// ["enum", "nonEnum", Symbol(my_key)]
由于以 Symbol 值作为名称的属性,不会被常规方法遍历得到。我们可以利用这个特性,为对象定义一些非私有的、但又希望只用于内部的方法。
5. Symbol.for()、Symbol.keyFor()
有时,我们希望重新使用同一个 Symbol 值,Symbol.for 可以做到这一点。它接受一个字符串作为参数,然后搜索有没有以该参数作为名称的 Symbol 的值。如果有,就返回这个 Symbol 值,否则就新建并返回一个以该字符串为名称的 Symbol 值
let s1 = Symbol.for('foo');
let s2 = Symbol.for('foo');
s1 === s2 // true
Symbol.for() 和 Symbol() 这两种写法,都会生成新的 Symbol,它们的区别是,前者会被登记在全局环境中供搜索,后者不会。
Symbol.for() 不会每次调用就返回一个新的 Symbol 类型的值,而是先检查给定的 key 是否已经存在,如果不存在才会新建一个值。
如果你调用Symbol.for("cat")30 次,每次都会返回同一个 Symbol 值,但是调用Symbol("cat")30 次,会返回 30 个不同的 Symbol 值。
Symbol.for('bar') === Symbol.for('bar') // true
Symbol('bar') === Symbol('bar') // false
Symbol.keyFor() 返回一个已登记的 Symbol 类型值得 key
let s1 = Symbol.for('foo');
Symbol.keyFor(s1) // 'for'
let s2 = Symbol('foo');
Symbol.keyFor(s2) // undefined
6. 实例,模块的 Singleton 模式
Singleton 模式指的是调用一个类,任何时候返回的都是同一个实例。
7. 内置的 Symbol 值
除了定义自己使用的 Symbok 值以外,ES6 还提供了 11 个内置的 Symbol 值,指向语言内部使用的方法。
(1) Symbol.hasInstance
对象的Symbol.hasInstance属性,指向一个内部方法。当其他对象使用instanceof运算符,判断是否为该对象的实例时,会调用这个方法。比如,foo instanceof Foo在语言内部,实际调用的是FooSymbol.hasInstance。
(2) Symbol.isConcatSpreadable
对象的 Symbol.isConcatSpreadable 属性等于一个布尔值,表示该对象用于 Array.prototype.concat() 时,是否可以展开。
let arr1 = ['c', 'd'];
['a', 'b'].concat(arr1, 'e') // ['a', 'b', 'c', 'd', 'e']
let arr2 = ['c', 'd'];
arr2[Symbol.isConcatSpreadable] = false;
console.log(['a', 'b'].concat(arr2, 'e')) // ['a', 'b', ['c','d'], 'e']
默认数组是展开的,设置了 arr2[Symbol.isConcatSpreadable] = false 之后,将不会展开。
对象则正好相反,默认不展开。它的 Symbol.isConcatSpreadable] 属性设为true,才可以展开。
let obj = {length: 2, 0: 'c', 1: 'd'};
['a', 'b'].concat(obj, 'e') // ['a', 'b', obj, 'e']
obj[Symbol.isConcatSpreadable] = true;
['a', 'b'].concat(obj, 'e') // ['a', 'b', 'c', 'd', 'e']
(3) Symbol.species
对象的 Symbol.species 属性,指向一个构造函数,创建衍生对象时,会使用该属性
(4) Symbol.match
对象的Symbol.match属性,指向一个函数。当执行str.match(myObject)时,如果该属性存在,会调用它,返回该方法的返回值
(5) Symbol.replace
对象的Symbol.replace属性,指向一个方法,当该对象被String.prototype.replace方法调用时,会返回该方法的返回值
(6) Symbol.search
对象的Symbol.search属性,指向一个方法,当该对象被String.prototype.search方法调用时,会返回该方法的返回值
(7) Symbol.split
对象的Symbol.split属性,指向一个方法,当该对象被String.prototype.split方法调用时,会返回该方法的返回值
(8) Symbol.iterator
对象的 Symbol.iterator 属性,指向该对象的默认遍历器方法
(9) Symbol.toPrimitive
对象的Symbol.toPrimitive属性,指向一个方法。该对象被转为原始类型的值时,会调用这个方法,返回该对象对应的原始类型值
(10) Symbol.toStringTag
对象的Symbol.toStringTag属性,指向一个方法。在该对象上面调用Object.prototype.toString方法时,如果这个属性存在,它的返回值会出现在toString方法返回的字符串之中,表示对象的类型。也就是说,这个属性可以用来定制[object Object]或[object Array]中object后面的那个字符串
(11) Symbol.unscopables
对象的Symbol.unscopables属性,指向一个对象。该对象指定了使用with关键字时,哪些属性会被with环境排除