CKTIS / JavaScript
WeakMap.prototype.get() — einen Wert anhand seines Schlüssels lesen
Mit `weakMap.get(key)` liest du einen gespeicherten Wert, ohne die WeakMap zu ändern. Mit `has()` unterscheidest du einen fehlenden Eintrag vom gespeicherten Wert `undefined`.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
weakMap.get(key)WeakMap.prototype.get ist eine Instanzmethode, die du als weakMap.get(key) aufrufst. Sie gibt den zum Schlüssel gehörenden Wert zurück, ohne einen Eintrag anzulegen oder zu ändern. Ist der gespeicherte Wert ein Objekt, erhältst du dasselbe Objekt und keine Kopie.
Entscheidend ist die Identität des Schlüssels: Zwei getrennte Objekte mit identischen Eigenschaften sind verschiedene Schlüssel. ECMAScript 2024 erlaubt Objekte und nicht registrierte Symbole als Schlüssel, etwa Symbole aus Symbol(), aber nicht aus Symbol.for(). Ältere Laufzeitumgebungen unterstützen Symbolschlüssel möglicherweise nicht.
get() gibt undefined zurück, wenn der Eintrag fehlt, der Schlüssel unzulässig ist (zum Beispiel ein String) oder der gespeicherte Wert undefined lautet. Mit weakMap.has(key) unterscheidest du gespeichertes undefined (true) von einem fehlenden Eintrag (false). Anders als get() löst set() bei einem unzulässigen Schlüssel einen TypeError aus. get() selbst löst einen TypeError aus, wenn this keine WeakMap-Instanz ist, etwa wenn du die Methode in einer Variablen speicherst und ohne Bindung an die WeakMap aufrufst.
Eine WeakMap hält einen Schlüssel nicht allein dadurch am Leben, dass sie ihn speichert. Ihre Schlüssel lassen sich nicht auflisten, und der Zeitpunkt, zu dem die Speicherbereinigung einen unerreichbaren Schlüssel freigibt, ist nicht vorhersehbar.
Beispiele
{
const weakMap = new WeakMap();
const key = { id: 1 };
const lookalike = { id: 1 };
const pending = {};
weakMap.set(key, 42);
weakMap.set(pending, undefined);
console.log(weakMap.get(key));
console.log(weakMap.get(lookalike));
console.log(weakMap.get(pending));
console.log(weakMap.has(pending));
console.log(weakMap.has(lookalike));
console.log(weakMap.get("id"));
}Ergebnis
42 undefined undefined true false undefined
`lookalike` hat dieselben Eigenschaften wie `key`, ist aber ein anderes Objekt. Für `lookalike` und `pending` liefert `get()` jeweils `undefined`, aber nur für `pending` liefert `has()` den Wert `true`. Die Abfrage mit dem String `"id"` liefert `undefined`, ohne einen Fehler auszulösen.
Zugehörige Lektionen
- JavaScript · Lektion 35 · Grundlagen · Version: 4
- JavaScript · Lektion 37 · Grundlagen · Version: 4
- JavaScript · Lektion 4 · Mittlere Stufe · Version: 3
- JavaScript · Lektion 10 · Mittlere Stufe · Version: 3