WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

WeakMap.prototype.set(): einen Wert zu einem Schlüssel speichern

Mit `set()` fügst du einen Eintrag zu einer `WeakMap` hinzu oder ersetzt den Wert eines vorhandenen Schlüssels. Die Methode gibt dieselbe Map zurück, sodass sich Aufrufe verketten lassen.

Version: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

weakMap.set(key, value)

WeakMap.prototype.set ist eine Prototypmethode, die du an einer Instanz aufrufst: weakMap.set(key, value). Sie fügt einen Eintrag für einen neuen Schlüssel hinzu oder ersetzt den Wert zum selben Schlüssel. Sie gibt dieselbe Instanz statt des gespeicherten Werts zurück, sodass du einen weiteren .set()-Aufruf anhängen kannst. Der Wert kann ein beliebiger JavaScript-Wert sein, auch undefined.

Objektschlüssel werden anhand ihrer Identität verglichen: Zwei verschiedene Objekte mit identischen Eigenschaften sind unterschiedliche Schlüssel. ECMAScript 2024 erlaubt auch nicht registrierte Symbole wie Symbol("id"). Symbole aus Symbol.for("id") und andere primitive Werte wie Zeichenketten sind keine gültigen Schlüssel. Ältere Laufzeitumgebungen unterstützen Symbolschlüssel möglicherweise nicht; prüfe deine Zielumgebung.

Ein ungültiger Schlüssel löst einen TypeError aus. Auch der Aufruf der losgelösten Methode ohne passendes this löst einen TypeError aus: Der Empfänger muss eine WeakMap-Instanz sein.

Der Eintrag allein hält den Schlüssel nicht am Leben. Ist der Schlüssel nicht mehr auf anderem Wege erreichbar, kann ihn die Speicherbereinigung entfernen; verlasse dich nicht auf den Zeitpunkt. Die Schlüssel einer WeakMap lassen sich nicht aufzählen. Wenn du über die Schlüssel iterieren oder Zeichenketten als Schlüssel verwenden möchtest, nimm stattdessen eine Map.

Beispiele

{
  const metadata = new WeakMap();
  const item = { id: 1 };

  metadata.set(item, 10);
  console.log(metadata.get(item));

  const returned = metadata.set(item, 20);
  console.log(returned === metadata);
  console.log(metadata.get(item));
  console.log(metadata.has({ id: 1 }));

  try {
    metadata.set("id", 30);
  } catch (error) {
    console.log(error instanceof TypeError);
  }
}

Ergebnis

10
true
20
false
true

Der erste Abruf ergibt `10`, nach der Aktualisierung ergibt er `20`. Der Vergleich `returned === metadata` ergibt `true`. Ein neues Objekt mit derselben `id` ist nicht der gespeicherte Schlüssel, deshalb gibt `has()` den Wert `false` zurück. Der Versuch, eine Zeichenkette als Schlüssel zu verwenden, löst einen `TypeError` aus, der abgefangen wird.

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

Quellen