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 September 2015.

El método Symbol.keyFor(sym) recupera la clave de símbolo compartida del símbolo pasado como argumento desde el registro global de símbolos.

Pruébalo

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

Sintaxis

js
Symbol.keyFor(sym);

Parámetros

sym

Symbol, obligatoria. El símbolo del que se desea encontrar la clave.

Valor de retorno

Una cadena que representa la clave del símbolo pasado como parámetro si es encontrado en el registro global de símbolos; En caso contrario, undefined.

Ejemplos

Usando keyFor()

js
const globalSym = Symbol.for("foo"); // crea un nuevo símbolo global
Symbol.keyFor(globalSym); // retorna: "foo"
const localSym = Symbol();
Symbol.keyFor(localSym); // retorna: undefined
// los símbolos de ámbito no son registrados
// en el registro global de símbolos.
Symbol.keyFor(Symbol.iterator); // retorna: undefined

Especificaciones

Specification
ECMAScript® 2025 Language Specification
# sec-symbol.keyfor

Compatibilidad con navegadores

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
keyFor

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Véase también