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.