Qu'est-ce que les Symbols et où sont-ils utilisés ?

Question

Accepted Answer

Un **Symbol** est une primitive unique et immuable. Chaque `Symbol()` que vous créez est **garanti d'être distinct** — même deux avec la même description ne sont pas égaux. Leur rôle principal est d'être des **clés d'objet à l'épreuve des collisions**.

```js
const id = Symbol("id");
const id2 = Symbol("id");
id === id2;        // false — always unique

const user = { [id]: 123, name: "Ann" };
user[id];          // 123
```

## Pourquoi les clés uniques sont utiles

Les propriétés à clés Symbol ne font pas de collision avec les clés de chaîne et sont **masquées** de l'énumération normale — parfait pour attacher des métadonnées sans polluer l'objet :

```js
Object.keys(user);          // ["name"]  — symbol key is skipped
for (const k in user) {}    // skips the symbol
JSON.stringify(user);       // {"name":"Ann"} — symbol not serialized
Object.getOwnPropertySymbols(user); // [Symbol(id)] — only way to list them
```

Donc une bibliothèque peut stocker des données internes sur votre objet via un Symbol sans risquer une collision avec vos propriétés ou apparaître dans vos boucles.

## Les symboles bien connus personnalisent le comportement du langage

L'utilisation la plus importante — `Symbol.iterator` rend un objet itérable :

```js
const range = {
  [Symbol.iterator]() {
    let i = 1;
    return { next: () => (i <= 3 ? { value: i++, done: false } : { done: true }) };
  },
};
[...range]; // [1, 2, 3]
```

Autres : `Symbol.asyncIterator`, `Symbol.toPrimitive` (conversion personnalisée), `Symbol.hasInstance`.

## Registre global

```js
Symbol.for("key"); // shared symbol across the whole app (and across realms)
```

## Pourquoi c'est important

Les Symbols permettent les clés de métadonnées sans collision et vous permettent de vous intégrer aux protocoles de langage principaux (itération, conversion) — c'est ainsi que les éléments intégrés et les frameworks étendent les objets en toute sécurité.