CKTIS / JavaScript
Symbol — jedinečné hodnoty a kľúče vlastností
Symbol() vytvára jedinečnú nemennú primitívnu hodnotu, ktorú možno použiť ako kľúč vlastnosti objektu. Opis neurčuje identitu symbolu; Symbol.for() namiesto toho umožňuje zdieľať symbol prostredníctvom registra.
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()
Symbol(description)
Symbol.for(key)
Symbol.keyFor(symbol)Symbol(description) vracia novú jedinečnú primitívnu hodnotu typu symbol, nie objekt. Voliteľný opis pomáha symbol rozpoznať, ale nie je jeho identitou: dve volania Symbol("id") vytvoria rôzne hodnoty. new Symbol() vyvolá TypeError.
Symbol môže byť kľúčom vlastnosti nezávisle od reťazcových kľúčov. Zápis { [first]: "internal" } vytvorí vlastnosť, ktorej kľúčom je hodnota uložená v first, a record[first] prečíta jej hodnotu. Vlastnosť record.id má iný kľúč a môže vedľa nej existovať bez konfliktu.
Symbol.for(key) vyhľadá alebo vytvorí symbol v globálnom registri: rovnaký reťazcový kľúč vráti rovnaký symbol. Symbol.keyFor(symbol) vráti jeho kľúč registra alebo undefined, ak symbol nie je registrovaný. To sa líši od vytvorenia nového symbolu pomocou Symbol().
Symbolový kľúč nezaručuje súkromie: možno ho nájsť pomocou Object.getOwnPropertySymbols(), hoci ho Object.keys() vynecháva. Vstavané symboly, ako napríklad Symbol.iterator, tvoria samostatnú skupinu vopred definovaných kľúčov používaných jazykovými protokolmi.
Príklady
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")));Výsledok
symbol false public internal true app.id
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.