CKTIS / JavaScript
Symbol — jedinstvene vrijednosti i ključevi svojstava
Symbol() stvara jedinstvenu, nepromjenjivu primitivnu vrijednost koja može služiti kao ključ svojstva objekta. Opis ne određuje identitet simbola; Symbol.for() umjesto toga omogućuje dijeljenje simbola putem registra.
Verzija: 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) vraća novu jedinstvenu primitivnu vrijednost vrste symbol, a ne objekt. Neobavezni opis pomaže prepoznati simbol, ali nije njegov identitet: dva poziva Symbol("id") stvaraju različite vrijednosti. new Symbol() izaziva TypeError.
Simbol može biti ključ svojstva neovisan o ključevima nizova. Zapis { [first]: "internal" } stvara svojstvo čiji je ključ vrijednost pohranjena u first, a record[first] čita njegovu vrijednost. Svojstvo record.id ima drukčiji ključ i može postojati uz njega bez sukoba.
Symbol.for(key) traži ili stvara simbol u globalnom registru: isti ključ niza vraća isti simbol. Symbol.keyFor(symbol) vraća njegov ključ registra ili undefined ako simbol nije registriran. To se razlikuje od stvaranja novog simbola pomoću Symbol().
Simbolski ključ ne pruža privatnost: može se pronaći pomoću Object.getOwnPropertySymbols(), iako ga Object.keys() izostavlja. Ugrađeni simboli, kao što je Symbol.iterator, posebna su skupina unaprijed definiranih ključeva koje koriste jezični protokoli.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.