Symbol.for
Symbol.for
Symbol.for(key)
方法会根据给定的键 key
,来从运行时的 symbol 注册表中找到对应的 symbol,如果找到了,则返回它,否则,新建一个与该键关联的 symbol,并放入全局 symbol 注册表中。
语法
Symbol.for(key
参数
key一个字符串,作为 symbol 注册表中与某 symbol 关联的键(同时也会作为该 symbol 的描述)。
返回值
返回由给定的 key 找到的 symbol,否则就是返回新创建的 symbol。
描述
和 Symbol()
不同的是,用 Symbol.for()
方法创建的的 symbol 会被放入一个全局 symbol 注册表中。Symbol.for() 并不是每次都会创建一个新的 symbol
,它会首先检查给定的 key 是否已经在注册表中了。假如是,则会直接返回上次存储的那个。否则,它会再新建一个。
全局 symbol 注册表
symbol 注册表中的记录结构:
Field name | Value |
---|---|
[key] | A string key used to identify a symbol. |
[symbol] | A symbol that is stored globally. |
示例
Symbol.for('foo' // create a new global symbol
Symbol.for('foo' // retrieve the already created symbol
// Same global symbol, but not locally
Symbol.for('bar') === Symbol.for('bar' // true
Symbol('bar') === Symbol('bar' // false
// The key is also used as the description
var sym = Symbol.for('mario'
sym.toString( // "Symbol(mario)"
为了防止冲突,最好给你要放入 symbol 注册表中的 symbol 带上键前缀。
Symbol.for('mdn.foo'
Symbol.for('mdn.bar'
规范
Specification | Status | Comment |
---|---|---|
ECMAScript 2015 (6th Edition, ECMA-262)The definition of 'Symbol.for' in that specification. | Standard | Initial definition. |
ECMAScript Latest Draft (ECMA-262)The definition of 'Symbol.for' in that specification. | Living Standard | |
浏览器兼容性
Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic support | 40 | (Yes) | 36.0 (36.0) | No support | No support | 9 |
Feature | Android | Chrome for Android | Edge | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|---|
Basic support | No support | No support | (Yes) | 36.0 (36.0) | No support | No support | No support |