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 union() Methode von Set Instanzen nimmt eine Menge und gibt eine neue Menge zurück, die Elemente enthält, die entweder in dieser Menge oder in beiden Mengen vorhanden sind.

Syntax

js
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 Vereinigung definiert als:

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

Und unter Verwendung eines Venn-Diagramms:

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

union() akzeptiert mengenähnliche Objekte als other Parameter. Es erfordert, dass this eine tatsächliche Set Instanz ist, da es die zugrunde liegenden Daten direkt von this abruft, ohne benutzerdefinierten Code aufzurufen. Dann durchläuft es other, indem es dessen keys() Methode aufruft, und konstruiert eine neue Menge mit allen Elementen in this, gefolgt von allen Elementen in other, die in this nicht vorhanden sind.

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

Beispiele

Verwenden 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 sind oder beides.

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