Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Symbol.for() — símbolos de un registro compartido

Symbol.for(key) busca un símbolo en el registro global mediante una clave de texto. Devuelve el símbolo existente o crea y registra uno nuevo. Así, partes de código independientes pueden obtener la misma clave de propiedad simbólica.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

Symbol.for(key)

Symbol.for(key) es un método estático que devuelve un valor primitivo de tipo symbol. Busca la clave de texto proporcionada en el registro global de símbolos del entorno de ejecución. Si la clave no existe, crea un símbolo y lo registra con esa clave. La clave también sirve como descripción del símbolo.

A diferencia de Symbol.for("cktis.status"), cada llamada a Symbol("cktis.status") crea un símbolo distinto: tener descripciones idénticas no significa tener la misma identidad. El registro permite compartir símbolos entre archivos y entre realms que comparten el registro. No es un mecanismo de almacenamiento persistente de datos.

Usa prefijos como cktis.status para reducir las colisiones de nombres con bibliotecas. Un símbolo registrado no es un secreto: otro código que conozca la clave puede recuperarlo. Symbol.keyFor(symbol) devuelve la clave de un símbolo registrado, pero devuelve undefined para un símbolo creado con Symbol().

El ejemplo lee una propiedad de un objeto mediante un símbolo recuperado de nuevo del registro. MDN indica que Symbol.for() está disponible en los navegadores desde septiembre de 2015; no es una API exclusiva del navegador.

Ejemplos

const first = Symbol.for("cktis.status");
const second = Symbol.for("cktis.status");
const local = Symbol("cktis.status");
const record = { [first]: "ready" };

console.log(first === second);
console.log(first === local);
console.log(record[second]);
console.log(Symbol.keyFor(first));
console.log(Symbol.keyFor(local));

Resultado

true
false
ready
cktis.status
undefined

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes