WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Set.prototype.delete — einen Wert aus einer Menge entfernen

Set.prototype.delete(value) entfernt den angegebenen Wert aus einer vorhandenen Menge. Die Methode gibt true zurück, wenn ein Wert entfernt wurde, andernfalls false. Objekte werden anhand ihrer Identität und nicht anhand ihres Inhalts verglichen.

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.delete(value)

set.delete(value) verändert ein vorhandenes Set: Die Methode entfernt den passenden Wert und gibt true zurück. Ist der Wert nicht vorhanden, gibt sie false zurück, ohne die Menge zu verändern. Das Argument bezeichnet einen Wert, keinen Index. Das Ergebnis ist ein boolescher Wert und nicht die Menge; deshalb lassen sich aufeinanderfolgende Aufrufe von .delete() nicht verketten.

Der Vergleich folgt der Semantik von SameValueZero: NaN passt zu NaN, und +0 und -0 gelten als derselbe Wert. Objekte werden anhand ihrer Identität verglichen. Ein neues Objekt { id: 1 } stimmt nicht mit einem zuvor hinzugefügten Objekt mit denselben Feldern überein; übergeben werden muss eine Referenz auf dasselbe Objekt.

Verwechsle diese Methode nicht mit dem delete-Operator, der Objekteigenschaften entfernt, oder mit set.clear(), das alle Elemente entfernt. Die Methode benötigt einen Empfänger mit internen Set-Daten; der Aufruf Set.prototype.delete.call({}, value) löst einen TypeError aus. Dies ist eine ECMAScript-Sprach-API, keine Browser-API; allein das Vorhandensein von Node.js in einem Projekt bestätigt nicht die Unterstützung in den Zielbrowsern.

Beispiele

const item = { id: 1 };
const values = new Set(["ready", item, NaN]);

console.log(values.delete("ready"));
console.log(values.delete("ready"));
console.log(values.delete({ id: 1 }));
console.log(values.delete(item));
console.log(values.delete(NaN));
console.log(values.size);

Ergebnis

true
false
false
true
true
0

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