Symbol.for()

key

String, obligatoria. La clave del símbolo (y también se utiliza para la descripción del símbolo).

Un símbolo existente con la clave dada si se encuentra; en caso contrario, se crea un nuevo símbolo y se devuelve.

A diferencia de Symbol(), la función Symbol.for() crea un símbolo disponible en una lista global de registro de símbolos. Además, Symbol.for() no crea necesariamente un nuevo símbolo en cada llamada, sino que comprueba primero si un símbolo con la key dada ya está presente en el registro. En ese caso, se devuelve ese símbolo. Si no se encuentra ningún símbolo con la clave dada, Symbol.for() creará un nuevo símbolo global.

El registro global de símbolos es una lista con la siguiente estructura de registros y se inicializa vacía:

Symbol.for("foo"); // crear un nuevo símbolo global
Symbol.for("foo"); // obtener el símbolo ya creado

// El mismo símbolo global, pero no localmente
Symbol.for("bar") === Symbol.for("bar"); // true
Symbol("bar") === Symbol("bar"); // false

// La clave también se utiliza como descripción
const sym = Symbol.for("mario");
sym.toString(); // "Symbol(mario)"

Para evitar conflictos de nombres con sus claves de símbolos globales y otros símbolos globales (del código de la biblioteca), puede ser una buena idea poner un prefijo a sus símbolos:

Symbol.for("mdn.foo");
Symbol.for("mdn.bar");

• Symbol.keyFor()