CKTIS / JavaScript
Set.prototype.union — union d’ensembles
Set.prototype.union(other) crée un nouveau Set contenant les valeurs des deux ensembles, sans doublons. Il conserve l’ordre de l’ensemble de gauche, puis ajoute les nouvelles valeurs de other. L’argument doit respecter le protocole des objets assimilés à des ensembles, et pas seulement être itérable.
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.union(other)Set.prototype.union(other) calcule une union : la méthode renvoie un nouveau Set contenant les valeurs présentes dans au moins une des entrées. Elle conserve d’abord l’ordre d’insertion du récepteur, puis ajoute les valeurs manquantes dans l’ordre renvoyé par other.keys(). L’algorithme ne modifie pas les ensembles d’entrée ; toutefois, les accesseurs et méthodes personnalisés de other peuvent avoir des effets secondaires.
Le récepteur doit être un véritable objet Set doté de données internes d’ensemble. other peut être un objet assimilé à un ensemble : il doit fournir un size valide ainsi que des méthodes has et keys appelables ; keys() doit renvoyer un itérateur. union vérifie has sans l’appeler. Une Map respecte ce protocole : ses clés sont utilisées. Le fait d’être itérable ne suffit pas : un tableau ordinaire n’est pas un argument valide ; utilisez new Set(array).
Les doublons sont déterminés selon la sémantique SameValueZero : les valeurs NaN sont considérées comme égales, tout comme +0 et -0 ; les objets sont comparés par identité, et non par contenu. Le résultat est superficiel : il conserve les mêmes références d’objets. C’est un Set ordinaire, même si le récepteur est une instance d’une sous-classe.
Cette méthode fait partie d’ECMAScript 2025, et non d’une API Web. La spécification du langage ne permet pas d’établir si elle est prise en charge dans un navigateur donné ; la présence de Node 24 dans un dépôt ne prouve pas non plus la prise en charge par les navigateurs. Avant de l’utiliser, vérifiez typeof Set.prototype.union === "function" dans l’environnement cible et fournissez, si nécessaire, une solution de remplacement conforme.
Exemples
const left = new Set([3, 1]);
const right = new Set([1, 2]);
const result = left.union(right);
console.log(JSON.stringify([...result]));
console.log(JSON.stringify([...left]));
console.log(JSON.stringify([...right]));
console.log(result !== left && result !== right);Résultat
[3,1,2] [3,1] [1,2] 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.