The Symbol.for(key)
method searches for existing symbols in a runtime-wide symbol registry with the given key and returns it if found. Otherwise a new symbol gets created in the global symbol registry with this key.
Symbol.for(key);
An existing symbol with the given key if found; otherwise, a new symbol is created and returned.
In contrast to Symbol()
, the Symbol.for()
function creates a symbol available in a global symbol registry list. Symbol.for()
does also not necessarily create a new symbol on every call, but checks first if a symbol with the given key
is already present in the registry. In that case, that symbol is returned. If no symbol with the given key is found, Symbol.for()
will create a new global symbol.
The global symbol registry is a list with the following record structure and it is initialized empty:
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)"
To avoid name clashes with your global symbol keys and other (library code) global symbols, it might be a good idea to prefix your symbols:
Symbol.for('mdn.foo'); Symbol.for('mdn.bar');
Desktop | ||||||
---|---|---|---|---|---|---|
for |
40 | 12 | 36 | No | 27 | 9 |
Mobile | ||||||
---|---|---|---|---|---|---|
for |
40 | 40 | 36 | 27 | 9 | 4.0 |
Server | |
---|---|
for |
0.12 |
© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://wiki.developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol/for