Set.prototype.union()

Syntax

union(other)

Parameter

other

Ein Set Objekt oder ein mengenähnliches Objekt.

Rückgabewert

Ein neues Set Objekt, das Elemente enthält, die entweder in dieser Menge oder in beiden, dieser und der other Menge, vorhanden sind.

Beschreibung

In mathematischer Notation ist die Vereinigung definiert als:

Und unter Verwendung eines Venn-Diagramms:

union() akzeptiert mengenähnliche Objekte als other Parameter. Es erfordert, dass this eine tatsächliche Set Instanz ist, da es direkt die zugrunde liegenden Daten in this abruft, ohne Benutzercode aufzurufen. Anschließend wird über other iteriert, indem die Methode keys() aufgerufen wird, und eine neue Menge mit allen Elementen in this sowie allen Elementen in other, die nicht in this vorhanden sind, erstellt.

Die Reihenfolge der Elemente in der zurückgegebenen Menge ist zuerst die in this, gefolgt von denen in other.

Beispiele

Verwendung von union()

Das folgende Beispiel berechnet die Vereinigung zwischen der Menge der geraden Zahlen (<10) und der Menge der perfekten Quadrate (<10). Das Ergebnis ist die Menge von Zahlen, die entweder gerade oder ein perfektes Quadrat oder beides sind.

const evens = new Set([2, 4, 6, 8]);
const squares = new Set([1, 4, 9]);
console.log(evens.union(squares)); // Set(6) { 2, 4, 6, 8, 1, 9 }

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Polyfill von Set.prototype.union in core-js
• es-shims Polyfill von Set.prototype.union
• Set.prototype.difference()
• Set.prototype.intersection()
• Set.prototype.isDisjointFrom()
• Set.prototype.isSubsetOf()
• Set.prototype.isSupersetOf()
• Set.prototype.symmetricDifference()