Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti