Skip to main content
Version: 3.28.0

Symbol.for()

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.

Syntax​

Symbol.for(key)

Parameters​

  • key
    • : String, required. The key for the symbol (and also used for the description of the symbol).

Return value​

An existing symbol with the given key if found; otherwise, a new symbol is created and returned.

Description​

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.