CKTIS / JavaScript
Symbol: valores únicos y claves de propiedades
Symbol() crea un valor primitivo único e inmutable que puede servir como clave de propiedad de un objeto. La descripción no determina la identidad del símbolo; Symbol.for() permite, en cambio, compartir un símbolo mediante un registro.
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()
Symbol(description)
Symbol.for(key)
Symbol.keyFor(symbol)Symbol(description) devuelve un valor primitivo nuevo y único de tipo symbol, no un objeto. La descripción opcional ayuda a reconocer el símbolo, pero no constituye su identidad: dos llamadas a Symbol("id") producen valores distintos. new Symbol() lanza un TypeError.
Un símbolo puede ser una clave de propiedad independiente de las claves de texto. { [first]: "internal" } crea una propiedad cuya clave es el valor guardado en first, y record[first] lee su valor. La propiedad record.id tiene una clave distinta y puede coexistir con ella sin conflicto.
Symbol.for(key) busca o crea un símbolo en el registro global: la misma clave de texto devuelve el mismo símbolo. Symbol.keyFor(symbol) devuelve su clave de registro, o undefined si el símbolo no está registrado. Esto difiere de crear un símbolo nuevo con Symbol().
Una clave de símbolo no proporciona privacidad: se puede encontrar mediante Object.getOwnPropertySymbols(), aunque Object.keys() la omite. Los símbolos integrados, como Symbol.iterator, forman un grupo aparte de claves predefinidas que utilizan los protocolos del lenguaje.
Ejemplos
const first = Symbol("id");
const second = Symbol("id");
const record = { id: "public", [first]: "internal" };
console.log(typeof first);
console.log(first === second);
console.log(record.id);
console.log(record[first]);
console.log(Symbol.for("app.id") === Symbol.for("app.id"));
console.log(Symbol.keyFor(Symbol.for("app.id")));Resultado
symbol false public internal true app.id
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.