CKTIS / JavaScript
WeakMap: odczyt, zapis i usuwanie wpisów
Poznaj metody `get`, `set` i `delete` kolekcji `WeakMap`: sprawdź, jakie klucze przyjmują, co zwracają i jak odróżnić brak wpisu od zapisanej wartości `undefined`.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
const wm = new WeakMap();
wm.get(key);
wm.set(key, value);
wm.delete(key);get, set i delete to trzy metody z WeakMap.prototype, wywoływane na instancji WeakMap, np. wm.get(key). Nie są to metody statyczne konstruktora. Wywołanie metody bez powiązania jej z instancją lub z niezgodną wartością this powoduje TypeError.
wm.get(key) zwraca zapisaną wartość albo undefined, jeśli klucza nie ma lub jest niedozwolony. Użyj wm.has(key), aby odróżnić brak wpisu od zapisanej wartości undefined. wm.set(key, value) dodaje wpis lub zastępuje wartość istniejącego wpisu. Przyjmuje dowolną wartość i zwraca tę samą instancję, więc wywołania można łączyć. wm.delete(key) zwraca true, jeśli usunęło wpis, albo false, jeśli klucza nie ma lub jest niedozwolony. Metoda usuwa wpis, nie właściwość obiektu, jak operator delete.
ECMAScript 2024 dopuszcza jako klucze obiekty, w tym funkcje, oraz niezarejestrowane symbole, np. utworzone przez Symbol(). Zarejestrowane symbole z Symbol.for() i pozostałe typy prymitywne są niedozwolone jako klucze; set zgłasza dla nich TypeError. Klucze są porównywane według tożsamości: dwa oddzielne obiekty o tych samych właściwościach to różne klucze. Sprawdź obsługę kluczy symbolicznych w docelowym środowisku wykonawczym.
Użyj WeakMap, aby powiązać metadane z obiektem bez przedłużania jego życia tylko dlatego, że jest kluczem. Kolekcja nie utrzymuje silnej referencji do klucza. Moment odzyskania pamięci nie jest gwarantowany, a kluczy nie można wyliczać. Jeśli potrzebujesz iteracji po kluczach, wybierz Map.
Przykłady
{
const metadata = new WeakMap();
const item = { id: 1 };
console.log(metadata.set(item, 1) === metadata);
metadata.set(item, 2);
console.log(metadata.get(item));
console.log(metadata.get({ id: 1 }));
metadata.set(item, undefined);
console.log(metadata.get(item) === undefined && metadata.has(item));
console.log(metadata.delete(item));
console.log(metadata.delete(item));
console.log(metadata.get(item));
}Wynik
true 2 undefined true true false undefined
`set` zwraca tę samą mapę i zastępuje `1` przez `2`. Nowy obiekt `{ id: 1 }` nie jest tym samym kluczem. `has` potwierdza obecność wpisu z `undefined`; tylko pierwsze wywołanie `delete` go usuwa.
Powiązane lekcje
- JavaScript · Lekcja 3 · Zaawansowany · Wersja: 4
- JavaScript · Lekcja 7 · Zaawansowany · Wersja: 4
- JavaScript · Lekcja 41 · Średniozaawansowany · Wersja: 3