Symbol.keyFor()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2015 browserübergreifend verfügbar.
Die Symbol.keyFor() statische Methode ruft einen gemeinsamen Symbolschlüssel aus dem globalen Symbolregister für das angegebene Symbol ab.
Probieren Sie es aus
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
Syntax
js
Symbol.keyFor(sym)
Parameter
sym-
Symbol, erforderlich. Das Symbol, für das ein Schlüssel gefunden werden soll.
Rückgabewert
Ein String, der den Schlüssel für das angegebene Symbol darstellt, falls einer im globalen Register gefunden wird; andernfalls undefined.
Beispiele
Verwendung von 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
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2026 Language Specification # sec-symbol.keyfor |