Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Set.prototype.isSupersetOf — testar se é um superconjunto

O método isSupersetOf() verifica se um Set contém todos os elementos de outra coleção semelhante a um conjunto. Devolve um booleano; conjuntos iguais também satisfazem a condição, pelo que não se trata de um teste de superconjunto próprio.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

set.isSupersetOf(other)

set.isSupersetOf(other) devolve true quando set contém todos os elementos de other e false caso contrário. Os conjuntos iguais também satisfazem a condição, e qualquer conjunto é um superconjunto de um Set vazio. O método não altera os conjuntos por si só.

O recetor set tem de ser um objeto Set real; disponibilizar métodos semelhantes não é suficiente. O argumento other pode ser um objeto semelhante a um conjunto: expõe uma propriedade size e métodos invocáveis has() e keys(). O método converte size num número, rejeita NaN, trunca os valores finitos em direção a zero e, em seguida, rejeita qualquer resultado negativo. Por exemplo, a cadeia de caracteres "1" é aceite como um tamanho de 1. Tanto Set como Map satisfazem estes requisitos — no caso de uma Map, são usadas as chaves. Um array normal não cumpre este contrato; utiliza new Set(array).

Depois de validar o argumento, o método devolve false se o tamanho do recetor for inferior ao de other. Caso contrário, percorre other.keys() e para no primeiro elemento em falta. other.has() tem de existir, mas não é chamado por este algoritmo. A pertença segue a semântica SameValueZero: NaN corresponde a NaN, +0 e -0 são equivalentes e os objetos são comparados por identidade. Getters e iteradores personalizados podem executar código com efeitos secundários.

O método faz parte de ECMAScript 2025. A especificação da linguagem não garante o suporte num navegador específico; antes de o utilizar, verifica typeof Set.prototype.isSupersetOf === 'function' no ambiente de destino. A versão de Node utilizada num repositório não comprova o suporte nos navegadores.

Exemplos

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()));

Resultado

true
false
true
true

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes