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

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.

Zdroje