This page was translated from English by the community.Learn more and join the MDN Web Docs community.
Symbol.keyFor()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since сентябрь 2015 г..
МетодSymbol.keyFor(sym) получает ключ для заданного символа из глобального реестра символов.
Интерактивный пример
const globalSym = Symbol.for("foo"); // Global symbolconsole.log(Symbol.keyFor(globalSym));// Expected output: "foo"const localSym = Symbol(); // Local symbolconsole.log(Symbol.keyFor(localSym));// Expected output: undefinedconsole.log(Symbol.keyFor(Symbol.iterator));// Expected output: undefinedСинтаксис
Symbol.keyFor(sym);
Параметры
- sym
Символ, обязательный. Символ, ключ которого требуется найти
Возвращаемое значение
Строка с ключом заданного символа, если он есть в глобальном реестре символов, либоundefined, если его там нет.
Примеры
js
var globalSym = Symbol.for("foo"); // Создаёт новый глобальный символSymbol.keyFor(globalSym); // "foo"var localSym = Symbol();Symbol.keyFor(localSym); // undefined// Известные символы не является символами,// которые находятся в глобальном реестре символовSymbol.keyFor(Symbol.iterator); // undefinedСпецификации
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-symbol.keyfor |