CKTIS / JavaScript
Set.prototype.union — Vereinigungsmenge von Sets
Set.prototype.union(other) erstellt ein neues Set mit den Werten aus beiden Sets, ohne Duplikate. Die Reihenfolge des linken Sets bleibt erhalten; anschließend werden neue Werte aus other angefügt. Das Argument muss das Protokoll set-ähnlicher Objekte unterstützen, nicht nur iterierbar sein.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
set.union(other)Set.prototype.union(other) bildet die Vereinigung: Die Methode gibt ein neues Set mit den Werten zurück, die in mindestens einem der Eingaben vorkommen. Zuerst bleibt die Einfügereihenfolge des Empfängers erhalten; danach werden fehlende Werte in der Reihenfolge angefügt, die other.keys() zurückgibt. Der Algorithmus selbst verändert die Eingabe-Sets nicht; benutzerdefinierte Getter und Methoden von other können jedoch Nebenwirkungen haben.
Der Empfänger muss ein echtes Set-Objekt mit internen Set-Daten sein. other darf ein set-ähnliches Objekt sein: Es muss ein gültiges size sowie aufrufbare Methoden has und keys bereitstellen; keys() muss einen Iterator zurückgeben. union prüft has, ruft es aber nicht auf. Eine Map erfüllt dieses Protokoll — verwendet werden ihre Schlüssel. Iterierbarkeit allein genügt nicht: Ein gewöhnliches Array ist kein gültiges Argument; verwende new Set(array).
Duplikate werden nach der Semantik von SameValueZero erkannt: NaN-Werte gelten als gleich, ebenso +0 und -0; Objekte werden anhand ihrer Identität und nicht ihres Inhalts verglichen. Das Ergebnis ist flach: Es enthält dieselben Objektverweise. Es ist ein gewöhnliches Set, auch wenn der Empfänger eine Instanz einer Unterklasse ist.
Die Methode gehört zu ECMAScript 2025 und ist keine Web API. Aus der Sprachspezifikation lässt sich nicht ableiten, ob sie in einem bestimmten Browser unterstützt wird; auch das Vorhandensein von Node 24 in einem Repository belegt keine Browserunterstützung. Prüfe vor der Verwendung typeof Set.prototype.union === "function" in der Zielumgebung und stelle bei Bedarf eine konforme Ersatzimplementierung bereit.
Beispiele
const left = new Set([3, 1]);
const right = new Set([1, 2]);
const result = left.union(right);
console.log(JSON.stringify([...result]));
console.log(JSON.stringify([...left]));
console.log(JSON.stringify([...right]));
console.log(result !== left && result !== right);Ergebnis
[3,1,2] [3,1] [1,2] true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.