Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje