KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

WeakMap.set(): een waarde toevoegen of vervangen

Met `set()` sla je in een `WeakMap` een waarde op bij een sleutel. Bestaat de sleutel al, dan wordt de bijbehorende waarde vervangen. De methode geeft dezelfde map terug, zodat je aanroepen kunt koppelen.

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

Syntax

weakMap.set(key, value)

WeakMap.set verwijst naar de instantiemethode WeakMap.prototype.set, niet naar een statische methode van de constructor WeakMap. weakMap.set(key, value) voegt een item toe voor een nieuwe sleutel of vervangt de waarde van een bestaande sleutel. De methode geeft dezelfde WeakMap terug, zodat je meteen nog een .set() kunt aanroepen. Elke waarde is toegestaan. Laat je value weg, dan wordt undefined opgeslagen.

Bij objectsleutels telt de identiteit: twee afzonderlijk gemaakte {}-objecten zijn verschillende sleutels. ECMAScript 2024 staat ook niet-geregistreerde symbolen zoals Symbol() toe. Oudere uitvoeromgevingen ondersteunen mogelijk alleen objecten als sleutels. Een tekenreeks, getal, null of een via Symbol.for() geregistreerd symbool als sleutel veroorzaakt een TypeError. Dat gebeurt ook als this bij de aanroep geen WeakMap-instantie is.

Een item houdt zijn sleutel niet op zichzelf in leven. Zodra de sleutel buiten deze zwakke koppeling niet meer bereikbaar is, kan de garbagecollector hem opruimen. Wanneer dat gebeurt, is niet gegarandeerd. Zo kun je aanvullende gegevens over een object opslaan zonder de levensduur ervan te verlengen. Gebruik Map als je tekenreeksen als sleutels nodig hebt of over de items wilt itereren.

Voorbeelden

{
  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);
  }
}

Resultaat

true
ready
false
false
true

De eerste `true` laat zien dat de gekoppelde aanroepen dezelfde map teruggeven. `ready` vervangt `pending`. De eerste `false` is de opgeslagen waarde voor `otherTask`; de tweede geeft aan dat het nieuwe `{}` geen sleutel in de map is. De laatste `true` bevestigt dat de tekenreeks als sleutel een `TypeError` veroorzaakte.

Gerelateerde lessen

  • JavaScript · Les 18 · Basis · Versie: 4

Bronnen