CKTIS / JavaScript
WeakMap: Einträge lesen, schreiben und löschen
Erfahre, was `get`, `set` und `delete` zurückgeben, welche Schlüssel eine `WeakMap` akzeptiert und wie du einen fehlenden Eintrag von gespeichertem `undefined` unterscheidest.
Version: 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 und delete sind drei Methoden von WeakMap.prototype. Rufe sie auf einer WeakMap-Instanz auf, etwa wm.get(key). Es sind keine statischen Methoden des Konstruktors. Ein Aufruf ohne passende Instanz oder mit einem inkompatiblen this löst einen TypeError aus.
wm.get(key) gibt den gespeicherten Wert zurück oder undefined, wenn der Schlüssel fehlt oder unzulässig ist. Mit wm.has(key) unterscheidest du einen fehlenden Eintrag von gespeichertem undefined. wm.set(key, value) fügt einen Eintrag hinzu oder ersetzt seinen Wert. Die Methode akzeptiert jeden Wert und gibt dieselbe Instanz zurück, sodass sich Aufrufe verketten lassen. wm.delete(key) gibt true zurück, wenn ein Eintrag entfernt wurde, sonst false, auch bei einem unzulässigen Schlüssel. Die Methode entfernt einen Eintrag, keine Objekteigenschaft wie der Operator delete.
ECMAScript 2024 erlaubt Objekte, einschließlich Funktionen, und nicht registrierte Symbole, etwa aus Symbol(), als Schlüssel. Registrierte Symbole aus Symbol.for() und andere primitive Werte sind als Schlüssel unzulässig; set löst dafür einen TypeError aus. Schlüssel werden anhand ihrer Identität verglichen: Zwei getrennte Objekte mit gleichen Eigenschaften sind verschiedene Schlüssel. Prüfe in der Zielumgebung, ob Symbolschlüssel unterstützt werden.
Mit einer WeakMap kannst du Metadaten einem Objekt zuordnen, ohne es allein wegen seiner Rolle als Schlüssel am Leben zu halten. Die Map hält keine starken Referenzen auf ihre Schlüssel. Der Zeitpunkt der Speicherbereinigung ist nicht garantiert, und die Schlüssel lassen sich nicht aufzählen. Verwende Map, wenn du über die Schlüssel iterieren möchtest.
Beispiele
{
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));
}Ergebnis
true 2 undefined true true false undefined
`set` gibt dieselbe Map zurück und ersetzt `1` durch `2`. Das neu erzeugte `{ id: 1 }` ist ein anderer Schlüssel. `has` bestätigt den Eintrag mit `undefined`; nur der erste `delete`-Aufruf entfernt ihn.
Zugehörige Lektionen
- JavaScript · Lektion 3 · Fortgeschritten · Version: 4
- JavaScript · Lektion 7 · Fortgeschritten · Version: 4
- JavaScript · Lektion 41 · Mittlere Stufe · Version: 3