Set.prototype.isSubsetOf()

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

Синтаксис

isSubsetOf(other)

Параметры

other

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

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

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

Описание

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

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

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

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

Примеры

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

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

const fours = new Set([4, 8, 12, 16]);
const evens = new Set([2, 4, 6, 8, 10, 12, 14, 16, 18]);
console.log(fours.isSubsetOf(evens)); // 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(primes.isSubsetOf(odds)); // false

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

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

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

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

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

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