Set.prototype.union()

Метод union() экземпляров Set принимает множество и возвращает новое множество, содержащее элементы, которые присутствуют либо в этом множестве, либо в заданном множестве, либо в обоих.

Синтаксис

union(other)

Параметры

other

Объект Set, или множество-подобный объект.

Возвращаемое значение

Новый объект Set, содержащий элементы, которые присутствуют либо в этом множестве, либо в множестве other, либо в обоих.

Описание

В математической нотации объединение определяется как:

Используя диаграмму Венна:

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
• Полифилл es-shims Set.prototype.union
• Set.prototype.difference()
• Set.prototype.intersection()
• Set.prototype.isDisjointFrom()
• Set.prototype.isSubsetOf()
• Set.prototype.isSupersetOf()
• Set.prototype.symmetricDifference()