Set.prototype.union()

Baseline 2024
Newly available

Since June 2024, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Die Methode union() von Set-Instanzen nimmt ein Set und gibt ein neues Set zurück, das Elemente enthält, die entweder in diesem Set, im angegebenen Set oder in beiden enthalten sind.

Syntax

js
union(other)

Parameter

other

Ein Set-Objekt oder set-ähnliches Objekt.

Rückgabewert

Ein neues Set-Objekt, das Elemente enthält, die entweder in diesem Set, im other Set oder in beiden enthalten sind.

Beschreibung

In mathematischer Notation wird Vereinigung definiert als:

AB={xxA oder xB}A\cup B = \{x\mid x\in A\text{ oder }x\in B\}

Und mit einem Venn-Diagramm dargestellt:

Ein Venn-Diagramm, bei dem sich zwei Kreise überlappen. Die symmetrische Differenz von A und B ist der Bereich, der entweder in einem oder beiden Kreisen enthalten ist.

union() akzeptiert set-ähnliche Objekte als other-Parameter. Es erfordert, dass this eine tatsächliche Set-Instanz ist, da direkt auf die zugrunde liegenden Daten in this zugegriffen wird, ohne benutzerdefinierten Code aufzurufen. Anschließend iteriert es über other, indem es dessen keys()-Methode aufruft, und erstellt ein neues Set mit allen Elementen in this, gefolgt von allen Elementen in other, die nicht in this vorhanden sind.

Die Reihenfolge der Elemente im zurückgegebenen Set 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 der Zahlen, die entweder gerade oder ein perfektes Quadrat oder beides sind.

js
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

Specification
Set methods
# sec-set.prototype.union

Browser-Kompatibilität

Siehe auch