CKTIS / JavaScript
Symbol.for() — symboly ze sdíleného registru
Symbol.for(key) hledá symbol v globálním registru podle textového klíče. Vrátí existující symbol, nebo vytvoří a zaregistruje nový. Nezávislé části kódu tak mohou získat stejný symbol jako klíč vlastnosti.
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.for(key)Symbol.for(key) je statická metoda, která vrací primitivní hodnotu typu symbol. V globálním registru symbolů běhového prostředí vyhledá zadaný textový klíč. Pokud klíč nenajde, vytvoří symbol a zaregistruje ho pod tímto klíčem. Klíč zároveň slouží jako popis symbolu.
Na rozdíl od Symbol.for("cktis.status") vytvoří každé volání Symbol("cktis.status") samostatný symbol: stejné popisy neznamenají stejnou identitu. Registr umožňuje sdílet symboly mezi soubory i mezi realms, které tento registr sdílejí. Nejde o mechanismus pro trvalé ukládání dat.
Používejte předpony, například cktis.status, abyste omezili kolize názvů s knihovnami. Registrovaný symbol není tajný: jiný kód, který zná klíč, ho může získat. Symbol.keyFor(symbol) vrátí klíč registrovaného symbolu, ale pro symbol vytvořený pomocí Symbol() vrátí undefined.
Příklad čte vlastnost objektu pomocí symbolu znovu získaného z registru. MDN uvádí, že Symbol.for() je v prohlížečích dostupné od září 2015; nejde o API určené pouze pro prohlížeče.
Pří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ýsledek
true false ready cktis.status undefined
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.