Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti