База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Set.prototype.isSubsetOf — проверка за подмножество

Set.prototype.isSubsetOf проверява дали всеки елемент на дадено множество се среща в друго множество или обект, подобен на множество. Връща boolean; и равните множества изпълняват това условие.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

set.isSubsetOf(other)

set.isSubsetOf(other) връща true, когато всеки елемент на set принадлежи на other; в противен случай връща false. Това не е проверка за собствено подмножество: едно множество е подмножество на самото себе си. Празното множество е подмножество на всяко валидно множество. Методът не променя множествата.

Получателят set трябва да е действителен обект Set. Аргументът other може да бъде Set или обект със свойство size и извикваеми методи has и keys, например Map, чиито ключове се проверяват. Самата възможност за итериране не е достатъчна: масивът не е валиден аргумент. Методът изисква извикваем keys, въпреки че не го извиква.

След като провери аргумента, методът връща false, ако броят на елементите, съхранени вътрешно в set, надвишава размера на other. При това сравнение методът не прочита свойството set.size. В противен случай проверява елементите чрез other.has и спира при първия липсващ елемент. При обикновените множества обектите се сравняват по идентичност, а не по съдържание. Персонализирани getter-и и методи на аргумента могат да имат странични ефекти или да хвърлят изключения.

Методът е част от ECMAScript 2025, а не от Web APIs. Спецификацията не потвърждава поддръжка в конкретен браузър; наличието на Node 24 в хранилище също не я доказва. Проверете typeof Set.prototype.isSubsetOf === "function" в целевата среда.

Примери

const required = new Set(["read"]);
const granted = new Set(["read", "write"]);

console.log(required.isSubsetOf(granted));
console.log(granted.isSubsetOf(required));
console.log(required.isSubsetOf(required));
console.log(new Set().isSubsetOf(granted));

Резултат

true
false
true
true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници