CKTIS / JavaScript
WeakMap.prototype.delete() — einen Eintrag entfernen
Mit `weakMap.delete(key)` entfernst du den Eintrag zum angegebenen Schlüssel. Die Methode liefert `true`, wenn sie einen Eintrag entfernt hat, sonst `false`.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
weakMap.delete(key)WeakMap.delete ist eine Kurzbezeichnung für die Instanzmethode WeakMap.prototype.delete. Rufe sie als weakMap.delete(key) auf, nicht als statische Methode des Konstruktors WeakMap. Sie entfernt die Zuordnung zwischen Schlüssel und Wert nur aus dieser Map. Anders als der Operator delete entfernt sie keine Objekteigenschaft.
true bedeutet, dass ein Eintrag vorhanden war und entfernt wurde, selbst wenn sein Wert undefined war. Fehlt der Eintrag, lautet das Ergebnis false. Bei Objektschlüsseln zählt die Identität: Zwei verschiedene Objekte mit gleichen Eigenschaften stimmen nicht überein. Nach dem Entfernen liefert weakMap.has(key) den Wert false, solange für den Schlüssel kein neuer Eintrag angelegt wird.
ECMAScript 2024 erlaubt Objekte und nicht registrierte Symbole wie Symbol() als Schlüssel, aber keine Symbole aus Symbol.for(). Die Unterstützung für Symbolschlüssel hängt von der Laufzeitumgebung ab. Auf einer gültigen Instanz liefert delete() bei einem ungültigen Schlüssel wie einem String oder bei fehlendem Argument false. set() löst bei einem ungültigen Schlüssel einen TypeError aus. Auch delete() löst ohne gültige Instanz als this einen TypeError aus.
Eine WeakMap hält ein Objekt nicht allein deshalb am Leben, weil es ein Schlüssel ist. Das explizite Löschen entfernt den Eintrag sofort, auch wenn der Code den Schlüssel noch referenziert. Es zerstört weder das Objekt noch erzwingt es eine Speicherbereinigung.
Beispiele
{
const notes = new WeakMap();
const key = { id: 1 };
notes.set(key, undefined);
console.log(notes.delete({ id: 1 }));
console.log(notes.delete(key));
console.log(notes.has(key));
console.log(notes.delete(key));
console.log(notes.delete("id"));
}Ergebnis
false true false false false
Das separate Objekt `{ id: 1 }` stimmt nicht mit `key` überein. Das Löschen mit `key` liefert trotz des gespeicherten Werts `undefined` den Wert `true`. Danach liefern `has()`, erneutes Löschen und ein Löschversuch mit einem String als Schlüssel jeweils `false`.
Zugehörige Lektionen
- JavaScript · Lektion 18 · Grundlagen · Version: 4