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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.