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 ein Set an und gibt ein neues Set zurück, das Elemente enthält, die entweder in diesem Set, im gegebenen Set oder in beiden enthalten 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 diesem Set, im other Set oder in beiden enthalten sind.
Beschreibung
In der mathematischen Notation ist Vereinigung definiert als:
Und unter Verwendung des 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 aus this abruft, ohne benutzerdefinierten Code aufzurufen. Dann wird über other iteriert, indem dessen keys() Methode aufgerufen wird, und ein neues Set wird mit allen Elementen in this konstruiert, gefolgt von allen Elementen in other, die nicht in this enthalten sind.
Die Reihenfolge der Elemente im zurückgegebenen Set ist zuerst die in this, gefolgt von den in other.
Beispiele
>Verwendung von union()
Das folgende Beispiel berechnet die Vereinigung zwischen dem Set der geraden Zahlen (<10) und dem Set der perfekten Quadrate (<10). Das Ergebnis ist das Set von Zahlen, die entweder gerade, 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
| Specification |
|---|
| ECMAScript® 2026 Language Specification> # sec-set.prototype.union> |
Browser-Kompatibilität
Loading…