Symbol.keyFor()

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 2015 年 9 月以來,該特性已在各大瀏覽器中可用。

Symbol.keyFor() 靜態方法用於從全域性 Symbol 登錄檔中檢索給定 Symbol 的共享 Symbol 鍵。

試一試

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

語法

js
Symbol.keyFor(sym)

引數

sym

Symbol,必需。要查詢鍵的 Symbol。

返回值

如果找到了給定 Symbol 在全域性登錄檔中的鍵,則返回表示該鍵的字串;否則,返回undefined

示例

使用 keyFor()

js
const globalSym = Symbol.for("foo"); // create a new global symbol
Symbol.keyFor(globalSym); // "foo"

const localSym = Symbol();
Symbol.keyFor(localSym); // undefined

// well-known symbols are not symbols registered
// in the global symbol registry
Symbol.keyFor(Symbol.iterator); // undefined

規範

規範
ECMAScript® 2026 語言規範
# sec-symbol.keyfor

瀏覽器相容性

另見