Cosa sono i Symbols e dove vengono utilizzati?

Question

Accepted Answer

Un **Symbol** è un primitive unico e immutabile. Ogni `Symbol()` che crei è **garantito essere distinto** — anche due con la stessa descrizione non sono uguali. Il loro compito principale è essere **chiavi di oggetto a prova di collisione**.

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

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

## Perché le chiavi uniche sono utili

Le proprietà Symbol-keyed non collidono con le chiavi string e sono **nascoste** dalla normale enumerazione — perfette per allegare metadati senza inquinare l'oggetto:

```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
```

Quindi una libreria può archiviare dati interni sul tuo oggetto tramite Symbol senza rischiare uno scontro con le tue proprietà o visualizzare nei tuoi loop.

## I symbol noti personalizzano il comportamento del linguaggio

L'uso più importante — `Symbol.iterator` rende un oggetto iterabile:

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

Altri: `Symbol.asyncIterator`, `Symbol.toPrimitive` (coercizione personalizzata), `Symbol.hasInstance`.

## Registro globale

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

## Perché è importante

I Symbols consentono chiavi di metadati senza collisioni e ti consentono di collegarti ai protocolli del linguaggio di base (iterazione, coercizione) — questo è il modo in cui i built-in e i framework estendono gli oggetti in modo sicuro.