Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Set.prototype.isDisjointFrom — vérifier si des ensembles sont disjoints

Set.prototype.isDisjointFrom vérifie si un ensemble n’a aucun élément en commun avec un autre ensemble ou un objet compatible avec le protocole des ensembles. La méthode renvoie un booléen au lieu de créer un nouvel ensemble.

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

Syntaxe

set.isDisjointFrom(other)

set.isDisjointFrom(other) renvoie true lorsque les ensembles n’ont aucun élément en commun, et false dès qu’elle en trouve un. Pour des objets Set ordinaires, un ensemble vide est disjoint de tout ensemble, y compris d’un ensemble vide. La méthode ne crée pas d’ensemble résultat et ne modifie pas elle-même ses opérandes.

Le récepteur set doit être un véritable objet Set ; fournir simplement des méthodes similaires ne suffit pas. L’argument other peut être compatible avec le protocole des ensembles : il doit exposer un size valide ainsi que des méthodes has et keys appelables. Un Set ou une Map convient ; pour une Map, ce sont les clés qui sont vérifiées. Le fait d’être itérable ne suffit pas : un tableau ordinaire n’est pas un argument valide ; utilisez plutôt new Set(array).

Pour les ensembles ordinaires, la comparaison suit la règle SameValueZero : NaN correspond à NaN et +0 à -0 ; les objets sont comparés par identité, et non par contenu. La méthode compare le nombre d’éléments comptabilisé en interne par set à la taille obtenue à partir de other.size ; elle ne lit pas la propriété publique set.size. Si ce nombre est inférieur ou égal à la taille de other, la méthode parcourt set et appelle other.has ; sinon, elle obtient les éléments par other.keys. Elle s’arrête dès qu’elle trouve un élément commun. Les accesseurs ou méthodes personnalisés de other peuvent avoir des effets de bord ou lever des exceptions ; évitez donc de modifier les ensembles pendant la vérification.

Cette méthode appartient à ECMAScript 2025, et non aux Web APIs. La spécification du langage ne confirme pas sa prise en charge dans une version particulière d’un navigateur. Avant de l’utiliser dans l’environnement cible, vérifiez typeof Set.prototype.isDisjointFrom === "function" ; la présence de Node 24 dans un dépôt ne prouve pas la prise en charge par les navigateurs.

Exemples

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

Résultat

true
false
true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources