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

CKTIS / JavaScript

Set.prototype.isSubsetOf — verificar subconjuntos

Set.prototype.isSubsetOf verifica se todos os elementos de um conjunto estão presentes noutro conjunto ou num objeto semelhante a um conjunto. Devolve um booleano; conjuntos iguais também satisfazem esta condição.

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.isSubsetOf(other)

set.isSubsetOf(other) devolve true quando todos os elementos de set pertencem a other; caso contrário, devolve false. Não verifica se é um subconjunto próprio: um conjunto é subconjunto de si próprio. O conjunto vazio é subconjunto de qualquer conjunto válido. O método não altera os conjuntos.

O recetor set tem de ser um objeto Set real. O argumento other pode ser um Set ou um objeto com uma propriedade size e métodos has e keys invocáveis, como um Map, cujas chaves são verificadas. Ser iterável não é suficiente: um array não é um argumento válido. O método exige que keys seja invocável, embora não a invoque.

Depois de validar o argumento, o método devolve false se o número de elementos guardados internamente em set for superior ao tamanho de other. Nesta comparação, não lê a propriedade set.size. Caso contrário, verifica os elementos através de other.has e termina ao encontrar o primeiro elemento em falta. Em conjuntos comuns, os objetos são comparados pela identidade, não pelo conteúdo. Getters e métodos personalizados do argumento podem causar efeitos secundários ou lançar exceções.

O método faz parte do ECMAScript 2025, não das Web APIs. A especificação não confirma o suporte num navegador específico; a presença do Node 24 num repositório também não o comprova. Verifique typeof Set.prototype.isSubsetOf === "function" no ambiente de destino.

Exemplos

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

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