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

CKTIS / JavaScript

Symbol — enolične vrednosti in ključi lastnosti

Symbol() ustvari enolično nespremenljivo primitivno vrednost, ki lahko služi kot ključ lastnosti objekta. Opis ne določa identitete simbola; Symbol.for() pa omogoča skupno rabo simbola prek registra.

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()
Symbol(description)
Symbol.for(key)
Symbol.keyFor(symbol)

Symbol(description) vrne novo enolično primitivno vrednost vrste symbol, ne objekta. Izbirni opis pomaga prepoznati simbol, vendar ni njegova identiteta: dva klica Symbol("id") ustvarita različni vrednosti. new Symbol() sproži TypeError.

Simbol je lahko ključ lastnosti, neodvisen od nizovnih ključev. Zapis { [first]: "internal" } ustvari lastnost, katere ključ je vrednost, shranjena v first, record[first] pa prebere njeno vrednost. Lastnost record.id ima drug ključ in lahko obstaja poleg nje brez konflikta.

Symbol.for(key) v globalnem registru poišče ali ustvari simbol: isti nizovni ključ vrne isti simbol. Symbol.keyFor(symbol) vrne njegov registrski ključ ali undefined, če simbol ni registriran. To se razlikuje od ustvarjanja novega simbola z Symbol().

Simbolni ključ ne zagotavlja zasebnosti: najti ga je mogoče z Object.getOwnPropertySymbols(), čeprav ga Object.keys() izpusti. Vgrajeni simboli, kot je Symbol.iterator, so ločena skupina vnaprej določenih ključev, ki jih uporabljajo jezikovni protokoli.

Primeri

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")));

Rezultat

symbol
false
public
internal
true
app.id

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri