Set.prototype.union()

Метод union() (об'єднання) примірників Set приймає множину і повертає нову множину, що містить елементи, які належать або до поточної множини, або до переданої, або до них обох.

Синтаксис

union(other)

Параметри

other

Об'єкт Set, або множиноподібний об'єкт.

Повернене значення

Новий об'єкт Set, що містить елементи, які належать або до поточної множини, або до множини other, або до них обох.

Опис

У математичному записі об'єднання визначається так:

$$A\cup B = {x\midx\in A\text{ or }x\in B}$$

А за допомогою діаграми Венна:

Метод union() приймає множиноподібні об'єкти в параметрі other. Він вимагає, щоб this було справжнім примірником Set, оскільки безпосередньо отримує базові дані, збережені в this, без закликання будь-якого користувацького коду. Далі він ітерує по other, викликавши її метод keys(), і створює нову множину з усіма елементами this, після яких йдуть усі елементи other, які не містяться в this.

Порядок елементів у поверненій множині: спочатку ті, що є у this, а потім ті, що є лише в other.

Приклади

Застосування union()

Наступний приклад обчислює об'єднання між множиною парних чисел (<10) та множиною квадратів натуральних чисел (<10). Результатом є множина чисел, які є або парними, або квадратами натуральних чисел, або і першим, і другим.

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 }

Специфікації

Сумісність із браузерами

Дивіться також

• Поліфіл Set.prototype.union у складі core-js
• Set.prototype.difference()
• Set.prototype.intersection()
• Set.prototype.isDisjointFrom()
• Set.prototype.isSubsetOf()
• Set.prototype.isSupersetOf()
• Set.prototype.symmetricDifference()