Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri