База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници