This page was translated from English by the community. Learn more and join the MDN Web Docs community.

View in English Always switch to English

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 symbol

console.log(Symbol.keyFor(globalSym));
// Expected output: "foo"

const localSym = Symbol(); // Local symbol

console.log(Symbol.keyFor(localSym));
// Expected output: undefined

console.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

Совместимость с браузерами

Смотрите также