Set.prototype.difference()

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

Синтаксис

difference(other)

Параметры

other

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

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

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

Описание

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

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

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

• Если в this больше элементов, чем в other.size, то он перебирает other, вызывая его метод keys(), и создает новое множество со всеми элементами из this, которые не были обнаружены в other.
• В противном случае он перебирает элементы в this и создает новое множество со всеми элементами e из this, которые приводят к тому, что other.has(e) возвращает ложное значение.

Порядок элементов в возвращаемом множестве такой же, как и в this.

Примеры

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

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

const odds = new Set([1, 3, 5, 7, 9]);
const squares = new Set([1, 4, 9]);
console.log(odds.difference(squares)); // Set(3) { 3, 5, 7 }

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

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

См. также

• Polyfill для Set.prototype.difference в core-js
• Polyfill es-shims для Set.prototype.difference
• Set.prototype.intersection()
• Set.prototype.isDisjointFrom()
• Set.prototype.isSubsetOf()
• Set.prototype.isSupersetOf()
• Set.prototype.symmetricDifference()
• Set.prototype.union()