Co jsou Symboly a kde se používají?

Question

Accepted Answer

**Symbol** je jedinečný, neměnný primitiv. Každý `Symbol()`, který vytvoříte, je **zaručeně odlišný** — i dva se stejným popisem si nejsou rovny. Jejich hlavním úkolem je být **klíči odolnými vůči kolizím**.

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

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

## Proč jsou jedinečné klíče užitečné

Vlastnosti s klíčem Symbol nekolidují s řetězcovými klíči a jsou **skryté** před běžným výčtem — ideální pro připojení metadat bez znečištění objektu:

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

Takže knihovna může ukládat interní data na váš objekt prostřednictvím Symbolu bez rizika konfliktu s vašimi vlastnostmi nebo jejich zobrazení ve vašich smyčkách.

## Dobře známé symboly přizpůsobují chování jazyka

Nejdůležitější použití — `Symbol.iterator` činí objekt iterovatelným:

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

Další: `Symbol.asyncIterator`, `Symbol.toPrimitive` (vlastní převod), `Symbol.hasInstance`.

## Globální registr

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

## Proč je to důležité

Symboly umožňují klíče metadat bez kolizí a umožňují vám zapojit se do základních jazykových protokolů (iterace, převod) — je to způsob, jak vestavěné prvky a frameworky bezpečně rozšiřují objekty.