CKTIS / JavaScript
Set.prototype.add — einen Wert zu einer Menge hinzufügen
Set.prototype.add(value) fügt einer Menge einen einzelnen Wert hinzu, sofern er noch nicht enthalten ist. Die Methode verändert das vorhandene Set und gibt dasselbe Objekt zurück, sodass sich Aufrufe verketten lassen.
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.add(value)set.add(value) fügt einem vorhandenen Set-Objekt einen Wert hinzu. Ist der Wert bereits enthalten, bleibt die Menge unverändert. Die Methode gibt immer dieselbe Menge zurück, nicht etwa einen booleschen Wert, der angibt, ob etwas eingefügt wurde. Deshalb ist zum Beispiel set.add(a).add(b) möglich. Ein neuer Wert kommt ans Ende der Iterationsreihenfolge; wird ein bereits enthaltener Wert erneut hinzugefügt, ändert sich seine Position nicht.
Die Eindeutigkeit richtet sich nach dem Vergleich SameValueZero: NaN gilt als Duplikat von NaN, und -0 und +0 stehen für dasselbe Element; gespeichert wird null als +0. Objekte werden anhand ihrer Identität und nicht ihres Inhalts verglichen. Zwei getrennt erstellte {}-Objekte sind daher verschiedene Elemente, aber dieselbe Referenz erneut hinzuzufügen erhöht size nicht.
add erweitert Arrays oder andere Iterables nicht: set.add([1, 2]) fügt ein einzelnes Array hinzu. Ein Aufruf ohne Argument fügt undefined hinzu. Die Methode benötigt einen Empfänger mit internen Set-Daten; Set.prototype.add.call({}, 1) löst einen TypeError aus.
Beispiele
const values = new Set();
const returned = values.add("blue").add("green").add("blue");
console.log(returned === values);
console.log(values.size);
console.log([...values].join(","));
values.add(NaN).add(NaN).add(-0).add(+0);
console.log(values.size);Ergebnis
true 2 blue,green 4
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.