Symbol.keyFor()

基线广泛可用

自 2015年9月起，此特性已在主流浏览器中得到支持，可在大多数设备和浏览器版本中正常使用。

Symbol.keyFor(sym) 方法用来获取全局 symbol 注册表中与某个 symbol 关联的键。

本文内容

语法

Symbol.keyFor(sym);

参数

sym

必选参数，需要查找键值的某个 Symbol。

返回值

如果全局注册表中查找到该 symbol，则返回该 symbol 的 key 值，返回值为字符串类型。否则返回 undefined

示例

js
// 创建一个全局 Symbol
var globalSym = Symbol.for("foo");
Symbol.keyFor(globalSym); // "foo"

var localSym = Symbol();
Symbol.keyFor(localSym); // undefined，

// 以下 Symbol 不是保存在全局 Symbol 注册表中
Symbol.keyFor(Symbol.iterator); // undefined

规范

ECMAScript® 2027 Language Specification
# sec-symbol.keyfor

浏览器兼容性

启用 JavaScript 以查看此浏览器兼容性表。

参见

Symbol.prototype.for()

帮助改进 MDN

此页面对您有帮助吗？

是否

了解如何参与贡献

此页面最后更新于 2025年10月23日，由 MDN 贡献者更新。

在 GitHub 上查看此页面 • 报告此内容的问题