CKTIS / JavaScript
Set.prototype.symmetricDifference — différence symétrique d’ensembles
Si les éléments d’entrée restent inchangés pendant l’appel, symmetricDifference() renvoie un nouveau Set contenant les valeurs présentes dans un seul des deux ensembles. La méthode elle-même ne modifie pas les ensembles d’entrée.
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.symmetricDifference(other)Si les éléments d’entrée restent inchangés pendant l’appel, a.symmetricDifference(b) renvoie un nouveau Set contenant les valeurs appartenant à a ou à b, mais pas aux deux. Pour un argument de type ensemble, les valeurs fournies par keys() constituent ses éléments. Contrairement à une différence dans un seul sens, la différence symétrique inclut les éléments propres à chacun des deux côtés. La méthode elle-même ne modifie pas les ensembles d’entrée.
Le récepteur this doit être un véritable objet Set. L’argument other peut être un objet de type ensemble : il doit exposer une propriété size ainsi que des méthodes has et keys appelables. La conversion de size en nombre ne doit pas donner NaN, et le résultat ne doit pas être négatif après troncature vers zéro. Une valeur size de -0.5 est donc acceptée si le reste de l’interface est valide. L’algorithme vérifie cette interface, mais récupère les valeurs avec keys(), et non avec has(). Une Map convient, ses clés faisant office d’éléments ici ; un tableau ordinaire ne satisfait pas cette interface. Les accesseurs et méthodes personnalisés de l’argument peuvent avoir des effets de bord.
L’algorithme copie les données du récepteur avant de faire avancer l’itérateur de l’argument pour la première fois. Pour chaque clé produite, il vérifie toutefois sa présence dans le récepteur dans son état courant, et non dans la copie. Si l’itérateur modifie le contenu du récepteur, le résultat ne correspond pas nécessairement à la différence symétrique entre les clés produites et le contenu initial ou final du récepteur.
Si les entrées restent stables, le résultat conserve d’abord l’ordre des valeurs propres au récepteur, puis celui des valeurs propres à other, selon l’ordre fourni par keys(). L’égalité suit SameValueZero : NaN correspond à NaN, +0 et -0 sont équivalents, et les objets sont comparés par identité plutôt que par contenu.
Cette méthode fait partie d’ECMAScript 2025 et n’est pas une Web API distincte. La spécification citée ne fournit pas de tableau de compatibilité des navigateurs ; avant le déploiement, vérifiez typeof Set.prototype.symmetricDifference === "function" dans l’environnement cible. La présence de Node 24 dans le dépôt ne prouve pas la prise en charge par les navigateurs.
Exemples
const a = new Set([1, 2, 3]);
const b = new Set([3, 4, 2, 5]);
const result = a.symmetricDifference(b);
console.log(JSON.stringify([...result]));
console.log(JSON.stringify([...a]));
console.log(JSON.stringify([...b]));Résultat
[1,4,5] [1,2,3] [3,4,2,5]
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.