Set.prototype.union()
Baseline 2024
Neu verfügbar
Seit Juni 2024 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
Die Methode union() von Set-Instanzen nimmt eine Menge entgegen und gibt eine neue Menge zurück, die alle Elemente enthält, die in dieser Menge, in der übergebenen Menge oder in beiden enthalten sind.
Syntax
union(other)
Parameter
other-
Ein
Set-Objekt oder ein Set-ähnliches Objekt.
Rückgabewert
Ein neues Set-Objekt, das alle Elemente enthält, die in dieser Menge, in der Menge other oder in beiden enthalten sind.
Beschreibung
In der mathematischen Notation ist die Vereinigung wie folgt definiert:
Als Venn-Diagramm dargestellt:
union() akzeptiert Set-ähnliche Objekte als Parameter other. this muss eine tatsächliche Set-Instanz sein, da die Methode direkt auf die in this gespeicherten Daten zugreift, ohne benutzerdefinierten Code aufzurufen. Anschließend durchläuft sie other, indem sie dessen Methode keys() aufruft, und erstellt eine neue Menge mit allen Elementen aus this, gefolgt von allen Elementen aus other, die nicht in this enthalten sind.
Die Reihenfolge der Elemente in der zurückgegebenen Menge entspricht zunächst der Reihenfolge in this, gefolgt von den Elementen aus other.
Beispiele
union() verwenden
Das folgende Beispiel berechnet die Vereinigung der Menge gerader Zahlen (<10) und der Menge der Quadratzahlen (<10). Das Ergebnis ist die Menge der Zahlen, die gerade, eine Quadratzahl 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
| Spezifikation |
|---|
| ECMAScript® 2027 Language Specification # sec-set.prototype.union |