← 返回首页
Symbol.keyFor() - JavaScript | MDN

Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Symbol.keyFor()

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis septembre 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.

Dans cet article

Exemple interactif

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

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

Spécification
ECMAScript® 2027 Language Specification
# sec-symbol.keyfor

Compatibilité des navigateurs

Activez JavaScript pour afficher ce tableau de compatibilité des navigateurs.

Voir aussi