Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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ća true ako unos postoji, a inače false.
  • get(key) vraća pohranjenu vrijednost ili undefined ako unosa nema. Upotrijebi has(key) za razlikovanje nepostojećeg unosa od pohranjenog undefined.
  • set(key, value) dodaje unos ili zamjenjuje vrijednost za isti ključ. Prihvaća bilo koju vrijednost JavaScripta i vraća istu instancu WeakMap, 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

Izvori