CKTIS / JavaScript
WeakMap: sprawdzanie, odczyt i zapis za pomocą has(), get() i set()
Sprawdź, czy klucz istnieje, odczytaj jego wartość lub ją zmień. Dowiedz się, jak odróżnić brak wpisu od zapisanego `undefined` i jakie klucze przyjmuje `WeakMap`.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
weakMap.has(key)
weakMap.get(key)
weakMap.set(key, value)WeakMap.prototype.has/get/set to skrót oznaczający trzy metody instancji WeakMap. Klucze porównuje się według tożsamości: dwa osobne obiekty o identycznych właściwościach to różne klucze.
has(key)zwracatrue, jeśli wpis istnieje, a w przeciwnym raziefalse.get(key)zwraca zapisaną wartość alboundefined, jeśli wpisu nie ma. Użyjhas(key), aby odróżnić brak wpisu od zapisanegoundefined.set(key, value)dodaje wpis lub zastępuje wartość pod tym samym kluczem. Przyjmuje dowolną wartość JavaScript i zwraca tę samą instancjęWeakMap, co pozwala łączyć wywołania.
ECMAScript 2024 dopuszcza jako klucze obiekty (w tym funkcje) oraz niezarejestrowane symbole, np. Symbol() i Symbol.iterator, ale nie symbole z Symbol.for(). Starsze środowiska mogą obsługiwać tylko klucze obiektowe; sprawdź obsługę symboli w docelowym środowisku.
Dla niedozwolonego klucza, np. 1, has() zwraca false, get() zwraca undefined, a set() zgłasza TypeError. Wszystkie trzy metody najpierw sprawdzają this: wywołanie z this, które nie jest rzeczywistą instancją WeakMap, zgłasza TypeError niezależnie od klucza.
WeakMap nadaje się do przechowywania metadanych obiektu bez utrzymywania samego klucza przy życiu, nawet gdy zapisana wartość odwołuje się do klucza. Moment odzyskania pamięci nie jest gwarantowany. WeakMap nie pozwala iterować po kluczach ani nie udostępnia size; użyj Map, jeśli potrzebujesz tych możliwości lub kluczy tekstowych czy liczbowych.
Przykłady
{
const map = new WeakMap();
const key = { id: 1 };
const lookalike = { id: 1 };
map.set(key, undefined);
console.log(`stored: ${map.has(key)}, ${map.get(key)}`);
console.log(`missing: ${map.has(lookalike)}, ${map.get(lookalike)}`);
const result = map.set(key, 42);
console.log(`updated: ${map.get(key)}, same map: ${result === map}`);
console.log(`invalid key: ${map.has(1)}, ${map.get(1)}`);
try {
map.set(1, 42);
} catch (error) {
console.log(error.name);
}
}Wynik
stored: true, undefined missing: false, undefined updated: 42, same map: true invalid key: false, undefined TypeError
`key` i `lookalike` mają takie samo `id`, ale są różnymi obiektami. Oba odczyty dają początkowo `undefined`; tylko `has(key)` zwraca `true`. Drugi zapis zastępuje wartość liczbą `42` i zwraca tę samą mapę. Klucz `1` pokazuje różnicę między odczytem a zapisem dla niedozwolonego klucza.
Powiązane lekcje
- JavaScript · Lekcja 17 · Zaawansowany · Wersja: 4