在线文档教程

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 nameValue
[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'

规范

SpecificationStatusComment
ECMAScript 2015 (6th Edition, ECMA-262)The definition of 'Symbol.for' in that specification.StandardInitial definition.
ECMAScript Latest Draft (ECMA-262)The definition of 'Symbol.for' in that specification.Living Standard

浏览器兼容性

FeatureChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support40(Yes)36.0 (36.0)No supportNo support9

FeatureAndroidChrome for AndroidEdgeFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic supportNo supportNo support(Yes)36.0 (36.0)No supportNo supportNo support