CKTIS / JavaScript
Symbol.for() — simboli iz skupnega registra
Symbol.for(key) poišče simbol v globalnem registru z besedilnim ključem. Vrne obstoječi simbol ali ustvari in registrira novega. Tako lahko neodvisni deli kode pridobijo isti simbol kot ključ lastnosti.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
Symbol.for(key)Symbol.for(key) je statična metoda, ki vrne primitivno vrednost vrste symbol. V globalnem registru simbolov izvajalnega okolja poišče podani besedilni ključ. Če ključa ni, ustvari simbol in ga registrira pod tem ključem. Ključ služi tudi kot opis simbola.
Za razliko od Symbol.for("cktis.status") vsak klic Symbol("cktis.status") ustvari ločen simbol: enaki opisi ne pomenijo enake identitete. Register omogoča skupno rabo simbolov med datotekami in med realms, ki uporabljajo isti register. Ne gre za mehanizem za trajno shranjevanje podatkov.
Uporabljajte predpone, kot je cktis.status, da zmanjšate možnost kolizij imen s knjižnicami. Registriran simbol ni skrivnost: druga koda, ki pozna ključ, ga lahko pridobi. Symbol.keyFor(symbol) vrne ključ registriranega simbola, za simbol, ustvarjen z Symbol(), pa vrne undefined.
Primer prebere lastnost objekta prek simbola, ki je bil znova pridobljen iz registra. MDN navaja, da je Symbol.for() v brskalnikih na voljo od septembra 2015; ta API ni namenjen samo brskalnikom.
Primeri
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));Rezultat
true false ready cktis.status undefined
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.