CKTIS / JavaScript
WeakMap.get() – einen Wert per Schlüssel lesen
`weakMap.get(key)` liefert den Wert zu einem Schlüssel. Mit `has(key)` lässt sich ein fehlender Eintrag von einem gespeicherten `undefined` unterscheiden.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
weakMap.get(key)WeakMap.get ist die Kurzbezeichnung für die Instanzmethode WeakMap.prototype.get, nicht für eine statische Methode des Konstruktors. weakMap.get(key) liest den gespeicherten Wert, ohne die Map zu ändern. Entscheidend ist die Identität des Schlüssels: Zwei separat erzeugte Objekte mit gleichen Eigenschaften sind verschiedene Schlüssel. Ist der gespeicherte Wert ein Objekt, gibt get() genau dieses Objekt zurück, keine Kopie.
Ein fehlender Eintrag und ein Eintrag mit dem Wert undefined liefern beide undefined. Mit weakMap.has(key) kannst du sie unterscheiden: Die Methode liefert true, wenn der Eintrag existiert, auch wenn sein Wert undefined ist.
ECMAScript 2024 erlaubt Objekte, einschließlich Funktionen, und nicht registrierte Symbole wie Symbol('id') als Schlüssel. Ältere Engines können WeakMap unterstützen, aber keine Symbolschlüssel. Auf einer WeakMap-Instanz gibt get() für einen ungültigen Schlüssel, etwa eine Zeichenkette oder ein von Symbol.for() zurückgegebenes Symbol, undefined zurück; set() löst dagegen einen TypeError aus. get() selbst löst einen TypeError aus, wenn sein this keine WeakMap-Instanz ist, etwa beim Aufruf der losgelösten Methode ohne Bindung an eine Instanz.
Die Map allein hält einen Schlüssel nicht am Leben. Sobald der Schlüssel nicht mehr erreichbar ist, kann sein Eintrag bei der automatischen Speicherbereinigung entfernt werden. Du kannst die Schlüssel weder aufzählen noch dich darauf verlassen, dass ein Eintrag zu einem bestimmten Zeitpunkt entfernt wird.
Beispiele
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')));Ergebnis
42 undefined undefined true undefined
`key` und `otherKey` sind trotz gleicher Eigenschaften verschiedene Objekte. Beide Abfragen mit `otherKey` liefern `undefined`: Zuerst fehlt der Eintrag, danach existiert er mit dem Wert `undefined`, wie `has()` bestätigt. Die letzte Abfrage verwendet einen ungültigen Schlüssel.
Zugehörige Lektionen
- JavaScript · Lektion 18 · Grundlagen · Version: 4