WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Set.prototype.clear() — alle Elemente entfernen

Set.prototype.clear() entfernt alle Elemente aus einem vorhandenen Set und gibt undefined zurück. Die Methode verändert dasselbe Objekt, sodass jede Referenz auf dieses Objekt die geleerte Sammlung sieht.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

set.clear()

Set.prototype.clear() wird ohne Argumente als set.clear() aufgerufen. Die Methode entfernt alle Elemente; danach ist set.size gleich 0. Auch bei einem leeren Set gibt der Aufruf undefined zurück und lässt das Set leer.

Die Methode verändert das vorhandene Objekt, statt ein neues zu erstellen. Andere Variablen, die auf dasselbe Set verweisen, sehen ebenfalls eine leere Sammlung. Einer Variablen new Set() zuzuweisen, ist nicht gleichwertig: Andere Referenzen zeigen weiterhin auf das vorherige Objekt.

Anders als set.delete(value), das ein angegebenes Element entfernt und einen booleschen Wert zurückgibt, entfernt clear() alle Elemente und gibt undefined zurück. Daher lässt sich set.clear().add(value) nicht verwenden. Das Entfernen von Objekten aus dem Set verändert die Objekte selbst nicht.

Die Methode erfordert einen Empfänger mit dem internen Slot [[SetData]]; Set.prototype.clear.call({}) löst einen TypeError aus. Dies ist eine Funktion der ECMAScript-Standardbibliothek und keine Web-API. Die Sprachspezifikation ist keine Browser-Kompatibilitätstabelle; prüfe die Verfügbarkeit in der Zielumgebung.

Beispiele

const values = new Set([1, 2, 3]);
const alias = values;
const result = values.clear();

console.log(values.size);
console.log(alias === values);
console.log(alias.size);
console.log(result === undefined);

Ergebnis

0
true
0
true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen