O que são Símbolos e onde são usados?

Question

Accepted Answer

Um **Símbolo** é um primitivo único e imutável. Cada `Symbol()` que você cria é **garantido como distinto** — mesmo dois com a mesma descrição não são iguais. Seu principal trabalho é ser uma **chave de objeto à prova de colisão**.

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

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

## Por que chaves únicas são úteis

Propriedades com chave Symbol não colidem com chaves string e ficam **ocultas** da enumeração normal — perfeito para anexar metadados sem poluir o objeto:

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

Assim, uma biblioteca pode armazenar dados internos no seu objeto através de um Símbolo sem risco de conflito com suas propriedades ou aparecer em seus loops.

## Símbolos conhecidos personalizam o comportamento da linguagem

O uso mais importante — `Symbol.iterator` torna um objeto iterável:

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

Outros: `Symbol.asyncIterator`, `Symbol.toPrimitive` (coerção customizada), `Symbol.hasInstance`.

## Registro global

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

## Por que isso importa

Os Símbolos permitem chaves de metadados sem colisão e permitem que você se conecte aos protocolos principais de linguagem (iteração, coerção) — é assim que as built-ins e frameworks estendem objetos com segurança.