CKTIS / JavaScript
WeakMap.prototype.set(): zapisywanie wartości pod kluczem
Metoda `set()` dodaje wpis do `WeakMap` lub zastępuje wartość istniejącego wpisu. 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.prototype.set to metoda prototypu wywoływana na instancji: weakMap.set(key, value). Dodaje wpis dla nowego klucza albo zastępuje wartość dla tego samego klucza. Zwraca tę samą instancję, a nie zapisaną wartość, więc można wywołać kolejne .set(). Wartością może być dowolna wartość JavaScript, w tym undefined.
Klucze będące obiektami są porównywane według tożsamości: dwa odrębne obiekty o identycznych właściwościach to różne klucze. ECMAScript 2024 dopuszcza też niezarejestrowane symbole, np. Symbol("id"). Symbole z Symbol.for("id") oraz inne wartości proste, takie jak ciągi znaków, są niedozwolone. Starsze środowiska mogą nie obsługiwać kluczy symbolicznych; sprawdź zgodność z docelowym środowiskiem.
Nieprawidłowy klucz powoduje TypeError. Ten sam typ błędu wystąpi po wywołaniu odłączonej metody bez właściwego this: odbiorcą musi być instancja WeakMap.
Sam wpis nie utrzymuje klucza przy życiu. Jeśli klucz przestanie być osiągalny w inny sposób, mechanizm odzyskiwania pamięci może go usunąć; nie należy polegać na momencie, w którym to nastąpi. Kluczy WeakMap nie można wyliczać. Gdy potrzebujesz iterować po kluczach lub używać ciągów znaków jako kluczy, wybierz Map.
Przykłady
{
const metadata = new WeakMap();
const item = { id: 1 };
metadata.set(item, 10);
console.log(metadata.get(item));
const returned = metadata.set(item, 20);
console.log(returned === metadata);
console.log(metadata.get(item));
console.log(metadata.has({ id: 1 }));
try {
metadata.set("id", 30);
} catch (error) {
console.log(error instanceof TypeError);
}
}Wynik
10 true 20 false true
Najpierw odczyt zwraca `10`, a po aktualizacji — `20`. Porównanie `returned === metadata` daje `true`. Nowy obiekt z takim samym `id` nie jest zapisanym kluczem, więc `has()` zwraca `false`. Próba użycia ciągu znaków jako klucza kończy się przechwyconym `TypeError`.
Powiązane lekcje
- JavaScript · Lekcja 35 · Podstawowy · Wersja: 4
- JavaScript · Lekcja 37 · Podstawowy · Wersja: 4
- JavaScript · Lekcja 4 · Średniozaawansowany · Wersja: 3
- JavaScript · Lekcja 10 · Średniozaawansowany · Wersja: 3