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

CKTIS / JavaScript

Set.prototype.isSupersetOf — tester si un ensemble est un sur-ensemble

La méthode isSupersetOf() vérifie si un Set contient chaque élément d’une autre collection de type ensemble. Elle renvoie un booléen ; des ensembles égaux satisfont également la condition. Il ne s’agit donc pas d’un test de sur-ensemble strict.

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.isSupersetOf(other)

set.isSupersetOf(other) renvoie true lorsque set contient chaque élément de other, et false dans le cas contraire. Des ensembles égaux conviennent aussi, et tout ensemble est un sur-ensemble d’un Set vide. La méthode ne modifie pas elle-même les ensembles.

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 un objet de type ensemble : il expose une propriété size et des méthodes appelables has() et keys(). La méthode convertit size en nombre, rejette NaN, tronque les valeurs finies vers zéro, puis rejette tout résultat négatif. Par exemple, la chaîne "1" est acceptée comme une taille de 1. Set et Map conviennent tous deux — pour une Map, ce sont les clés qui sont prises en compte. Un tableau ordinaire ne respecte pas ce contrat ; utilisez new Set(array).

Après avoir validé l’argument, la méthode renvoie false si la taille du récepteur est inférieure à celle de other. Sinon, elle parcourt other.keys() et s’arrête au premier élément absent. other.has() doit exister, mais cet algorithme ne l’appelle pas. L’appartenance suit la sémantique SameValueZero : NaN correspond à NaN, +0 et -0 sont équivalents, et les objets sont comparés par identité. Des accesseurs et itérateurs personnalisés peuvent exécuter du code ayant des effets de bord.

Cette méthode fait partie d’ECMAScript 2025. La spécification du langage ne garantit pas sa prise en charge dans un navigateur donné ; vérifiez typeof Set.prototype.isSupersetOf === 'function' dans l’environnement cible avant de l’utiliser. La version de Node utilisée dans un dépôt ne prouve pas la prise en charge par les navigateurs.

Exemples

const available = new Set(['read', 'write', 'share']);
const required = new Set(['read', 'write']);

console.log(available.isSupersetOf(required));
console.log(required.isSupersetOf(available));
console.log(available.isSupersetOf(available));
console.log(available.isSupersetOf(new Set()));

Résultat

true
false
true
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