Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

WeakMap.prototype.set(): spremanje vrijednosti pod ključem

Metoda `set()` dodaje unos u `WeakMap` ili zamjenjuje vrijednost postojećeg ključa. Vraća istu instancu pa se pozivi mogu ulančati.

Verzija: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

weakMap.set(key, value)

WeakMap.prototype.set metoda je prototipa koju pozivaš na instanci: weakMap.set(key, value). Dodaje unos za novi ključ ili zamjenjuje vrijednost za isti ključ. Vraća istu instancu, a ne spremljenu vrijednost, pa se može ulančati još jedan poziv .set(). Vrijednost može biti bilo koja vrijednost u JavaScriptu, uključujući undefined.

Objekti koji služe kao ključevi uspoređuju se po identitetu: dva odvojena objekta s jednakim svojstvima različiti su ključevi. ECMAScript 2024 dopušta i neregistrirane simbole poput Symbol("id"). Simboli dobiveni pozivom Symbol.for("id") i druge primitivne vrijednosti, kao što su znakovni nizovi, nisu valjani ključevi. Starija izvršna okruženja možda ne podržavaju simbole kao ključeve; provjeri ciljno okruženje.

Nevaljani ključ izaziva pogrešku TypeError. Poziv metode odvojene od instance bez ispravnog this također izaziva pogrešku TypeError: primatelj poziva mora biti instanca WeakMap.

Sam unos ne održava ključ na životu. Ako ključ više nije dostupan drugim putem, mehanizam za automatsko oslobađanje memorije može ga ukloniti; nemoj se oslanjati na to kada će se to dogoditi. Ključeve WeakMap nije moguće pobrojiti. Ako trebaš prolaziti kroz ključeve ili upotrebljavati znakovne nizove kao ključeve, umjesto toga upotrijebi Map.

Primjeri

{
  const metadata = new WeakMap();
  const item = { id: 1 };

  metadata.set(item, 10);
  console.log(metadata.get(item));

  const returned = metadata.set(item, 20);
  console.log(returned === metadata);
  console.log(metadata.get(item));
  console.log(metadata.has({ id: 1 }));

  try {
    metadata.set("id", 30);
  } catch (error) {
    console.log(error instanceof TypeError);
  }
}

Rezultat

10
true
20
false
true

Prvo čitanje vraća `10`, a čitanje nakon ažuriranja vraća `20`. Usporedba `returned === metadata` daje `true`. Novi objekt s istim `id` nije spremljeni ključ, pa `has()` vraća `false`. Pokušaj upotrebe znakovnog niza kao ključa izaziva pogrešku `TypeError`, koju kod hvata.

Povezane lekcije

  • JavaScript · Lekcija 35 · Osnovno · Verzija: 4
  • JavaScript · Lekcija 37 · Osnovno · Verzija: 4
  • JavaScript · Lekcija 4 · Srednje · Verzija: 3
  • JavaScript · Lekcija 10 · Srednje · Verzija: 3

Izvori