赞
踩
symbol 是一种基本数据类型 (primitive data type)。Symbol()
函数会返回symbol类型的值,该类型具有静态属性和静态方法。它的静态属性会暴露几个内建的成员对象;它的静态方法会暴露全局的symbol注册,且类似于内建对象类,但作为构造函数来说它并不完整,因为它不支持语法:"new Symbol()
"。
1 每个从Symbol()
返回的symbol值都是唯一的。一个symbol值能作为对象属性的标识符;这是该数据类型仅有的目的
也就是说每一个Symbol的值都是不同的
- const symbol1 = Symbol();
- const symbol2 = Symbol('foo');
- const symbol3 = Symbol('foo');
-
- console.log(typeof symbol1);
- // expected output: "symbol"
-
- console.log(symbol2 === 42);
- // expected output: false
-
- console.log(symbol3.toString());
- // expected output: "Symbol(foo)"
-
- console.log(Symbol('foo') === Symbol('foo'));
- // expected output: false
-
- let copyValue1 = 2
- let copyValue2 = 2
- console.log(copyValue1,copyValue2,Symbol('foo'),Symbol('foo'),copyValue1==copyValue2,symbol2==symbol3)
- //2 2 Symbol(foo) Symbol(foo) true false

上面的代码创建了三个新的symbol类型。 注意,Symbol("foo")
不会强制将字符串 “foo” 转换成symbol类型。它每次都会创建一个新的 symbol类型:
上面使用Symbol()
函数的语法,不会在你的整个代码库中创建一个可用的全局的symbol类型。 要创建跨文件可用的symbol,甚至跨域(每个都有它自己的全局作用域) , 使用 Symbol.for()
方法和 Symbol.keyFor()
方法从全局的symbol注册表设置和取得symbol。
Object.getOwnPropertySymbols()
方法让你在查找一个给定对象的符号属性时返回一个symbol类型的数组。注意,每个初始化的对象都是没有自己的symbol属性的,因此这个数组可能为空,除非你已经在对象上设置了symbol属性。
当一个 Symbol 包装器对象作为一个属性的键时,这个对象将被强制转换为它包装过的 symbol 值:
- var sym = Symbol("foo");
- var obj = {[sym]: 1};
- obj[sym]; // 1
- obj[Object(sym)]; // still 1
typeof
运算符能帮助你识别 symbol 类型
- typeof Symbol() === 'symbol'
- typeof Symbol('foo') === 'symbol'
- typeof Symbol.iterator === 'symbol'
当使用 symbol 值进行类型转换时需要注意一些事情:
TypeError
错误 (e.g. +sym
or sym | 0
).Object(sym) == sym
returns true.
Symbol("foo") + "bar" 将抛出一个
TypeError
(can't convert symbol to string).String(sym)
conversion 的作用会像symbol类型调用 Symbol.prototype.toString()
一样,但是注意 new String(sym)
将抛出异常。for...in
迭代Symbols 在 for...in
迭代中不可枚举。另外,Object.getOwnPropertyNames()
不会返回 symbol 对象的属性,但是你能使用 Object.getOwnPropertySymbols()
得到它们。
- var obj = {};
-
- obj[Symbol("a")] = "a";
- obj[Symbol.for("b")] = "b";
- obj["c"] = "c";
- obj.d = "d";
-
- for (var i in obj) {
- console.log(i); // logs "c" and "d"
- }
JSON.stringify()
当使用 JSON.stringify() 时,以 symbol 值作为键的属性会被完全忽略:
- JSON.stringify({[Symbol("foo")]: "foo"});
- // '{}'
更多细节,请看 JSON.stringify()
。
在这之前,我们通常定义或访问对象的属性时都是使用字符串,比如下面的代码:
- let obj = {
- abc: 123,
- "hello": "world"
- }
-
- obj["abc"] // 123
- obj["hello"] // 'world'
而现在,Symbol
可同样用于对象属性的定义和访问:
- const PROP_NAME = Symbol()
- const PROP_AGE = Symbol()
-
- let obj = {
- [PROP_NAME]: "一斤代码"
- }
- obj[PROP_AGE] = 18
-
- obj[PROP_NAME] // '一斤代码'
- obj[PROP_AGE] // 18
随之而来的是另一个非常值得注意的问题:就是当使用了Symbol作为对象的属性key后,在对该对象进行key的枚举时,会有什么不同?在实际应用中,我们经常会需要使用Object.keys()
或者for...in
来枚举对象的属性名,那在这方面,Symbol类型的key表现的会有什么不同之处呢?来看以下示例代码:
- let obj = {
- [Symbol('name')]: '一斤代码',
- age: 18,
- title: 'Engineer'
- }
-
- Object.keys(obj) // ['age', 'title']
-
- for (let p in obj) {
- console.log(p) // 分别会输出:'age' 和 'title'
- }
-
- Object.getOwnPropertyNames(obj) // ['age', 'title']
由上代码可知,Symbol类型的key是不能通过Object.keys()
或者for...in
来枚举的,它未被包含在对象自身的属性名集合(property names)之中。所以,利用该特性,我们可以把一些不需要对外操作和访问的属性使用Symbol来定义。
也正因为这样一个特性,当使用JSON.stringify()
将对象转换成JSON字符串的时候,Symbol属性也会被排除在输出内容之外:
JSON.stringify(obj) // {"age":18,"title":"Engineer"}
我们可以利用这一特点来更好的设计我们的数据对象,让“对内操作”和“对外选择性输出”变得更加优雅。
然而,这样的话,我们就没办法获取以Symbol方式定义的对象属性了么?非也。还是会有一些专门针对Symbol的API,比如:
- // 使用Object的API
- Object.getOwnPropertySymbols(obj) // [Symbol(name)]
-
- // 使用新增的反射API
- Reflect.ownKeys(obj) // [Symbol(name), 'age', 'title']
先来看一下下面的代码,是不是在你的代码里经常会出现?
- const TYPE_AUDIO = 'AUDIO'
- const TYPE_VIDEO = 'VIDEO'
- const TYPE_IMAGE = 'IMAGE'
-
- function handleFileResource(resource) {
- switch(resource.type) {
- case TYPE_AUDIO:
- playAudio(resource)
- break
- case TYPE_VIDEO:
- playVideo(resource)
- break
- case TYPE_IMAGE:
- previewImage(resource)
- break
- default:
- throw new Error('Unknown type of resource')
- }
- }

如上面的代码中那样,我们经常定义一组常量来代表一种业务逻辑下的几个不同类型,我们通常希望这几个常量之间是唯一的关系,为了保证这一点,我们需要为常量赋一个唯一的值(比如这里的'AUDIO'、'VIDEO'、 'IMAGE'),常量少的时候还算好,但是常量一多,你可能还得花点脑子好好为他们取个好点的名字。
现在有了Symbol
,我们大可不必这么麻烦了:
const TYPE_AUDIO = Symbol()
const TYPE_VIDEO = Symbol()
const TYPE_IMAGE = Symbol()
这样定义,直接就保证了三个常量的值是唯一的了!是不是挺方便的呢。
应用场景3:使用Symbol定义类的私有属性/方法
我们知道在JavaScript中,是没有如Java等面向对象语言的访问控制关键字private
的,类上所有定义的属性或方法都是可公开访问的。因此这对我们进行API的设计时造成了一些困扰。
而有了Symbol
以及模块化机制
,类的私有属性和方法才变成可能。例如:
- const PASSWORD = Symbol()
-
- class Login {
- constructor(username, password) {
- this.username = username
- this[PASSWORD] = password
- }
-
- checkPassword(pwd) {
- return this[PASSWORD] === pwd
- }
- }
-
- export default Login
- import Login from './a'
-
- const login = new Login('admin', '123456')
-
- login.checkPassword('admin') // true
-
- login.PASSWORD // oh!no!
- login[PASSWORD] // oh!no!
- login["PASSWORD"] // oh!no!
由于Symbol常量PASSWORD
被定义在a.js所在的模块中,外面的模块获取不到这个Symbol,也不可能再创建一个一模一样的Symbol出来(因为Symbol是唯一的),因此这个PASSWORD
的Symbol只能被限制在a.js内部使用,所以使用它来定义的类属性是没有办法被模块外访问到的,达到了一个私有化的效果。
参考文档
【2】https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Symbol#规范
Copyright © 2003-2013 www.wpsshop.cn 版权所有,并保留所有权利。