CKTIS / JavaScript
Symbol — jedinečné hodnoty a klíče vlastností
Symbol() vytváří jedinečnou neměnnou primitivní hodnotu, kterou lze použít jako klíč vlastnosti objektu. Popis neurčuje identitu symbolu; Symbol.for() naopak umožňuje sdílet symbol prostřednictvím registru.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
Symbol()
Symbol(description)
Symbol.for(key)
Symbol.keyFor(symbol)Symbol(description) vrací novou jedinečnou primitivní hodnotu typu symbol, nikoli objekt. Volitelný popis pomáhá symbol rozpoznat, ale není jeho identitou: dvě volání Symbol("id") vytvoří různé hodnoty. new Symbol() vyvolá TypeError.
Symbol může být klíčem vlastnosti nezávisle na řetězcových klíčích. Zápis { [first]: "internal" } vytvoří vlastnost, jejímž klíčem je hodnota uložená v first, a record[first] její hodnotu přečte. Vlastnost record.id má jiný klíč a může vedle ní existovat bez konfliktu.
Symbol.for(key) vyhledá nebo vytvoří symbol v globálním registru: stejný řetězcový klíč vrátí stejný symbol. Symbol.keyFor(symbol) vrátí jeho klíč v registru, nebo undefined, pokud symbol není registrován. To se liší od vytvoření nového symbolu pomocí Symbol().
Symbolický klíč nezajišťuje soukromí: lze jej najít pomocí Object.getOwnPropertySymbols(), přestože jej Object.keys() vynechává. Vestavěné symboly, například Symbol.iterator, tvoří samostatnou skupinu předem definovaných klíčů používaných jazykovými protokoly.
Pří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ýsledek
symbol false public internal true app.id
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.