CKTIS / JavaScript
Symbol.for() — symboly zo zdieľaného registra
Symbol.for(key) vyhľadá symbol v globálnom registri podľa textového kľúča. Vráti existujúci symbol alebo vytvorí a zaregistruje nový. Nezávislé časti kódu tak môžu získať rovnaký symbol ako kľúč vlastnosti.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
Symbol.for(key)Symbol.for(key) je statická metóda, ktorá vracia primitívnu hodnotu typu symbol. V globálnom registri symbolov runtime prostredia vyhľadá zadaný textový kľúč. Ak kľúč nenájde, vytvorí symbol a zaregistruje ho pod týmto kľúčom. Kľúč zároveň slúži ako opis symbolu.
Na rozdiel od Symbol.for("cktis.status") vytvorí každé volanie Symbol("cktis.status") samostatný symbol: rovnaké opisy neznamenajú rovnakú identitu. Register umožňuje zdieľať symboly medzi súbormi aj medzi realms, ktoré zdieľajú tento register. Nejde o mechanizmus na trvalé ukladanie údajov.
Používajte predpony, napríklad cktis.status, aby ste obmedzili kolízie názvov s knižnicami. Registrovaný symbol nie je tajný: iný kód, ktorý pozná kľúč, ho môže získať. Symbol.keyFor(symbol) vráti kľúč registrovaného symbolu, ale pre symbol vytvorený pomocou Symbol() vráti undefined.
Príklad číta vlastnosť objektu pomocou symbolu opätovne získaného z registra. MDN uvádza, že Symbol.for() je v prehliadačoch dostupné od septembra 2015; nejde o API dostupné iba v prehliadači.
Príklady
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));Výsledok
true false ready cktis.status undefined
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.