CKTIS / JavaScript
WeakMap: provjera, čitanje i upis unosa metodama has(), get() i set()
Provjeri postoji li ključ, pročitaj njegovu vrijednost ili je ažuriraj. Nauči razlikovati nepostojeći unos od pohranjenog `undefined` i prepoznati valjane ključeve.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
weakMap.has(key)
weakMap.get(key)
weakMap.set(key, value)WeakMap.prototype.has/get/set skraćeni je naziv za tri metode instance WeakMap. Ključevi se uspoređuju po identitetu: dva zasebna objekta s jednakim svojstvima različiti su ključevi.
has(key)vraćatrueako unos postoji, a inačefalse.get(key)vraća pohranjenu vrijednost iliundefinedako unosa nema. Upotrijebihas(key)za razlikovanje nepostojećeg unosa od pohranjenogundefined.set(key, value)dodaje unos ili zamjenjuje vrijednost za isti ključ. Prihvaća bilo koju vrijednost JavaScripta i vraća istu instancuWeakMap, pa možeš ulančati pozive.
ECMAScript 2024 dopušta objekte (uključujući funkcije) i neregistrirane simbole kao ključeve, primjerice Symbol() i Symbol.iterator, ali ne simbole dobivene pomoću Symbol.for(). Starija izvršna okruženja možda prihvaćaju samo objekte kao ključeve; provjeri podržava li ciljno okruženje simbole kao ključeve.
Za nevaljani ključ kao što je 1, has() vraća false, get() vraća undefined, a set() baca iznimku TypeError. Sve tri metode najprije provjeravaju this: ako nije stvarna instanca WeakMap, poziv baca iznimku TypeError neovisno o ključu.
Pomoću WeakMap možeš objektu pridružiti metapodatke bez održavanja ključa na životu, čak i kad pohranjena vrijednost upućuje na ključ. Nema jamstva kada će se memorija osloboditi. WeakMap ne omogućuje prolazak kroz ključeve i ne nudi size; upotrijebi Map ako ti trebaju te mogućnosti ili želiš nizove znakova ili brojeve kao ključeve.
Primjeri
{
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);
}
}Rezultat
stored: true, undefined missing: false, undefined updated: 42, same map: true invalid key: false, undefined TypeError
`key` i `lookalike` imaju isti `id`, ali su različiti objekti. Oba čitanja najprije vraćaju `undefined`; samo `has(key)` vraća `true`. Drugi upis zamjenjuje vrijednost brojem `42` i vraća istu mapu. Ključ `1` pokazuje razliku između čitanja i upisa za nevaljani ključ.
Povezane lekcije
- JavaScript · Lekcija 17 · Napredno · Verzija: 4