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.

La méthode Symbol.keyFor(sym) permet de récupérer la clé d'un symbole donné qui est partagé via le registre global des symboles.

Exemple interactif

Syntaxe

js
Symbol.keyFor(sym);

Paramètres

sym

Le symbole dont on souhaite connaître la clé. Ce paramètre est obligatoire.

Valeur de retour

Une chaîne de caractères qui représente la clé d'un symbole donné si celui-ci est trouvé dans le registre global ou undefined sinon.

Exemples

js
var symboleGlobal = Symbol.for("toto"); // on crée un symbole global
Symbol.keyFor(symboleGlobal); // "toto"

var symboleLocal = Symbol();
Symbol.keyFor(symboleLocal); // undefined

// les symboles connus ne sont pas dans le registre
// global
Symbol.keyFor(Symbol.iterator); // undefined

Spécifications

Specification
ECMAScript Language Specification
# sec-symbol.keyfor

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi