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

CKTIS / JavaScript

Set.prototype.isSubsetOf — tester l’inclusion d’un ensemble

Set.prototype.isSubsetOf vérifie si chaque élément d’un ensemble figure dans un autre ensemble ou dans un objet assimilé à un ensemble. La méthode renvoie un booléen ; deux ensembles égaux satisfont aussi cette condition.

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

set.isSubsetOf(other) renvoie true lorsque chaque élément de set appartient à other ; sinon, elle renvoie false. Il ne s’agit pas d’un test d’inclusion stricte : un ensemble est inclus dans lui-même. L’ensemble vide est inclus dans tout ensemble valide. La méthode ne modifie pas les ensembles.

Le récepteur set doit être un véritable objet Set. L’argument other peut être un Set ou un objet doté d’une propriété size et de méthodes has et keys appelables, comme une Map, dont les clés sont testées. Le fait d’être itérable ne suffit pas : un tableau n’est pas un argument valide. La méthode exige que keys soit appelable, même si elle ne l’appelle pas.

Après avoir validé l’argument, la méthode renvoie false si le nombre d’éléments stockés en interne dans set dépasse la taille de other. Cette comparaison ne lit pas la propriété set.size. Dans le cas contraire, la méthode vérifie les éléments avec other.has et s’arrête au premier élément absent. Pour les ensembles ordinaires, les objets sont comparés par identité, et non par contenu. Des accesseurs et méthodes personnalisés de l’argument peuvent avoir des effets de bord ou lever des exceptions.

Cette méthode fait partie d’ECMAScript 2025, et non des Web APIs. La spécification ne confirme pas sa prise en charge par un navigateur particulier ; la présence de Node 24 dans un dépôt ne la prouve pas non plus. Vérifiez typeof Set.prototype.isSubsetOf === "function" dans l’environnement cible.

Exemples

const required = new Set(["read"]);
const granted = new Set(["read", "write"]);

console.log(required.isSubsetOf(granted));
console.log(granted.isSubsetOf(required));
console.log(required.isSubsetOf(required));
console.log(new Set().isSubsetOf(granted));

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