KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

WeakSet: elementen controleren met has() en toevoegen met add()

Gebruik `has()` om te controleren of een waarde in een `WeakSet` zit en `add()` om die toe te voegen. Lidmaatschap draait om identiteit; de verzameling houdt haar elementen niet in leven.

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

Syntax

const seen = new WeakSet();
seen.has(value);
seen.add(value);

WeakSet.prototype.has en WeakSet.prototype.add zijn twee instantiemethoden. seen.has(value) geeft true terug als de waarde aanwezig is en anders false. seen.add(value) voegt de waarde toe als die nog ontbreekt en geeft dezelfde WeakSet-instantie terug. Opnieuw toevoegen levert geen duplicaat op. Dankzij de retourwaarde kun je add()-aanroepen aan elkaar koppelen.

Lidmaatschap wordt bepaald door identiteit, niet door inhoud: twee referenties naar hetzelfde object duiden hetzelfde element aan, maar twee afzonderlijke objecten met identieke eigenschappen komen niet overeen. ECMAScript 2024 staat objecten (waaronder functies) en niet-geregistreerde symbolen toe, zoals symbolen die met Symbol() zijn gemaakt. Voor een symbool uit Symbol.for(), een getal, een tekenreeks of null geeft has() false terug en gooit add() een TypeError. Beide methoden gooien ook een TypeError als this geen WeakSet-instantie is, bijvoorbeeld als je een losgehaalde methode aanroept zonder die aan de instantie te binden.

Opname in de verzameling voorkomt op zichzelf niet dat de garbagecollector een waarde opruimt. Je kunt niet voorspellen wanneer dat gebeurt. Een WeakSet heeft geen size en is niet itereerbaar. Gebruik hem om al verwerkte objecten te markeren als je ze later niet hoeft op te sommen. Kies Set als je wilt itereren, de grootte nodig hebt of waarden zoals getallen en tekenreeksen wilt opslaan.

Ondersteuning voor symbolen kan per runtime verschillen. Als je ervan afhankelijk bent, test add() dan in de beoogde runtime met een waarde die je met Symbol() hebt gemaakt; alleen controleren of WeakSet bestaat is niet genoeg.

Voorbeelden

{
  const seen = new WeakSet();
  const item = { id: 1 };
  const alias = item;

  console.log(seen.has(item));
  console.log(seen.add(item).add(item) === seen);
  console.log(seen.has(alias));
  console.log(seen.has({ id: 1 }));
  console.log(seen.has(1));

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

Resultaat

false
true
true
false
false
TypeError

De eerste `has()`-aanroep geeft `false` terug. De twee `add()`-aanroepen zijn te koppelen omdat de methode dezelfde instantie teruggeeft. `alias` verwijst naar het toegevoegde object; een nieuw object met dezelfde `id` komt niet overeen. Voor het getal `1` geeft de controle `false` terug en gooit het toevoegen de afgevangen `TypeError`.

Gerelateerde lessen

  • JavaScript · Les 17 · Gevorderd · Versie: 4
  • JavaScript · Les 43 · Gevorderd · Versie: 4
  • JavaScript · Les 45 · Gevorderd · Versie: 4
  • JavaScript · Les 40 · Gemiddeld · Versie: 3

Bronnen