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.