CKTIS / JavaScript
Symbol — valeurs uniques et clés de propriété
Symbol() crée une valeur primitive unique et immuable qui peut servir de clé de propriété d’un objet. La description ne détermine pas l’identité du symbole ; Symbol.for() permet plutôt de partager un symbole par l’intermédiaire d’un registre.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
Symbol()
Symbol(description)
Symbol.for(key)
Symbol.keyFor(symbol)Symbol(description) renvoie une nouvelle valeur primitive unique de type symbol, et non un objet. La description facultative aide à reconnaître le symbole, mais ne constitue pas son identité : deux appels à Symbol("id") produisent des valeurs différentes. new Symbol() déclenche une TypeError.
Un symbole peut servir de clé de propriété indépendamment des clés de type chaîne. { [first]: "internal" } crée une propriété dont la clé est la valeur stockée dans first, et record[first] en lit la valeur. La propriété record.id a une clé différente et peut coexister avec elle sans conflit.
Symbol.for(key) recherche ou crée un symbole dans le registre global : une même clé de type chaîne renvoie le même symbole. Symbol.keyFor(symbol) renvoie sa clé de registre, ou undefined si le symbole n’est pas enregistré. Ce comportement diffère de la création d’un nouveau symbole avec Symbol().
Une clé symbole ne garantit pas la confidentialité : elle peut être retrouvée avec Object.getOwnPropertySymbols(), même si Object.keys() ne la renvoie pas. Les symboles intégrés, comme Symbol.iterator, forment un groupe distinct de clés prédéfinies utilisées par les protocoles du langage.
Exemples
const first = Symbol("id");
const second = Symbol("id");
const record = { id: "public", [first]: "internal" };
console.log(typeof first);
console.log(first === second);
console.log(record.id);
console.log(record[first]);
console.log(Symbol.for("app.id") === Symbol.for("app.id"));
console.log(Symbol.keyFor(Symbol.for("app.id")));Résultat
symbol false public internal true app.id
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.