Symbols ni nini na zinatumiwaje?

Question

Accepted Answer

A **Symbol** ni ya kipekee, isiyobadilika primitiva. Kila `Symbol()` unayounda ni **guaranteed distinct** — hata mbili na maelezo sawa si sawa. Kazi yao kuu ni kuwa **collision-proof object keys**.

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

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

## Kwa nini ufunguo wa kipekee ni muhimu

Sifa zinazoandaliwa na Symbol hazipatani na funguo za kamba na ni **hidden** kutoka kwa enumeration ya kawaida — bora kwa kuambatanisha metadata bila kuoteza kitu:

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

Kwa hiyo maktaba inaweza kuhifadhi data ya ndani kwenye kitu chako kupitia Symbol bila hatari ya mgogolano na mali zako au kuonekana katika mitandao yako.

## Alama zinazojulikana hubadilisha tabia ya lugha

Matumizi muhimu sana — `Symbol.iterator` hufanya kitu kuwa kinachoweza kurudishwa:

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

Zingine: `Symbol.asyncIterator`, `Symbol.toPrimitive` (custom coercion), `Symbol.hasInstance`.

## Karatasi ya ulimwengu

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

## Kwa nini hivyo maswali

Symbols huwezesha ufunguo wa metadata usiotengananisha na hukuruhusu kuunganisha kwenye protokoli za lugha ya msingi (iteration, coercion) — ndio jinsi built-ins na frameworks zinazoongeza vitu kwa usalama.