Set.prototype.union()
Baseline 2024Newly 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 der gegebenen 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 Elemente enthält, die entweder in dieser Menge oder in der other
Menge oder in beiden enthalten sind.
Beschreibung
In der mathematischen Notation wird Vereinigung definiert als:
Und mit einem Venn-Diagramm:
union()
akzeptiert set-ähnliche Objekte als other
Parameter. Es erfordert, dass this
eine tatsächliche Set
Instanz ist, da es die zugrunde liegenden Daten in this
direkt abruft, ohne Benutzercode aufzurufen. Dann iteriert es über other
, indem es dessen keys()
Methode aufruft, und erstellt 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 zunächst die in this
, gefolgt von denen in other
.
Beispiele
Verwendung von union()
Das folgende Beispiel berechnet die Vereinigung zwischen der Menge von geraden Zahlen (<10) und der Menge von perfekten Quadraten (<10). Das Ergebnis ist die Menge von Zahlen, die entweder gerade oder ein perfektes Quadrat sind, oder beides.
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
BCD tables only load in the browser