Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Symbol.for() — symbole ze wspólnego rejestru

Symbol.for(key) wyszukuje symbol w globalnym rejestrze według klucza tekstowego. Zwraca istniejący symbol albo tworzy i rejestruje nowy. Dzięki temu niezależne fragmenty kodu mogą uzyskać ten sam klucz symboliczny.

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.for(key)

Symbol.for(key) to metoda statyczna zwracająca wartość typu symbol. Wyszukuje podany klucz tekstowy w globalnym rejestrze symboli środowiska wykonawczego. Jeśli go nie znajdzie, tworzy symbol i zapisuje go pod tym kluczem. Klucz służy również jako opis symbolu.

W przeciwieństwie do Symbol.for("cktis.status"), każde wywołanie Symbol("cktis.status") tworzy odrębny symbol: jednakowy opis nie oznacza jednakowej tożsamości. Rejestr pozwala współdzielić symbole między plikami, a także między obszarami wykonania (realms) korzystającymi ze wspólnego rejestru. Nie jest to mechanizm trwałego przechowywania danych.

Używaj prefiksów, takich jak cktis.status, aby ograniczać kolizje nazw z bibliotekami. Zarejestrowany symbol nie jest sekretem: inny kod znający klucz może go pobrać. Symbol.keyFor(symbol) zwraca klucz zarejestrowanego symbolu, a dla symbolu utworzonego przez Symbol() zwraca undefined.

Przykład pokazuje odczyt właściwości obiektu przez ponownie pobrany symbol. MDN podaje dostępność Symbol.for() w przeglądarkach od września 2015 r.; nie jest to API dostępne wyłącznie w przeglądarce.

Przykłady

const first = Symbol.for("cktis.status");
const second = Symbol.for("cktis.status");
const local = Symbol("cktis.status");
const record = { [first]: "ready" };

console.log(first === second);
console.log(first === local);
console.log(record[second]);
console.log(Symbol.keyFor(first));
console.log(Symbol.keyFor(local));

Wynik

true
false
ready
cktis.status
undefined

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła