KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

WeakMap.get() — een waarde opzoeken via een sleutel

`weakMap.get(key)` geeft de waarde bij een sleutel terug. Met `has(key)` onderscheid je een ontbrekende vermelding van een opgeslagen `undefined`.

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

Syntax

weakMap.get(key)

WeakMap.get is een verkorte naam voor de instantiemethode WeakMap.prototype.get, niet voor een statische methode van de constructor. weakMap.get(key) leest de opgeslagen waarde zonder de map te wijzigen. Sleutels komen overeen op basis van identiteit: twee apart aangemaakte objecten met dezelfde eigenschappen zijn verschillende sleutels. Is de opgeslagen waarde een object, dan geeft get() datzelfde object terug, geen kopie.

Een ontbrekende vermelding en een vermelding met de waarde undefined leveren allebei undefined op. Gebruik weakMap.has(key) om ze te onderscheiden: die methode geeft true terug als de vermelding bestaat, ook als de waarde undefined is.

ECMAScript 2024 staat objecten, waaronder functies, en niet-geregistreerde symbolen zoals Symbol('id') toe als sleutels. Oudere engines kunnen WeakMap ondersteunen zonder symbolen als sleutels te accepteren. Op een WeakMap-instantie geeft get() voor een ongeldige sleutel, zoals een tekenreeks of een symbool uit Symbol.for(), undefined terug, terwijl set() een TypeError gooit. get() zelf gooit een TypeError als zijn this geen WeakMap-instantie is, bijvoorbeeld wanneer je de losgekoppelde methode aanroept zonder die aan een instantie te binden.

De map alleen houdt een sleutel niet in leven. Zodra de sleutel niet meer bereikbaar is, kan de bijbehorende vermelding tijdens garbagecollection worden verwijderd. Je kunt de sleutels niet opsommen en er niet op rekenen dat een vermelding op een bepaald moment wordt verwijderd.

Voorbeelden

const weakMap = new WeakMap();
const key = { id: 1 };
const otherKey = { id: 1 };

weakMap.set(key, 42);
console.log(String(weakMap.get(key)));
console.log(String(weakMap.get(otherKey)));

weakMap.set(otherKey, undefined);
console.log(String(weakMap.get(otherKey)));
console.log(String(weakMap.has(otherKey)));
console.log(String(weakMap.get('id')));

Resultaat

42
undefined
undefined
true
undefined

`key` en `otherKey` zijn verschillende objecten, ook al hebben ze dezelfde eigenschappen. Beide opzoekingen met `otherKey` geven `undefined` terug: eerst ontbreekt de vermelding, daarna bestaat die met de waarde `undefined`, zoals `has()` bevestigt. De laatste opzoeking gebruikt een ongeldige sleutel.

Gerelateerde lessen

  • JavaScript · Les 18 · Basis · Versie: 4

Bronnen