WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Map.prototype.delete: Eintrag nach Schlüssel entfernen

Die Methode delete entfernt den zum angegebenen Schlüssel passenden Map-Eintrag und liefert nur dann true, wenn er vorhanden war.

Version: ECMAScript 2015 onward; example target: Node.js 24.22.2

Syntax

map.delete(key)

map.delete(key) sucht den Schlüssel ohne Typumwandlung. Existiert ein Eintrag, wird sein Datensatz als leer markiert und true geliefert; andernfalls bleibt die Map unverändert und false wird geliefert. Das ganze Schlüssel-Wert-Paar wird entfernt, size sinkt nur bei erfolgreichem Löschen um eins.

Schlüssel verwenden SameValueZero: NaN passt zu NaN, -0 zu +0; Objekte passen nur durch Referenzidentität. Die Reihenfolge übriger Einträge bleibt erhalten. Ein späteres set desselben Schlüssels erzeugt einen neuen Datensatz am Ende der Iterationsreihenfolge, aktive Iteratoren überspringen den gelöschten Datensatz.

Der Empfänger muss eine echte Map mit internen Map-Daten sein; Objekt, Set oder unbehandelter Proxy als this löst TypeError aus. Die Methode ist seit ECMAScript 2015 Standard. Ihr boolesches Ergebnis unterscheidet einen fehlenden Schlüssel von einem vorhandenen Eintrag mit dem Wert undefined.

Beispiele

const token = {};
const map = new Map([[token, "active"], [NaN, "unknown"], ["tail", 3]]);
console.log(map.delete({}), map.size);
console.log(map.delete(token), map.has(token), map.size);
console.log(map.delete(NaN), map.delete(NaN));

const ordered = new Map([["a", 1], ["b", 2]]);
ordered.delete("a");
ordered.set("a", 3);
console.log([...ordered.keys()].join(","));

try {
  Map.prototype.delete.call({}, "a");
} catch (error) {
  console.log(error instanceof TypeError);
}

Ergebnis

false 3
true false 2
true false
b,a
true

Quellen