WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

WeakMap.prototype.delete(): Einen Eintrag per Schlüssel löschen

Lösche einen Eintrag aus einer `WeakMap`. Am booleschen Rückgabewert erkennst du, ob tatsächlich ein Eintrag entfernt wurde.

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

Syntax

weakMap.delete(key)

WeakMap.prototype.delete ist eine Instanzmethode. Mit weakMap.delete(key) entfernst du den Eintrag zu key aus dieser Map. Die Methode gibt nur dann true zurück, wenn sie einen vorhandenen Eintrag entfernt hat, selbst wenn dessen Wert undefined war. Ist kein Eintrag vorhanden, gibt sie false zurück.

Schlüssel werden anhand ihrer Identität verglichen: Zwei separate Objekte mit denselben Eigenschaften sind unterschiedliche Schlüssel. ECMAScript 2024 erlaubt Objekte und nicht registrierte Symbole, etwa solche, die mit Symbol() erzeugt wurden. Ob Symbolschlüssel unterstützt werden, hängt von der Laufzeitumgebung ab. Bei einem ungültigen Schlüssel, etwa einer Zeichenkette oder einem Symbol aus Symbol.for(), gibt delete() den Wert false zurück, während set() einen TypeError auslöst. Ein Aufruf mit einem ungültigen this, etwa WeakMap.prototype.delete.call({}, key), löst ebenfalls einen TypeError aus.

Die Methode entfernt die Zuordnung sofort. Sie verändert das Schlüsselobjekt nicht, löscht anders als der Operator delete keine seiner Eigenschaften und erzwingt keine Speicherbereinigung. Verwende sie, wenn du die gespeicherte Zuordnung nicht mehr brauchst, der Schlüssel aber noch verfügbar ist.

Beispiele

{
  const weakMap = new WeakMap();
  const key = { id: 1 };
  weakMap.set(key, undefined);

  console.log(weakMap.delete({ id: 1 }));
  console.log(weakMap.delete(key));
  console.log(weakMap.has(key));
  console.log(weakMap.delete(key));
  console.log(weakMap.delete("id"));
}

Ergebnis

false
true
false
false
false

Das neue Objekt `{ id: 1 }` stimmt nicht mit dem gespeicherten Schlüssel überein. Mit dem ursprünglichen `key` wird der Eintrag trotz des Werts `undefined` entfernt. Die Abfrage mit `has()`, das erneute Löschen und der Versuch mit einer Zeichenkette als Schlüssel liefern jeweils `false`.

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