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

CKTIS / JavaScript

Set.prototype.difference — différence d’ensembles

La méthode difference() renvoie un nouveau Set contenant les éléments de l’ensemble appelant qui sont absents de l’autre ensemble. Elle en conserve l’ordre et ne modifie pas elle-même 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.difference(other)

Set.prototype.difference calcule la différence d’ensembles : a.difference(b) contient les éléments de a qui sont absents de b. L’ordre des opérandes compte : il ne s’agit pas d’une différence symétrique. Le résultat est un nouveau Set qui conserve l’ordre d’insertion des éléments restants de a ; l’opération ne modifie pas elle-même les ensembles d’entrée.

Le récepteur this doit être un véritable objet Set. L’argument other peut être un ensemble ou un objet de type ensemble : il doit exposer une valeur size valide ainsi que des méthodes has() et keys() appelables. Map respecte ce protocole, et ses clés sont comparées. Le fait d’être itérable ne suffit pas : il faut d’abord passer un tableau à new Set(...).

Pour les ensembles ordinaires, l’égalité suit SameValueZero : NaN correspond à NaN, +0 et -0 sont équivalents, et les objets sont comparés par identité, non par contenu. Selon les tailles, l’algorithme utilise other.has() ou parcourt other.keys(). Des méthodes et accesseurs personnalisés peuvent donc produire des effets de bord ; ne supposez pas que leur ordre d’appel est indépendant de la taille.

Cette méthode fait partie d’ECMAScript 2025, et non des Web APIs. Lors du déploiement, vérifiez typeof Set.prototype.difference === "function" dans l’environnement cible. La spécification n’est pas un tableau de compatibilité des navigateurs, et la présence de Node 24 dans un dépôt ne prouve pas la prise en charge par les navigateurs.

Exemples

const available = new Set([3, 1, 2]);
const reserved = new Set([1, 4]);
const remaining = available.difference(reserved);

console.log(JSON.stringify([...remaining]));
console.log(JSON.stringify([...available]));
console.log(JSON.stringify([...reserved]));

Résultat

[3,2]
[3,1,2]
[1,4]

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