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

CKTIS / JavaScript

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

Методът isSupersetOf() проверява дали даден Set съдържа всеки елемент на друга колекция, подобна на множество. Връща булева стойност; условието е изпълнено и при равни множества, така че това не е проверка за строго надмножество.

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

Синтаксис

set.isSupersetOf(other)

set.isSupersetOf(other) връща true, когато set съдържа всеки елемент на other, а в противен случай връща false. Равните множества също изпълняват условието, а всяко множество е надмножество на празен Set. Самият метод не променя множествата.

Получателят set трябва да е истински обект Set; предоставянето само на подобни методи не е достатъчно. Аргументът other може да бъде обект, подобен на множество: той предоставя свойство size и извикваеми методи has() и keys(). Методът преобразува size в число, отхвърля NaN, отрязва дробната част на крайните стойности в посока към нулата и след това отхвърля отрицателен резултат. Например низът "1" се приема като размер 1. И Set, и Map отговарят на тези изисквания — при Map се използват ключовете ѝ. Обикновен масив не изпълнява този договор; използвайте new Set(array).

След проверка на аргумента методът връща false, ако размерът на получателя е по-малък от размера на other. В противен случай обхожда other.keys() и спира при първия липсващ елемент. other.has() трябва да съществува, но алгоритъмът не я извиква. Принадлежността следва семантиката SameValueZero: NaN съвпада с NaN, +0 и -0 са еквивалентни, а обектите се сравняват по идентичност. Персонализирани гетъри и итератори могат да изпълняват код със странични ефекти.

Методът е част от ECMAScript 2025. Езиковата спецификация не гарантира поддръжка в конкретен браузър; преди употреба проверете typeof Set.prototype.isSupersetOf === 'function' в целевата среда. Версията на Node, използвана в хранилище, не доказва поддръжка в браузърите.

Примери

const available = new Set(['read', 'write', 'share']);
const required = new Set(['read', 'write']);

console.log(available.isSupersetOf(required));
console.log(required.isSupersetOf(available));
console.log(available.isSupersetOf(available));
console.log(available.isSupersetOf(new Set()));

Резултат

true
false
true
true

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

Източници