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

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.

Fuentes