Set.prototype.isSupersetOf()

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

Синтаксис

isSupersetOf(other)

Параметры

other

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

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

true, если все элементы в множестве other также содержатся в этом множестве, и false в противном случае.

Описание

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

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

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

• Если в this меньше элементов, чем в other.size, то он сразу возвращает false.
• В противном случае, он выполняет итерацию по other, вызывая его метод keys(), и если какой-либо элемент в other отсутствует в this, он возвращает false (и закрывает итератор keys(), вызывая его метод return()). В противном случае он возвращает true.

Примеры

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

Множество четных чисел (<20) является надмножеством чисел, кратных 4 (<20):

const evens = new Set([2, 4, 6, 8, 10, 12, 14, 16, 18]);
const fours = new Set([4, 8, 12, 16]);
console.log(evens.isSupersetOf(fours)); // true

Множество всех нечетных чисел (<20) не является надмножеством простых чисел (<20), потому что 2 является простым, но не нечетным числом:

const primes = new Set([2, 3, 5, 7, 11, 13, 17, 19]);
const odds = new Set([3, 5, 7, 9, 11, 13, 15, 17, 19]);
console.log(odds.isSupersetOf(primes)); // false

Эквивалентные множества являются надмножествами друг друга:

const set1 = new Set([1, 2, 3]);
const set2 = new Set([1, 2, 3]);
console.log(set1.isSupersetOf(set2)); // true
console.log(set2.isSupersetOf(set1)); // true

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

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

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

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