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

CKTIS / JavaScript

Symbol.for() — символи от споделен регистър

Symbol.for(key) търси символ в глобалния регистър по текстов ключ. Връща съществуващия символ или създава и регистрира нов. Така независими части от кода могат да получат един и същ символ като ключ на свойство.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

Symbol.for(key)

Symbol.for(key) е статичен метод, който връща примитивна стойност от тип symbol. Той търси зададения текстов ключ в глобалния регистър на символите на средата за изпълнение. Ако ключът липсва, създава символ и го регистрира под този ключ. Ключът служи и като описание на символа.

За разлика от Symbol.for("cktis.status"), всяко извикване на Symbol("cktis.status") създава отделен символ: еднаквите описания не означават еднаква идентичност. Регистърът позволява символи да се споделят между файлове, както и между realms, които използват общия регистър. Това не е механизъм за трайно съхранение на данни.

Използвайте префикси като cktis.status, за да намалите сблъсъците на имена с библиотеки. Регистрираният символ не е тайна: друг код, който знае ключа, може да го получи. Symbol.keyFor(symbol) връща ключа на регистриран символ, но за символ, създаден с Symbol(), връща undefined.

Примерът прочита свойство на обект чрез символ, получен повторно от регистъра. MDN посочва, че Symbol.for() е наличен в браузърите от септември 2015 г.; това не е API само за браузъри.

Примери

const first = Symbol.for("cktis.status");
const second = Symbol.for("cktis.status");
const local = Symbol("cktis.status");
const record = { [first]: "ready" };

console.log(first === second);
console.log(first === local);
console.log(record[second]);
console.log(Symbol.keyFor(first));
console.log(Symbol.keyFor(local));

Резултат

true
false
ready
cktis.status
undefined

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

Източници