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.