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.