CKTIS / JavaScript
Symbol — valori univoci e chiavi di proprietà
Symbol() crea un valore primitivo univoco e immutabile che può fungere da chiave di proprietà di un oggetto. La descrizione non determina l’identità del simbolo; Symbol.for() permette invece di condividere un simbolo tramite un registro.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
Symbol()
Symbol(description)
Symbol.for(key)
Symbol.keyFor(symbol)Symbol(description) restituisce un nuovo valore primitivo univoco di tipo symbol, non un oggetto. La descrizione facoltativa aiuta a riconoscere il simbolo, ma non ne costituisce l’identità: due chiamate a Symbol("id") producono valori diversi. new Symbol() genera un TypeError.
Un simbolo può essere una chiave di proprietà indipendente dalle chiavi stringa. { [first]: "internal" } crea una proprietà con chiave pari al valore memorizzato in first, e record[first] ne legge il valore. La proprietà record.id ha una chiave diversa e può coesistere con essa senza conflitti.
Symbol.for(key) cerca o crea un simbolo nel registro globale: la stessa chiave stringa restituisce lo stesso simbolo. Symbol.keyFor(symbol) restituisce la sua chiave di registro, oppure undefined se il simbolo non è registrato. È un comportamento diverso dalla creazione di un nuovo simbolo con Symbol().
Una chiave simbolica non garantisce privacy: può essere individuata tramite Object.getOwnPropertySymbols(), anche se Object.keys() la omette. I simboli integrati, come Symbol.iterator, costituiscono un gruppo distinto di chiavi predefinite usate dai protocolli del linguaggio.
Esempi
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")));Risultato
symbol false public internal true app.id
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.