CKTIS / JavaScript
Symbol — unikalne wartości i klucze właściwości
Symbol() tworzy unikalną, niezmienną wartość prostą, którą można wykorzystać jako klucz właściwości obiektu. Opis nie określa tożsamości symbolu; Symbol.for() pozwala natomiast współdzielić symbol za pomocą rejestru.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
Symbol()
Symbol(description)
Symbol.for(key)
Symbol.keyFor(symbol)Symbol(description) zwraca nową, unikalną wartość prostą typu symbol, a nie obiekt. Opcjonalny opis pomaga rozpoznawać symbol, lecz nie jest jego tożsamością: dwa wywołania Symbol("id") dają różne wartości. Wywołanie new Symbol() zgłasza TypeError.
Symbol może być kluczem właściwości niezależnym od kluczy tekstowych. Zapis { [first]: "internal" } tworzy właściwość z kluczem przechowywanym w first, a record[first] odczytuje jej wartość. Właściwość record.id ma inny klucz i może istnieć obok niej bez konfliktu.
Symbol.for(key) wyszukuje lub tworzy symbol w globalnym rejestrze: ten sam klucz tekstowy zwraca ten sam symbol. Symbol.keyFor(symbol) zwraca jego klucz rejestru albo undefined, jeśli symbol nie jest zarejestrowany. To inne zachowanie niż tworzenie nowego symbolu przez Symbol().
Klucz symboliczny nie zapewnia prywatności: można go odnaleźć przez Object.getOwnPropertySymbols(), choć Object.keys() go pomija. Wbudowane symbole, takie jak Symbol.iterator, są osobną grupą ustalonych kluczy używanych przez protokoły języka.
Przykłady
const first = Symbol("id");
const second = Symbol("id");
const record = { id: "public", [first]: "internal" };
console.log(typeof first);
console.log(first === second);
console.log(record.id);
console.log(record[first]);
console.log(Symbol.for("app.id") === Symbol.for("app.id"));
console.log(Symbol.keyFor(Symbol.for("app.id")));Wynik
symbol false public internal true app.id
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.