CKTIS / JavaScript
Symbol.for() — simboli da un registro condiviso
Symbol.for(key) cerca un simbolo nel registro globale usando una chiave testuale. Restituisce il simbolo esistente oppure ne crea e registra uno nuovo. In questo modo, parti di codice indipendenti possono ottenere la stessa chiave di proprietà simbolica.
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.for(key)Symbol.for(key) è un metodo statico che restituisce un valore primitivo di tipo symbol. Cerca la chiave testuale fornita nel registro globale dei simboli dell’ambiente di esecuzione. Se la chiave non è presente, crea un simbolo e lo registra con quella chiave. La chiave funge anche da descrizione del simbolo.
A differenza di Symbol.for("cktis.status"), ogni chiamata a Symbol("cktis.status") crea un simbolo distinto: descrizioni identiche non implicano un’identità identica. Il registro consente di condividere simboli tra file e tra realm che condividono il registro. Non è un meccanismo per la memorizzazione persistente dei dati.
Usa prefissi come cktis.status per ridurre le collisioni di nomi con le librerie. Un simbolo registrato non è un segreto: altro codice che conosce la chiave può recuperarlo. Symbol.keyFor(symbol) restituisce la chiave di un simbolo registrato, ma restituisce undefined per un simbolo creato con Symbol().
L’esempio legge una proprietà dell’oggetto tramite un simbolo recuperato di nuovo dal registro. MDN indica che Symbol.for() è disponibile nei browser da settembre 2015; non è un’API riservata ai browser.
Esempi
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));Risultato
true false ready cktis.status undefined
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.