CKTIS / JavaScript
Symbol — уникални стойности и ключове на свойства
Symbol() създава уникална, неизменяема примитивна стойност, която може да служи като ключ на свойство на обект. Описанието не определя идентичността на символа; Symbol.for() позволява символът да се споделя чрез регистър.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
Symbol()
Symbol(description)
Symbol.for(key)
Symbol.keyFor(symbol)Symbol(description) връща нова, уникална примитивна стойност от тип symbol, а не обект. Незадължителното описание помага символът да бъде разпознат, но не е неговата идентичност: две извиквания на Symbol("id") създават различни стойности. new Symbol() предизвиква TypeError.
Символът може да бъде ключ на свойство, независим от ключовете низове. Записът { [first]: "internal" } създава свойство с ключ стойността, съхранена в first, а record[first] прочита стойността му. Свойството record.id има различен ключ и може да съществува до него без конфликт.
Symbol.for(key) търси или създава символ в глобалния регистър: един и същ ключ низ връща един и същ символ. Symbol.keyFor(symbol) връща ключа му в регистъра или undefined, ако символът не е регистриран. Това се различава от създаването на нов символ чрез Symbol().
Символният ключ не осигурява поверителност: може да бъде открит чрез Object.getOwnPropertySymbols(), въпреки че Object.keys() го пропуска. Вградените символи, като Symbol.iterator, са отделна група предварително дефинирани ключове, използвани от езиковите протоколи.
Примери
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")));Резултат
symbol false public internal true app.id
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.