Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje