Set.prototype.symmetricDifference()

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

Синтаксис

symmetricDifference(other)

Параметры

other

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

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

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

Описание

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

И с помощью диаграммы Венна:

symmetricDifference() принимает множествоподобные объекты в качестве параметра other. Он требует, чтобы this был фактическим экземпляром Set, поскольку он напрямую извлекает базовые данные, хранящиеся в this, без вызова пользовательского кода. Затем он выполняет итерацию по other, вызывая его метод keys(), и создает новое множество со всеми элементами в this, которые не найдены в other, и всеми элементами в other, которые не найдены в this.

Порядок элементов в возвращаемом множестве — сначала те, что находятся в this, а затем те, что находятся в other.

Примеры

Использование symmetricDifference()

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

const evens = new Set([2, 4, 6, 8]);
const squares = new Set([1, 4, 9]);
console.log(evens.symmetricDifference(squares)); // Set(5) { 2, 6, 8, 1, 9 }

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

Совместимость с браузерами

Смотрите также

• Полифил Set.prototype.symmetricDifference в core-js
• Полифил es-shims Set.prototype.symmetricDifference
• Set.prototype.difference()
• Set.prototype.intersection()
• Set.prototype.isDisjointFrom()
• Set.prototype.isSubsetOf()
• Set.prototype.isSupersetOf()
• Set.prototype.union()