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

CKTIS / JavaScript

WeakMap.set(): dodajanje ali zamenjava vrednosti

Z metodo `set()` shraniš vrednost pod ključem v zbirki `WeakMap`. Če ključ že obstaja, metoda njegovo vrednost zamenja. Vrne isto zbirko, zato lahko klice verižiš.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

weakMap.set(key, value)

WeakMap.set označuje metodo primerka WeakMap.prototype.set, ne statične metode konstruktorja WeakMap. weakMap.set(key, value) doda vnos za nov ključ ali zamenja vrednost obstoječega ključa. Vrne isto zbirko WeakMap, zato lahko takoj dodaš nov klic .set(). Vrednost je lahko poljubna. Če izpustiš value, se shrani undefined.

Objektni ključi se primerjajo po identiteti: dva ločeno ustvarjena objekta {} sta različna ključa. ECMAScript 2024 dovoljuje tudi neregistrirane simbole, kot je Symbol(). Starejša izvajalna okolja morda kot ključe podpirajo samo objekte. Če kot ključ uporabiš niz, število, null ali simbol, registriran prek Symbol.for(), metoda sproži TypeError. Enako velja, če this ob klicu ni primerek WeakMap.

Vnos sam po sebi ne ohranja ključa pri življenju. Ko ključ zunaj te šibke povezave ni več dosegljiv, ga lahko zbiralnik smeti odstrani, ni pa zagotovljeno, kdaj se to zgodi. Tako lahko shraniš dodatne podatke o objektu, ne da bi podaljšal njegovo življenjsko dobo. Če potrebuješ nize kot ključe ali želiš iterirati po vnosih, uporabi Map.

Primeri

{
  const statuses = new WeakMap();
  const task = {};
  const otherTask = {};

  const result = statuses.set(task, "pending").set(otherTask, false);
  statuses.set(task, "ready");

  console.log(result === statuses);
  console.log(statuses.get(task));
  console.log(statuses.get(otherTask));
  console.log(statuses.has({}));

  try {
    statuses.set("task", "ready");
  } catch (error) {
    console.log(error instanceof TypeError);
  }
}

Rezultat

true
ready
false
false
true

Prvi `true` pokaže, da veriženi klici vrnejo isto zbirko. `ready` zamenja `pending`. Prvi `false` je vrednost, shranjena za `otherTask`; drugi pomeni, da novi objekt `{}` ni ključ v zbirki. Zadnji `true` potrdi, da je niz kot ključ sprožil `TypeError`.

Povezane lekcije

  • JavaScript · Lekcija 18 · Osnovna · Različica: 4

Viri