blob: e212249f4579e8c5012485de61bc36625ef49cb1 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
|
---
title: Symbol.keyFor()
slug: Web/JavaScript/Reference/Global_Objects/Symbol/keyFor
tags:
- ECMAScript 2015
- JavaScript
- Méthode
- Reference
- Symbol
translation_of: Web/JavaScript/Reference/Global_Objects/Symbol/keyFor
original_slug: Web/JavaScript/Reference/Objets_globaux/Symbol/keyFor
---
{{JSRef}}
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.
{{EmbedInteractiveExample("pages/js/symbol-keyfor.html")}}
## Syntaxe
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 {{jsxref("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 | État | Commentaires |
| ------------------------------------------------------------------------------------ | ---------------------------- | -------------------- |
| {{SpecName('ES2015', '#sec-symbol.keyfor', 'Symbol.keyFor')}} | {{Spec2('ES2015')}} | Définition initiale. |
| {{SpecName('ESDraft', '#sec-symbol.keyfor', 'Symbol.keyFor')}} | {{Spec2('ESDraft')}} | |
## Compatibilité des navigateurs
{{Compat("javascript.builtins.Symbol.keyFor")}}
## Voir aussi
- {{jsxref("Symbol.for()")}}
|
