Constructeur Symbol()

description Facultatif

Une chaîne de caractères qui décrit le symbole. Elle peut être utilisée pour le débogage mais ne permet pas d'accéder au symbole lui-même.

Pour créer un nouveau symbole primitif, on écrit Symbol() en fournissant éventuellement une chaîne de caractères comme description :

let sym1 = Symbol();
let sym2 = Symbol("toto");
let sym3 = Symbol("toto");

Dans le code précédent, on crée trois nouveaux symboles. On notera que Symbol("toto") ne convertit pas la chaîne de caractères "toto" en un symbole. C'est bien un nouveau symbole qui est créé chaque fois :

Symbol("toto") === Symbol("toto"); // false

La syntaxe qui suit, utilisant l'opérateur new, déclenchera une exception TypeError :

let sym = new Symbol(); // TypeError

Cela permet d'éviter aux développeuses et développeurs de créer un objet enveloppant une valeur symbole primitive plutôt qu'un nouveau symbole. Ce comportement se distingue des autres types de données primitifs pour lesquels c'est possible (par exemple new Boolean(), new String() et new Number()).

Si on souhaite vraiment envelopper un symbole dans une valeur objet, il faudra utiliser la fonction Object() :

let sym = Symbol("toto");
let symObj = Object(sym);
typeof sym; // => "symbol"
typeof symObj; // => "object"

• Prothèse d'émulation pour Symbol avec la bibliothèque d'émulation core-js
• La page du glossaire sur le type de données symbole