Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources