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

CKTIS / JavaScript

WeakSet: preverjanje članstva, dodajanje in odstranjevanje

Z `has()` preveriš, ali je vrednost v množici, z `add()` jo dodaš, z `delete()` pa odstraniš. Metode se razlikujejo po vrnjenih vrednostih in odzivu na nedovoljene vrednosti.

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

Sintaksa

weakSet.has(value)    // boolean
weakSet.add(value)    // the same WeakSet instance
weakSet.delete(value) // boolean

WeakSet.prototype.has/add/delete je okrajšava za tri metode na WeakSet.prototype, ne ime ene same metode. Kliči jih na primerku, na primer seen.has(value). Klic brez primerka WeakSet kot this sproži TypeError, tudi če metodo ločiš od primerka in jo pokličeš kot navadno funkcijo.

has(value) vrne true, če je vrednost v množici, sicer false. Množice ne spremeni. add(value) doda vrednost le, če je še ni v množici, in ob uspehu vrne isti primerek, zato lahko klice nizaš. delete(value) vrne true le, če je odstranila element, sicer vrne false. O članstvu odloča identiteta, ne vsebina: dva ločeno ustvarjena objekta { id: 1 } sta različna elementa.

ECMAScript 2024 dovoljuje objekte (tudi funkcije) in neregistrirane simbole, na primer Symbol(). Simboli iz globalnega registra, ki jih vrne Symbol.for(), in druge primitivne vrednosti, kot sta 1 in null, niso dovoljeni. Za nedovoljeno vrednost add() sproži TypeError, has() in delete() pa vrneta false. Starejša izvajalna okolja morda sprejemajo le objekte; preveri podporo za simbole v ciljnem okolju.

Vnos v WeakSet sam po sebi vrednosti ne ohranja pri življenju. Če vrednost ni več dosegljiva prek močnih referenc, lahko zbiralnik smeti sprosti njen pomnilnik; ne zanašaj se na to, kdaj se bo to zgodilo. Po elementih WeakSet ni mogoče iterirati in nima lastnosti size. Uporabi ga za označevanje že obdelanih objektov. Če moraš elemente prehoditi ali prešteti, uporabi Set, ki svoje elemente hrani prek močnih referenc.

Primeri

{
  const seen = new WeakSet();
  const task = { id: 1 };
  const lookalike = { id: 1 };

  console.log(seen.add(task).add(task) === seen);
  console.log(seen.has(task));
  console.log(seen.has(lookalike));
  console.log(seen.delete(task));
  console.log(seen.delete(task));
  console.log(seen.has(task));
  console.log(seen.has(1));
  console.log(seen.delete(1));

  try {
    seen.add(1);
  } catch (error) {
    console.log(error instanceof TypeError);
  }
}

Rezultat

true
true
false
true
false
false
false
false
true

Tudi če `task` dodaš dvakrat, se vrne `seen`. Objekt `lookalike` ima enako vsebino, vendar ni v množici. Le prva odstranitev `task` vrne `true`. Zadnji `true` potrdi vrsto napake pri `add(1)`; izpis ni odvisen od zbiranja smeti.

Povezane lekcije

  • JavaScript · Lekcija 30 · Srednja · Različica: 3

Viri