Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori