WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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) gibt true zurück, wenn ein Eintrag vorhanden ist, sonst false.
  • get(key) gibt den gespeicherten Wert zurück oder undefined, wenn der Eintrag fehlt. Mit has(key) unterscheidest du einen fehlenden Eintrag von gespeichertem undefined.
  • set(key, value) fügt einen Eintrag hinzu oder ersetzt den Wert zum selben Schlüssel. Die Methode akzeptiert jeden JavaScript-Wert und gibt dieselbe WeakMap-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

Quellen