CKTIS / JavaScript
WeakMap: Einträge mit has(), get() und set() prüfen, lesen und schreiben
Prüfe, ob ein Schlüssel vorhanden ist, lies seinen Wert oder ändere ihn. Lerne, einen fehlenden Eintrag von gespeichertem `undefined` zu unterscheiden und gültige Schlüssel zu erkennen.
Version: 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 ist eine Kurzschreibweise für drei Instanzmethoden von WeakMap. Schlüssel werden anhand ihrer Identität verglichen: Zwei getrennte Objekte mit identischen Eigenschaften sind verschiedene Schlüssel.
has(key)gibttruezurück, wenn ein Eintrag vorhanden ist, sonstfalse.get(key)gibt den gespeicherten Wert zurück oderundefined, wenn der Eintrag fehlt. Mithas(key)unterscheidest du einen fehlenden Eintrag von gespeichertemundefined.set(key, value)fügt einen Eintrag hinzu oder ersetzt den Wert zum selben Schlüssel. Die Methode akzeptiert jeden JavaScript-Wert und gibt dieselbeWeakMap-Instanz zurück, sodass du Aufrufe verketten kannst.
ECMAScript 2024 erlaubt Objekte (einschließlich Funktionen) und nicht registrierte Symbole als Schlüssel, etwa Symbol() und Symbol.iterator, aber keine Symbole aus Symbol.for(). Ältere Laufzeitumgebungen akzeptieren möglicherweise nur Objektschlüssel. Prüfe daher die Unterstützung für Symbolschlüssel in deiner Zielumgebung.
Bei einem ungültigen Schlüssel wie 1 gibt has() den Wert false und get() den Wert undefined zurück, während set() einen TypeError auslöst. Alle drei Methoden prüfen zuerst this: Ist this keine echte WeakMap-Instanz, löst der Aufruf unabhängig vom Schlüssel einen TypeError aus.
Mit WeakMap kannst du einem Objekt Metadaten zuordnen, ohne den Schlüssel am Leben zu halten, selbst wenn der gespeicherte Wert auf ihn verweist. Der Zeitpunkt der Speicherbereinigung ist nicht garantiert. WeakMap bietet weder eine Iteration über die Schlüssel noch size. Verwende Map, wenn du das oder Zeichenketten bzw. Zahlen als Schlüssel brauchst.
Beispiele
{
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);
}
}Ergebnis
stored: true, undefined missing: false, undefined updated: 42, same map: true invalid key: false, undefined TypeError
`key` und `lookalike` haben dieselbe `id`, sind aber verschiedene Objekte. Beide Lesezugriffe ergeben zunächst `undefined`; nur `has(key)` liefert `true`. Der zweite Schreibzugriff ersetzt den Wert durch `42` und gibt dieselbe Map zurück. Der Schlüssel `1` zeigt den Unterschied zwischen Lesen und Schreiben bei einem ungültigen Schlüssel.
Zugehörige Lektionen
- JavaScript · Lektion 17 · Fortgeschritten · Version: 4