CKTIS / JavaScript
WeakMap.set(): dodawanie i zastępowanie wartości
Metoda `set()` zapisuje wartość pod kluczem w `WeakMap`. Jeśli klucz już istnieje, zastępuje jego wartość. Zwraca tę samą mapę, więc wywołania można łączyć w łańcuch.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
weakMap.set(key, value)WeakMap.set to nazwa metody instancji WeakMap.prototype.set, a nie metody statycznej konstruktora WeakMap. Wywołanie weakMap.set(key, value) dodaje wpis, jeśli klucza jeszcze nie ma, lub zastępuje zapisaną wartość. Zwraca ten sam obiekt WeakMap, więc można od razu wywołać kolejne .set(). Wartość może być dowolna; pominięcie value zapisuje undefined.
Klucze obiektowe porównuje się według tożsamości: dwa osobno utworzone obiekty {} to różne klucze. ECMAScript 2024 dopuszcza też niezarejestrowane symbole, np. Symbol(). Starsze środowiska wykonawcze mogą obsługiwać tylko klucze obiektowe. Klucz taki jak napis, liczba, null lub zarejestrowany symbol z Symbol.for() powoduje TypeError. To samo dotyczy wywołania metody z this, które nie jest instancją WeakMap.
Sam wpis nie utrzymuje klucza przy życiu. Gdy klucz przestanie być osiągalny poza tym słabym powiązaniem, mechanizm odśmiecania pamięci może go usunąć, ale nie ma gwarancji, kiedy to nastąpi. To przydatne, gdy chcesz przechowywać dodatkowe dane o obiekcie bez wydłużania jego życia. Jeśli potrzebujesz kluczy tekstowych lub iterowania po wpisach, użyj Map.
Przykłady
{
const statuses = new WeakMap();
const task = {};
const otherTask = {};
const result = statuses.set(task, "pending").set(otherTask, false);
statuses.set(task, "ready");
console.log(result === statuses);
console.log(statuses.get(task));
console.log(statuses.get(otherTask));
console.log(statuses.has({}));
try {
statuses.set("task", "ready");
} catch (error) {
console.log(error instanceof TypeError);
}
}Wynik
true ready false false true
Pierwsze `true` potwierdza, że łańcuch wywołań zwraca tę samą mapę. `ready` zastępuje `pending`, pierwsze `false` to zapisana wartość `otherTask`, a drugie `false` oznacza, że nowy obiekt `{}` nie jest kluczem w mapie. Ostatnie `true` potwierdza, że klucz tekstowy spowodował `TypeError`.
Powiązane lekcje
- JavaScript · Lekcja 18 · Podstawowy · Wersja: 4