CKTIS / JavaScript
Set.prototype.intersection — éléments communs aux ensembles
La méthode intersection(other) renvoie un nouveau Set contenant les valeurs présentes dans les deux collections. L’ordre du résultat dépend de la taille des opérandes ; other peut aussi être un objet offrant une interface de type Set.
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.intersection(other)set.intersection(other) calcule une intersection : la méthode renvoie un nouveau Set contenant les valeurs présentes dans les deux collections. Avec des ensembles ordinaires, elle ne modifie aucune des entrées. Cette méthode fait partie d’ECMAScript 2025, et non d’une API de navigateur. La spécification seule ne permet pas d’établir la prise en charge par un navigateur donné ; vérifiez typeof Set.prototype.intersection === "function" avant de l’utiliser. La présence de Node 24 dans un dépôt ne prouve pas la prise en charge par les navigateurs.
Le récepteur set doit être un véritable objet Set. L’argument other peut être un ensemble ou un objet de type ensemble : il doit exposer un size valide ainsi que des méthodes has et keys appelables. Un Map convient également, ses clés étant traitées comme des éléments. Le fait d’être itérable ne suffit pas : un tableau ordinaire n’implémente pas cette interface. Un récepteur invalide provoque un TypeError.
Pour des ensembles ordinaires, la méthode parcourt le plus petit ensemble et en conserve l’ordre d’insertion. Si les tailles sont égales, elle utilise l’ordre de set. Ainsi, a.intersection(b) et b.intersection(a) peuvent contenir les mêmes éléments dans des ordres différents. Pour des ensembles ordinaires, le test d’appartenance suit la sémantique SameValueZero : NaN correspond à NaN, +0 et -0 sont équivalents, et les objets doivent avoir la même identité. Lorsque la taille du récepteur est inférieure ou égale à celle indiquée par other, la méthode teste l’appartenance en appelant other.has. Une méthode has personnalisée n’est pas tenue de respecter la sémantique SameValueZero et peut, par exemple, considérer des objets distincts comme équivalents.
Dans l’exemple, right est plus petit, donc l’ordre du résultat est [3,2], tandis que les tailles des entrées restent inchangées. Les accesseurs personnalisés et les méthodes has et keys de other peuvent exécuter du code, modifier des données ou déclencher des exceptions ; dans ce cas, ne supposez pas que l’opération est sans effets de bord.
Exemples
const left = new Set([1, 2, 3, 4]);
const right = new Set([3, 2]);
const common = left.intersection(right);
console.log(JSON.stringify([...common]));
console.log(left.size, right.size);Résultat
[3,2] 4 2
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.