KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

WeakMap: items controleren, lezen en schrijven met has(), get() en set()

Controleer of een sleutel aanwezig is, lees de waarde of werk die bij. Leer een ontbrekend item te onderscheiden van opgeslagen `undefined` en herken geldige sleutels.

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

Syntax

weakMap.has(key)
weakMap.get(key)
weakMap.set(key, value)

WeakMap.prototype.has/get/set is een verkorte aanduiding voor drie instantiemethoden van WeakMap. Sleutels worden vergeleken op identiteit: twee afzonderlijke objecten met identieke eigenschappen zijn verschillende sleutels.

  • has(key) retourneert true als er een item voor de sleutel bestaat, anders false.
  • get(key) retourneert de opgeslagen waarde, of undefined als het item ontbreekt. Gebruik has(key) om een ontbrekend item te onderscheiden van een opgeslagen undefined.
  • set(key, value) voegt een item toe of vervangt de waarde bij dezelfde sleutel. De methode accepteert elke JavaScript-waarde en retourneert dezelfde WeakMap-instantie, zodat je aanroepen kunt koppelen.

ECMAScript 2024 staat objecten (waaronder functies) en niet-geregistreerde symbolen toe als sleutels, bijvoorbeeld Symbol() en Symbol.iterator, maar geen symbolen uit Symbol.for(). Oudere uitvoeromgevingen accepteren mogelijk alleen objecten als sleutels; controleer of de beoogde omgeving symbolen als sleutels ondersteunt.

Bij een ongeldige sleutel zoals 1 retourneert has() de waarde false en get() de waarde undefined, terwijl set() een TypeError veroorzaakt. Alle drie de methoden controleren eerst this: als dat geen echte WeakMap-instantie is, veroorzaakt de aanroep ongeacht de sleutel een TypeError.

Gebruik WeakMap om metadata aan een object te koppelen zonder de sleutel in leven te houden, zelfs als de opgeslagen waarde naar de sleutel verwijst. Wanneer het geheugen wordt vrijgegeven, is niet gegarandeerd. Met WeakMap kun je niet over de sleutels itereren en heb je geen size. Gebruik Map als je die mogelijkheden nodig hebt of tekenreeksen of getallen als sleutels wilt gebruiken.

Voorbeelden

{
  const map = new WeakMap();
  const key = { id: 1 };
  const lookalike = { id: 1 };

  map.set(key, undefined);
  console.log(`stored: ${map.has(key)}, ${map.get(key)}`);
  console.log(`missing: ${map.has(lookalike)}, ${map.get(lookalike)}`);

  const result = map.set(key, 42);
  console.log(`updated: ${map.get(key)}, same map: ${result === map}`);

  console.log(`invalid key: ${map.has(1)}, ${map.get(1)}`);
  try {
    map.set(1, 42);
  } catch (error) {
    console.log(error.name);
  }
}

Resultaat

stored: true, undefined
missing: false, undefined
updated: 42, same map: true
invalid key: false, undefined
TypeError

`key` en `lookalike` hebben dezelfde `id`, maar zijn verschillende objecten. Beide leesacties geven aanvankelijk `undefined`; alleen `has(key)` geeft `true`. De tweede schrijfactie vervangt de waarde door `42` en retourneert dezelfde map. Met sleutel `1` zie je hoe lezen en schrijven verschillen bij een ongeldige sleutel.

Gerelateerde lessen

  • JavaScript · Les 17 · Gevorderd · Versie: 4

Bronnen