WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Map.prototype.clear: alle Einträge entfernen

Die Methode clear entfernt alle Schlüssel-Wert-Paare einer Map an Ort und Stelle, setzt ihre sichtbare Größe auf null und liefert undefined.

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

Syntax

map.clear()

map.clear() markiert alle vorhandenen Map-Einträge als leer, ohne eine neue Sammlung zu erzeugen. Danach ist size 0 und has, get sowie Iteration sehen die entfernten Schlüssel nicht. Die Methode hat keine bedeutungsvollen Argumente und liefert stets undefined, daher ist sie nicht wie set verkettbar.

Vorhandene Iteratoren werden nicht ersetzt. Sie überspringen gelöschte Datensätze; ein noch nicht mit done: true beendeter Iterator kann jedoch Einträge sehen, die nach clear derselben Map hinzugefügt werden, weil neue Datensätze an die interne Folge angehängt werden. Das Leeren entfernt Referenzen der Map, Speicherfreigabe hängt aber von weiteren Referenzen und der Garbage Collection ab.

Die Methode verlangt einen Empfänger mit internen Map-Daten; Map.prototype.clear.call({}), ein Set oder ein unbehandelter Proxy um eine Map löst TypeError aus. Sie ist seit ECMAScript 2015 Standard. Verwenden Sie sie, um die Identität einer andernorts beobachteten Map zu erhalten; map = new Map() ändert nur die lokale Referenz.

Beispiele

const map = new Map([["a", 1], ["b", 2]]);
const keys = map.keys();
console.log(keys.next().value);

const result = map.clear();
console.log(result === undefined, map.size);

map.set("c", 3);
const afterClear = keys.next();
console.log(afterClear.value, afterClear.done);

try {
  Map.prototype.clear.call({});
} catch (error) {
  console.log(error instanceof TypeError);
}

Ergebnis

a
true 0
c false
true

Quellen