KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

WeakMap: items lezen, schrijven en verwijderen

Leer wat `get`, `set` en `delete` teruggeven, welke sleutels een `WeakMap` accepteert en hoe je een ontbrekend item onderscheidt van een opgeslagen `undefined`.

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

Syntax

const wm = new WeakMap();
wm.get(key);
wm.set(key, value);
wm.delete(key);

get, set en delete zijn drie methoden van WeakMap.prototype. Roep ze aan op een WeakMap-instantie, zoals in wm.get(key), niet als statische methoden van de constructor. Een aanroep zonder geschikte instantie of met een onverenigbare this veroorzaakt een TypeError.

wm.get(key) geeft de opgeslagen waarde terug, of undefined als de sleutel ontbreekt of ongeldig is. Gebruik wm.has(key) om een ontbrekend item te onderscheiden van een opgeslagen undefined. wm.set(key, value) voegt een item toe of vervangt de waarde ervan. De methode accepteert elke waarde en geeft dezelfde instantie terug, zodat je aanroepen kunt koppelen. wm.delete(key) geeft true terug als een item is verwijderd en false als de sleutel ontbreekt of ongeldig is. De methode verwijdert een item uit de verzameling, geen objecteigenschap zoals de operator delete doet.

ECMAScript 2024 staat objecten, inclusief functies, en niet-geregistreerde symbolen, zoals die uit Symbol(), toe als sleutels. Geregistreerde symbolen uit Symbol.for() en andere primitieve waarden zijn ongeldige sleutels; set veroorzaakt dan een TypeError. Sleutels worden op identiteit vergeleken: twee aparte objecten met dezelfde eigenschappen zijn verschillende sleutels. Controleer of de beoogde uitvoeromgeving sleutels van het type symbool ondersteunt.

Gebruik een WeakMap om metagegevens aan een object te koppelen zonder dat object in leven te houden enkel omdat het een sleutel is. De verzameling houdt geen sterke verwijzingen naar haar sleutels vast. Het tijdstip van garbagecollection is niet gegarandeerd en sleutels kunnen niet worden opgesomd. Gebruik een Map als je over de sleutels wilt itereren.

Voorbeelden

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

  console.log(metadata.set(item, 1) === metadata);
  metadata.set(item, 2);
  console.log(metadata.get(item));
  console.log(metadata.get({ id: 1 }));

  metadata.set(item, undefined);
  console.log(metadata.get(item) === undefined && metadata.has(item));
  console.log(metadata.delete(item));
  console.log(metadata.delete(item));
  console.log(metadata.get(item));
}

Resultaat

true
2
undefined
true
true
false
undefined

`set` geeft dezelfde verzameling terug en vervangt `1` door `2`. Het nieuwe object `{ id: 1 }` is een andere sleutel. `has` bevestigt dat het item met `undefined` bestaat; alleen de eerste aanroep van `delete` verwijdert het.

Gerelateerde lessen

  • JavaScript · Les 3 · Gevorderd · Versie: 4
  • JavaScript · Les 7 · Gevorderd · Versie: 4
  • JavaScript · Les 41 · Gemiddeld · Versie: 3

Bronnen