Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

WeakMap: preverjanje, branje in zapisovanje vnosov z metodami has(), get() in set()

Preveri, ali ključ obstaja, preberi njegovo vrednost ali jo posodobi. Nauči se ločiti manjkajoči vnos od shranjenega `undefined` in prepoznati veljavne ključe.

Različica: 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 je okrajšava za tri metode primerka WeakMap. Ključi se primerjajo po identiteti: dva ločena objekta z enakimi lastnostmi sta različna ključa.

  • has(key) vrne true, če vnos obstaja, sicer false.
  • get(key) vrne shranjeno vrednost ali undefined, če vnosa ni. Z has(key) ločiš manjkajoči vnos od shranjenega undefined.
  • set(key, value) doda vnos ali zamenja vrednost za isti ključ. Sprejme katero koli vrednost JavaScript in vrne isti primerek WeakMap, zato lahko klice verižiš.

ECMAScript 2024 kot ključe dovoljuje objekte (vključno s funkcijami) in neregistrirane simbole, na primer Symbol() in Symbol.iterator, ne pa simbolov, pridobljenih z Symbol.for(). Starejša izvajalna okolja morda kot ključe sprejemajo le objekte; preveri, ali ciljno okolje podpira simbole kot ključe.

Pri neveljavnem ključu, kot je 1, has() vrne false, get() vrne undefined, set() pa sproži izjemo TypeError. Vse tri metode najprej preverijo this: če ni pravi primerek WeakMap, klic ne glede na ključ sproži izjemo TypeError.

Z WeakMap lahko objektu pripišeš metapodatke, ne da bi s tem ohranjal ključ pri življenju, tudi če se shranjena vrednost sklicuje nanj. Ni zagotovljeno, kdaj se bo pomnilnik sprostil. WeakMap ne omogoča iteriranja po ključih in ne ponuja size; uporabi Map, če potrebuješ te možnosti ali želiš kot ključe uporabiti nize ali števila.

Primeri

{
  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` in `lookalike` imata isti `id`, vendar sta različna objekta. Obe branji sprva vrneta `undefined`; samo `has(key)` vrne `true`. Drugi zapis zamenja vrednost z `42` in vrne isto zbirko. Ključ `1` pokaže razliko med branjem in zapisovanjem pri neveljavnem ključu.

Povezane lekcije

  • JavaScript · Lekcija 17 · Napredna · Različica: 4

Viri