WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen