Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Set.prototype.union — suma zbiorów

Set.prototype.union(other) tworzy nowy Set zawierający wartości z obu zbiorów, bez duplikatów. Zachowuje kolejność lewego zbioru, a następnie dodaje nowe wartości z other. Argument musi obsługiwać protokół obiektu podobnego do zbioru, a nie tylko iterację.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

set.union(other)

Set.prototype.union(other) oblicza sumę zbiorów: zwraca nowy Set zawierający wartości występujące w co najmniej jednym z argumentów. Najpierw zachowuje kolejność wstawiania elementów odbiorcy, potem dopisuje nieobecne wartości w kolejności zwracanej przez other.keys(). Sam algorytm nie modyfikuje wejściowych zbiorów; niestandardowe gettery i metody other mogą jednak wywoływać skutki uboczne.

Odbiorca musi być rzeczywistym obiektem Set z wewnętrznymi danymi zbioru. other może być obiektem podobnym do zbioru: musi udostępniać poprawne size oraz wywoływalne has i keys; keys() musi zwracać iterator. union sprawdza has, ale go nie wywołuje. Map spełnia ten protokół — używane są jego klucze. Sama iterowalność nie wystarcza: zwykła tablica nie jest poprawnym argumentem; użyj new Set(array).

Duplikaty są rozpoznawane zgodnie z semantyką SameValueZero: wartości NaN są traktowane jako równe, podobnie jak +0 i -0; obiekty są porównywane według tożsamości, nie zawartości. Wynik jest płytki: przechowuje te same referencje do obiektów. Jest zwykłym Set, również gdy odbiorca jest instancją podklasy.

Metoda jest częścią ECMAScript 2025, a nie Web API. Specyfikacja języka nie potwierdza obsługi w konkretnej przeglądarce; obecność Node 24 w repozytorium również jej nie dowodzi. Przed użyciem sprawdź typeof Set.prototype.union === "function" w docelowym środowisku i w razie potrzeby zapewnij zgodną implementację zastępczą.

Przykłady

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);

Wynik

[3,1,2]
[3,1]
[1,2]
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła