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

CKTIS / JavaScript

Set.prototype.isDisjointFrom — verificar se os conjuntos são disjuntos

Set.prototype.isDisjointFrom verifica se um conjunto não tem elementos em comum com outro conjunto ou com um objeto compatível com o protocolo de conjuntos. Devolve um valor booleano, em vez de criar um novo conjunto.

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

set.isDisjointFrom(other) devolve true quando os conjuntos não têm elementos em comum e false quando encontra algum. Para objetos Set comuns, um conjunto vazio é disjunto de qualquer conjunto, incluindo outro conjunto vazio. O método não cria um conjunto de resultado nem modifica os seus operandos por si próprio.

O recetor set tem de ser um objeto Set genuíno; disponibilizar apenas métodos semelhantes não é suficiente. O argumento other pode ser compatível com o protocolo de conjuntos: tem de expor um size válido e os métodos invocáveis has e keys. Um Set ou um Map é adequado; no caso de um Map, são verificadas as chaves. Ser iterável, por si só, não chega: um array normal não é um argumento válido; use new Set(array).

Para conjuntos comuns, a comparação segue a regra SameValueZero: NaN corresponde a NaN e +0 corresponde a -0; os objetos são comparados pela identidade, não pelo conteúdo. O método compara a contagem interna de elementos de set com o tamanho obtido a partir de other.size; não lê a propriedade pública set.size. Se essa contagem for menor ou igual ao tamanho de other, o método percorre set e chama other.has; caso contrário, obtém os elementos através de other.keys. Para quando encontra um elemento em comum. Getters ou métodos personalizados de other podem ter efeitos secundários ou lançar exceções, por isso evite modificar os conjuntos durante a verificação.

O método faz parte de ECMAScript 2025, não das Web APIs. A especificação da linguagem não confirma o suporte numa versão específica de um navegador. Antes de o utilizar no ambiente de destino, verifique typeof Set.prototype.isDisjointFrom === "function"; a presença de Node 24 num repositório não prova o suporte nos navegadores.

Exemplos

const selected = new Set([2, 4]);
const available = new Set([1, 3]);
const reserved = new Set([4, 6]);

console.log(selected.isDisjointFrom(available));
console.log(selected.isDisjointFrom(reserved));
console.log(selected.isDisjointFrom(new Set()));

Resultado

true
false
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