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 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 der angegebenen Menge oder in beiden vorhanden sind.
Syntax
union(other)
Parameter
other-
Ein
SetObjekt oder ein set-ähnliches Objekt.
Rückgabewert
Ein neues Set Objekt, das Elemente enthält, die entweder in dieser Menge oder in der other Menge oder in beiden vorhanden sind.
Beschreibung
In der mathematischen Notation ist Union definiert als:
Und unter Verwendung eines Venn-Diagramms:
union() akzeptiert set-ä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 benutzerdefinierten Code aufzurufen. Dann iteriert es über other, indem es dessen keys() Methode aufruft und eine neue Menge mit allen Elementen in this sowie allen Elementen in other, die in this nicht vorhanden sind, konstruiert.
Die Reihenfolge der Elemente in der zurückgegebenen Menge ist zuerst die in this, gefolgt von denen in other.
Beispiele
>Verwendung von union()
Im folgenden Beispiel wird die Union zwischen der Menge der geraden Zahlen (<10) und der Menge der perfekten Quadratzahlen (<10) berechnet. Das Ergebnis ist die Menge der 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
| Spezifikation |
|---|
| ECMAScript® 2027 Language Specification> # sec-set.prototype.union> |