CKTIS / JavaScript
WeakMap.set(): einen Wert hinzufügen oder ersetzen
Mit `set()` speicherst du einen Wert zu einem Schlüssel in einer `WeakMap`. Existiert der Schlüssel bereits, wird sein Wert ersetzt. 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.set bezeichnet die Instanzmethode WeakMap.prototype.set, keine statische Methode des Konstruktors WeakMap. weakMap.set(key, value) fügt für einen neuen Schlüssel einen Eintrag hinzu oder ersetzt den Wert eines vorhandenen Schlüssels. Die Methode gibt dieselbe WeakMap zurück, sodass du direkt ein weiteres .set() anhängen kannst. Jeder Wert ist zulässig. Lässt du value weg, wird undefined gespeichert.
Bei Objektschlüsseln zählt die Identität: Zwei getrennt erzeugte {}-Objekte sind verschiedene Schlüssel. ECMAScript 2024 erlaubt auch nicht registrierte Symbole wie Symbol(). Ältere Laufzeitumgebungen unterstützen möglicherweise nur Objektschlüssel. Eine Zeichenkette, eine Zahl, null oder ein mit Symbol.for() registriertes Symbol führt als Schlüssel zu einem TypeError. Das gilt auch, wenn this beim Aufruf keine WeakMap-Instanz ist.
Ein Eintrag allein hält seinen Schlüssel nicht am Leben. Ist der Schlüssel außerhalb dieser schwachen Zuordnung nicht mehr erreichbar, kann ihn die Speicherbereinigung entfernen. Wann das geschieht, ist nicht garantiert. So kannst du zusätzliche Daten zu einem Objekt speichern, ohne seine Lebensdauer zu verlängern. Verwende Map, wenn du Zeichenketten als Schlüssel brauchst oder über die Einträge iterieren möchtest.
Beispiele
{
const statuses = new WeakMap();
const task = {};
const otherTask = {};
const result = statuses.set(task, "pending").set(otherTask, false);
statuses.set(task, "ready");
console.log(result === statuses);
console.log(statuses.get(task));
console.log(statuses.get(otherTask));
console.log(statuses.has({}));
try {
statuses.set("task", "ready");
} catch (error) {
console.log(error instanceof TypeError);
}
}Ergebnis
true ready false false true
Das erste `true` zeigt, dass die verketteten Aufrufe dieselbe Map zurückgeben. `ready` ersetzt `pending`. Das erste `false` ist der gespeicherte Wert für `otherTask`, das zweite bedeutet, dass das neue `{}` kein Schlüssel in der Map ist. Das letzte `true` bestätigt den `TypeError` für die Zeichenkette als Schlüssel.
Zugehörige Lektionen
- JavaScript · Lektion 18 · Grundlagen · Version: 4